Get Asset for an Address Using Runes API

Accessing blockchain-based digital assets has become increasingly seamless thanks to advanced Web3 APIs. One powerful tool in this space is the Runes API, part of the broader WaaS (Wallet-as-a-Service) Web3 API suite, which enables developers and platforms to retrieve detailed information about rune assets associated with specific wallet addresses. This guide dives into how you can use the Get Owned Assets endpoint effectively, understand its parameters, interpret responses, and integrate it into your decentralized applications.

Whether you're building a marketplace, analytics dashboard, or asset tracker, understanding how to pull accurate rune ownership data is essential. Let’s explore the technical structure and practical applications of this API.

🔧 API Endpoint Overview

The Get Owned Assets API allows you to fetch all rune assets held by one or more wallet addresses on supported blockchains. It's particularly useful for platforms that need real-time visibility into user-held digital collectibles or fungible tokens based on the Runes protocol.

Request URL

GET https://web3.okx.com/api/v5/mktplace/nft/runes/get-owned-assets

This endpoint supports batch queries, meaning you can request data for up to 20 wallet addresses at once—ideal for performance optimization in user-facing apps.

📥 Request Parameters

To make a successful call, include the following parameters:

✅ Tip: Use limit=100 and manage pagination via cursor to efficiently handle large datasets without overwhelming your server.

👉 Discover how to automate asset tracking across multiple wallets effortlessly.

📤 Response Parameters

The API returns a comprehensive JSON response detailing each asset. Here’s what each field means:

• assetId: Internal database ID (no external significance)
• tickerType: Token standard (4 = Runes)
• ticker: Human-readable token name (e.g., "SPACEDOGS")
• tickerId: Unique rune identifier
• ownerAddress: Owner's wallet address
• amount: Quantity of XRC20 tokens in UTXO
• chain: Blockchain network identifier
• inscriptionNum: Inscription sequence number
• utxoTxHash, utxoVout, utxoValue: UTXO-specific transaction details
• txHash: Transaction hash where asset was transferred or minted
• name, tickerIcon: Display name and icon URL for frontend rendering
• status: Listing state — 0 (unlisted), 1 (listed), 2 (pending)
• listTime, orderId: Marketplace listing metadata
• confirmations: Blockchain confirmation depth
• Pricing fields (satPrice, price, usdPrice) appear twice—once for total price and once for unit price, across BTC, USD, and satoshis
• unavailable: Flag indicating conflicts—1 (multiple Atomicals), 2 (multiple protocol assets)
• symbol: Token ticker symbol

This rich dataset empowers developers to build dynamic UIs showing balances, prices, listing statuses, and visual icons—all from a single API call.

💬 Practical Use Cases

1. NFT Marketplace Integration

Marketplaces can use this API to verify ownership before allowing listings or trades. By checking the status and ownerAddress, platforms ensure only legitimate holders can list assets.

2. Portfolio Trackers

Aggregators tracking user assets across chains can batch-fetch rune holdings using comma-separated addresses, then display real-time valuations in BTC and USD.

3. Wallet Applications

Self-custody wallets can enhance user experience by automatically detecting and displaying runes without requiring manual token imports.

👉 See how top-tier Web3 platforms streamline asset discovery with automated syncing.

🔍 Sample Request & Response

While full JSON examples aren’t included here due to formatting constraints, a typical flow looks like this:

Sample Request:

GET /api/v5/mktplace/nft/runes/get-owned-assets?runesId=rune-123&walletAddresses=bc1qabc...,bc1qxyz...&limit=50

Expected Behavior:

• Returns up to 50 rune assets owned by the two specified Bitcoin-based addresses.
• Includes pricing data if listed on supported marketplaces.
• Uses cursor-based pagination for retrieving subsequent pages.

You can parse the response to extract:

• Token icons (tickerIcon) for display
• Balance (amount) for portfolio summaries
• Market status (status) to show “Listed” badges
• Real-time value (usdPrice) for net worth calculations

❓ Frequently Asked Questions

Q: Can I query more than 20 wallet addresses in one request?

No. The maximum number of wallet addresses per request is capped at 20. To process more, split them into multiple requests and aggregate results server-side.

Q: What does "unavailable: 1" mean in the response?

It indicates the UTXO contains multiple Atomicals assets, making it incompatible with standard transfers or listings due to potential conflicts.

Q: How often is the price data updated?

Pricing (in BTC, USD, sats) reflects real-time marketplace listings and is updated as new orders are placed or filled. However, unlisted assets will have null or zero price values.

Q: Is there rate limiting on this API?

Yes. For stability and fair usage, high-frequency requests may be throttled. Implement caching and exponential backoff strategies in production environments.

Q: Does this support testnet or only mainnet?

Currently, the Runes API operates on mainnet only. Always verify chain IDs before processing transactions.

🔑 Core Keywords

To align with search intent and improve SEO visibility, key phrases naturally integrated throughout this article include:

• Runes API
• Web3 API
• WaaS
• get rune assets
• blockchain asset lookup
• NFT marketplace API
• wallet address assets
• UTXO-based tokens

These terms reflect common queries from developers and businesses exploring blockchain integration.

🚀 Final Thoughts

The Get Owned Assets endpoint is a cornerstone for any application interacting with Runes-based digital assets. With support for batch queries, detailed metadata, and real-time pricing, it simplifies what would otherwise require complex on-chain parsing.

As the Runes ecosystem grows, tools like this will become increasingly vital for enabling transparency, liquidity, and usability in decentralized finance and digital ownership.

👉 Start integrating powerful Web3 features today—explore seamless blockchain access now.