查询 UTXO#

查询当前钱包下 UTXO

请求地址#

POST https://www.okx.com/api/v5/waas/transaction/get-utxo

请求参数#

Parameter	Type	Required	Description
chainId	Int	Yes	链唯一标识
utxoRequests	Array	Yes	UTXO 请求
>address	String	Yes	地址信息，必填
>coinAmount	String	Yes	转账金额
>serviceCharge	String	No	转账手续费，手续费为空时，会设置为建议值
>utxoType	String	Yes	UTXO 类型 utxoType = 1 ：普通转账 utxoType = 2 ：获取 NFT 所在 UTXO utxoType = 11 : 铭刻场景
>nftId	string	No	NFT ID，utxoType 为 2 时必填

响应参数#

Parameter	Type	Description
address	string	地址
canTransferAmount	string	最大可转金额，单位为聪
utxoType	int	UTXO 类型 utxoType = 1 ：适用普通转账场景，只返回已确认、待处理、解除占用的 UTXO utxoType = 2 ：根据 nftid 获取所在 UTXO utxoType = 11 ：适用铭刻场景，只返回已确认的 UTXO
utxoList	array	UTXO 列表
>txHash	string	交易哈希
>vout	int	输出的序列数
>coinAmount	int	UTXO 上余额数量，单位是聪
>status	int	1：已确认交易 UTXO 0：待处理交易 UTXO

请求示例#

shell

curl --location --request POST 'https://www.okx.com/api/v5/waas/transaction/get-utxo' \
--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' \
--data-raw '{
  "chainId": 0,
  "utxoRequests": [{
    "address": "bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u",
    "coinAmount": 1500,
    "serviceCharge": 3600,
    "utxoType": 11
  }]
}'

响应示例#

200

{
  "code": 0,
  "msg": "success",
  "data": [{
    "address": "bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u",
    "canTransferAmount": "86560",
    "utxoType": 11,
    "utxoList": [{
      "txHash": "a5dfa15d33577b77e68b39492a7adb5e6666bf1e34f17d6b041050e45d8abc1d",
      "vout": 1,
      "coinAmount": 86560,
      "status": 1
    }]
  }]
}