查 UTXO 上铭文#

查询 Bitcoin 链，某个 UTXO 上的 Runes、BRC-20、ARC-20、Ordinals NFT 资产的数量及其详细信息。
查询 Fractal Bitcoin 链，某个 UTXO 上的 BRC-20 资产的数量及其详细信息。

请求路径#

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

请求参数#

Parameter	Type	Required	Description
chainIndex	String	Yes	链唯一标识
txHash	Sring	Yes	对应 UTXO 的交易哈希
voutIndex	String	Yes	标识 UTXO 位于输出的第几位，和 txhash 一起，可以唯一映射指定的 UTXO

响应参数#

Parameter	Type	Description
address	String	地址
txhash	String	UTXO 对应的 txhash
voutIndex	String	标识 UTXO 位于输出的第几位，和 txhash 一起，可以唯一映射指定的 UTXO
unresolved	Array	返回哪些协议未完成区块解析，不确定 UTXO 内是否有对应资产
utxoStatus	String	UTXO 状态 `pending` ：确认中 `confrimed`：已确认 `Not found`：未找到
btcAssets	Array	当前 UTXO 上的铭文资产详情，每个资产最多返回 1000 条。
>protocol	String	协议类型 `1`:BRC-20 `2`:ARC-20 `3`:Runes `4`:ordi_nft `5`:SRC-20
>tokenAmount	String	UTXO 上可转的代币资产数量
>eventType	String	返回 BRC-20 的具体交易事件
>decimal	String	精度，如果没有则返回为空
>symbol	String	币种名称，如果没有则返回为空
>inscriptionNumber	String	链上铸造序号
>nftId	String	nft 的唯一标识，txhash+i+0，仅 Ordinals 协议支持的 BRC-20 及 Ordinals_nft 返回
>nftOffset	String	nft 位置信息 offset，铭刻在 UTXO 上的位置，仅 Ordinals 协议支持的 BRC-20 及 Ordinals_nft 返回

请求示例#

shell

curl --location --request GET 'https://www.okx.com/api/v5/wallet/utxo/utxo-detail?chainIndex=0&txHash=cd7b77b068142ee1b099a360aeb287b5e02d4603a4523cb12d18cbd58aa47985&voutIndex=0'
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'

响应示例#

200

{
    "code": "0",
    "msg": "success",
    "data": [
        {
            "addresses": [
                "bc1p8qfrmxdlmynr076uu28vlszxavwujwe7dus0r8y9thrnp5lgfh6qu2ctrr"
            ],
            "txHash": "cd7b77b068142ee1b099a360aeb287b5e02d4603a4523cb12d18cbd58aa47985",
            "voutIndex": "0",
            "utxoStatus":"confirmed" ,
            "unresolved": [],
            "btcAssets": [
                {
                    "protocol": "4",
                    "tokenAmount": "",
                    "eventType": "",
                    "decimal": "0",
                    "symbol": "",
                    "inscriptionNumber": "11896131",
                    "nftId": "0b7c063d14d73cdb83e3454643fc1e4a3701bd5dc2f9550e5ab303247a68f7cai0",
                    "nftOffset": "0"
                }
            ]
        }
    ]
}