获取钱包资产#
该接口用于获取某个地址下的符文资产
请求地址#
GET https://web3.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": ""
}