Check Inscriptions on UTXO | Asset Query by Address | On-chain Information Query

Understanding the assets tied to a specific Unspent Transaction Output (UTXO) is essential for developers, traders, and blockchain analysts navigating the evolving Bitcoin ecosystem. With the rise of token protocols like BRC-20, ARC-20, Runes, and Ordinals NFTs, being able to inspect UTXO-level inscriptions provides critical visibility into asset ownership, transferability, and on-chain data integrity.

This guide walks you through querying detailed asset information on both the Bitcoin mainnet and the Fractal Bitcoin chain using a powerful Web3 API endpoint. Whether you're building a wallet service, analyzing transaction histories, or verifying digital collectibles, this tool delivers precise, real-time insights directly from the blockchain.

🔍 Querying Inscription Data on UTXOs

The API allows you to retrieve comprehensive details about inscribed assets stored within a specific UTXO. This includes token quantities, protocol types, NFT identifiers, and more — all tied directly to a transaction hash and output index.

You can use this functionality to:

• Verify ownership of BRC-20 tokens or Ordinals NFTs
• Audit Runes balances before transfers
• Identify incomplete or pending inscriptions
• Support wallet-as-a-service (WaaS) applications with accurate balance displays

👉 Discover how to access real-time UTXO inscription data with powerful Web3 tools.

🛠️ API Endpoint Overview

Request Path

GET https://web3.okx.com/api/v5/wallet/utxo/utxo-detail

This secure, scalable endpoint returns structured JSON data detailing all detectable assets inscribed on a given UTXO.

📥 Required Request Parameters

To fetch accurate results, the following parameters must be included in your request:

Example: To query an inscription from transaction a1b2c3d4... at output position 0, set txHash=a1b2c3d4... and voutIndex=0.

These three fields together uniquely identify any UTXO across supported chains.

📤 Response Structure Explained

Upon successful request, the API returns a detailed response object containing the following key fields:

Core Response Fields

• address – The Bitcoin address associated with the UTXO.
• txhash – Confirms the transaction ID linked to this output.
• voutIndex – Repeats the output index for confirmation.

• utxoStatus – Status of the UTXO:

  • pending: Not yet confirmed on-chain
  • confirmed: Fully confirmed
  • Not found: No such UTXO exists or is unindexed
• unresolved – Array of protocols where block parsing is incomplete. If present, indicates uncertainty about whether assets exist on this UTXO.

🧩 Inscribed Asset Details (btcAssets)

This array contains up to 1,000 entries per asset type, listing all detected inscriptions. Each entry includes:

• protocol – Type of protocol used:

  • 1: BRC-20
  • 2: ARC-20
  • 3: Runes
  • 4: ordi_nft (Ordinals-based NFTs)
• tokenAmount – Transferable quantity of the token (e.g., "1000" for 1,000 units of a BRC-20 token).
• eventType – For BRC-20 only; specifies action type such as deploy, mint, or transfer.
• decimal – Decimal precision (if applicable); returns empty if not defined.
• symbol – Token ticker symbol (e.g., "ORDI", "SATS"); may be blank.
• inscriptionNumber – Unique on-chain minting number assigned during inscription.
• nftId – Unique NFT identifier in format txhash+i+0, used for BRC-20 and Ordinals NFTs.
• nftOffset – Offset value indicating where the inscription begins within the UTXO data.

💡 Tip: Use inscriptionNumber and nftId to verify authenticity and provenance of rare digital artifacts.

👉 Access advanced on-chain analytics with developer-first Web3 APIs.

🔎 Practical Use Cases

1. Wallet Development

Wallet providers can integrate this API to automatically detect and display BRC-20 or Runes balances without requiring users to manually input token contracts.

2. NFT Marketplaces

Marketplaces trading Ordinals NFTs can validate listings by checking nftId, inscriptionNumber, and address to prevent fraud.

3. Blockchain Analytics

Researchers can track asset movements across UTXOs to study market trends, whale activity, or protocol adoption rates.

4. Transaction Verification

Before accepting payments in BRC-20 tokens, merchants can confirm both the existence and validity of inscriptions on received UTXOs.

❓ Frequently Asked Questions

Q: What is a UTXO?

A: A UTXO (Unspent Transaction Output) is a fundamental unit in Bitcoin’s accounting system. It represents coins that have been sent to an address but not yet spent. Each UTXO can carry inscribed data via protocols like BRC-20 or Runes.

Q: Can one UTXO contain multiple types of assets?

A: Yes. A single UTXO may include inscriptions from different protocols — for example, both a BRC-20 token and an Ordinals NFT. The API will list each asset separately in the btcAssets array.

Q: Why does my query return "Not found"?

A: This could mean the transaction hasn’t been confirmed, the txHash or voutIndex is incorrect, or the node hasn’t fully indexed that part of the chain yet.

Q: Is there rate limiting on this API?

A: While not specified here, most production-grade Web3 APIs enforce usage limits. Always check documentation or contact support for SLA details.

Q: How often is the data updated?

A: Data reflects the latest confirmed blocks. For best accuracy, ensure your queries follow network confirmation standards (typically 1+ block confirmations).

🌐 Supported Chains & Protocols

Fractal Bitcoin currently supports only BRC-20 assets due to its focused implementation model.

🚀 Getting Started with Integration

Developers can begin integrating this API into their applications immediately:

1. Construct your GET request with valid chainIndex, txHash, and voutIndex.
2. Send it to the endpoint:
   https://web3.okx.com/api/v5/wallet/utxo/utxo-detail
3. Parse the JSON response to extract asset details.
4. Handle edge cases like pending status or unresolved protocols appropriately in your UI.

For automated workflows, consider caching frequently accessed UTXO data while respecting update intervals.

👉 Start building with reliable, high-performance Web3 infrastructure today.

✅ Final Thoughts

As Bitcoin evolves beyond simple peer-to-peer cash into a platform for digital assets and inscriptions, tools that offer granular visibility into UTXOs become indispensable. By leveraging this API, developers gain direct access to rich on-chain metadata — empowering smarter wallets, safer trading platforms, and deeper analytical capabilities.

Whether you're tracking Runes emissions or validating an Ordinals NFT purchase, precise UTXO inspection ensures trustless verification straight from the blockchain ledger.

With seamless integration, robust data structure, and support for emerging protocols, this endpoint stands as a cornerstone for modern Web3 development on Bitcoin.