查 UTXO 上铭文#
-
查询 Bitcoin 链，某个 UTXO 上的 Runes、BRC-20、ARC-20、Ordinals NFT 资产的数量及其详细信息。
-
查询 Fractal Bitcoin 链，某个 UTXO 上的 BRC-20 资产的数量及其详细信息。
请求路径#
GET https://web3.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:Runes4: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://web3.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"
}
]
}
]
}