Query Inscriptions on UTXO: Comprehensive Guide to Bitcoin Asset Tracking

This guide explains how to query detailed information about digital assets (including Runes, BRC-20, ARC-20, and Ordinals NFTs) stored on specific UTXOs (Unspent Transaction Outputs) across Bitcoin-based blockchains.

Key Features

Bitcoin Chain Analysis: Retrieve quantity and metadata for multiple asset types on Bitcoin UTXOs
Fractal Bitcoin Support: Specialized queries for BRC-20 assets on Fractal Bitcoin chain UTXOs
Protocol Agnostic: Works with BRC-20, ARC-20, Runes, and Ordinals NFT standards

👉 Master Bitcoin asset tracking with our API solutions

API Endpoint

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

Required Parameters

Parameter	Description	Type	Example
`chainIndex`	Blockchain identifier	String	"btc-mainnet"
`txHash`	Transaction hash containing UTXO	String	"a1b2c3..."
`voutIndex`	Output position index (0-based)	String	"0"

Response Structure

Core UTXO Information

address: Owning wallet address
txhash: Source transaction ID
voutIndex: Output position reference
utxoStatus: Confirmation state (pending/confirmed)

Asset Details (`btcAssets` array)

Field	Description	Protocol Applicability
`protocol`	Asset standard (1-4)	All
`tokenAmount`	Transferable balance	BRC-20/ARC-20/Runes
`inscriptionNumber`	Mint sequence ID	Ordinals
`nftOffset`	Inscription location	Ordinals NFT

Usage Examples

Request

curl -X GET "https://web3.okx.com/api/v5/wallet/utxo/utxo-detail?chainIndex=btc-mainnet&txHash=3fa4...&voutIndex=1"

Response

{
  "address": "bc1q...",
  "txhash": "3fa4...",
  "voutIndex": "1",
  "btcAssets": [
    {
      "protocol": "1",
      "symbol": "OKX",
      "tokenAmount": "1000"
    }
  ]
}

👉 Explore advanced UTXO analysis techniques

FAQ

Q1: What's the difference between UTXO and account-based models?

A: UTXO (Unspent Transaction Output) models track discrete transaction outputs like physical cash, while account models maintain balance states like bank accounts.

Q2: Why would a UTXO show 'unresolved' protocols?

A: This indicates the block containing this UTXO hasn't been fully parsed by the protocol's indexer yet.

Q3: How many assets can one UTXO contain?

A: A single UTXO may contain multiple inscriptions (up to 1,000 tracked per protocol).

Q4: Are Ordinals NFTs different from BRC-20 tokens?

A: Yes - Ordinals are unique digital artifacts, while BRC-20 are fungible tokens sharing characteristics with ERC-20.

Best Practices

Always verify utxoStatus before processing assets
Monitor unresolved arrays for completion updates
Combine with address-based queries for comprehensive asset tracking