获取钱包资产#

该接口用于获取某个地址下的符文资产

请求地址#

GET https://www.okx.com/api/v5/mktplace/nft/runes/get-owned-asserts

请求参数#

字段名	类型	是否必传	说明
runesId	String	是	代币的唯一标识
walletAddresses	String	是	钱包地址，多个地址则以英文逗号分隔 (,)，钱包地址不超过 20 个
cursor	String	否	指向要检索的排序序号的游标 (最大 1,000)
limit	Integer	否	分页大小 (默认值 10，最大 100)。返回最大的条数

返回参数#

参数	类型	参数说明
assetId	String	id (DB 主键无实际意义)
tickerType	Integer	代币类型 (4-Runes)
ticker	String	代币名称
tickerId	String	代币 id
ownerAddress	String	钱包地址
amount	String	在该 UTXO 的 XRC20 数量
chain	Integer	链
inscriptionNum	String	Inscription 编号
utxoTxHash	String	交易 hash
utxoVout	Integer	utxoVout
utxoValue	String	utxoValue
txHash	String	交易 hash
name	String	代币名称
tickerIcon	String	代币 icon 链接
status	Integer	挂单状态 (0-未挂单 1-已挂单 2-pending中)
listTime	Long	挂单时间
orderId	Long	订单 id
confirmations	Long	区块高度信息
currency	String	总价 - 币种
currencyUrl	String	总价 - 币种 url
satPrice	BigDecimal	总价 - sat 价格
price	BigDecimal	总价 - btc 价格
usdPrice	BigDecimal	总价 - usd 价格
currency	String	单价 - 币种
currencyUrl	String	单价 - 币种 url
satPrice	BigDecimal	单价 - sat 价格
price	BigDecimal	单价 - btc 价格
usdPrice	BigDecimal	单价 - usd 价格
unavailable	Integer	"1 - 同一个 UTXO 包含多个 Atomicals 资产； 2 - 同一个 UTXO 包含多个协议资产"
symbol	String	Symbol

请求示例#

shell

curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/get-owned-asserts?runesId=840000:3&walletAddresses=bc1p3fj806enwnmz04444mpm42ykgdcta9p5mvzx46hp8wmg2knpwxpq0k46x9&limit=10' \
--header 'OK-ACCESS-KEY: XXXX' \
--header 'OK-ACCESS-PASSPHRASE: XXXX'

返回示例#

200

{
  "code": 0,
  "data": {
  "cursor": "1",
  "items": [
{
  "amount": "500000",
  "assetId": "28912795273673038",
  "chain": 0,
  "confirmations": null,
  "inscriptionNum": "",
  "listTime": 1714399069,
  "name": "DOG•GO•TO•THE•MOON",
  "orderId": 201296,
  "ownerAddress": "bc1p3fj806enwnmz04444mpm42ykgdcta9p5mvzx46hp8wmg2knpwxpq0k46x9",
  "status": 1,
  "symbol": "🐕",
  "ticker": "DOG•GO•TO•THE•MOON",
  "tickerIcon": "https://static.coinall.ltd/cdn/web3/currency/token/1714125941761.png/type=png_350_0",
  "tickerId": "840000:3",
  "tickerType": 4,
  "totalPrice": {
  "currency": "BTC",
  "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
  "price": "0.031895",
  "satPrice": "3189500",
  "usdPrice": "1979.7003235"
},
  "txHash": "",
  "unavailable": null,
  "unitPrice": {
  "currency": "BTC",
  "currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
  "price": "0.00000006379",
  "satPrice": "6.379",
  "usdPrice": "0.003959400647"
},
  "utxoTxHash": "ce302f5c946ff3ef502eade58405d64b545d59de9fcd731314b88ddadf709ca6",
  "utxoValue": "546",
  "utxoVout": 2
}
  ]
},
  "msg": ""
}