获取铭文资产列表#
该接口用于获取指定地址上的 Fractal NFT 和 BRC-20 合集的铭文资产，包括铭文数量，币种和 NFT ID。默认按照成交时间倒序。
请求地址#
POST https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/get-valid-inscriptions
请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| slug | String | 是 | 合集 slug 名称，即合集的唯一标识 |
| cursor | String | 否 | 指向要检索的页面的游标 |
| limit | String | 否 | 分页大小 (默认值 10，最大 100)。返回最大的合集数 |
| sort | String | 否 | 挂单排序规则：listing_time_desc：订单创建时间最新的在前 listing_time_asc：订单创建时间最早的在前 price_desc：价格最高的在前 price_asc：价格最低的在前 unit_price_desc：单价最高的在前 unit_price_asc：单价最低的在前 默认排序为订单创建时间最新的在前 |
| isBrc20 | Boolean | 否 | 获取全部 Fractal NFT 或 BRC-20 合集的列表，默认为 BRC-20 |
| walletAddress | String | 是 | 获取铭文的钱包地址 |
响应参数#
铭文数据的列表
| 参数 | 类型 | 描述 |
|---|---|---|
| inscriptionId | String | 铭文 ID |
| cursor | String | 现在指向的游标 |
| nftId | String | 铭文 NFT ID 是唯一标识 |
| ticker | String | 币种 |
| tickerId | String | 币种的 ID |
| amount | String | 铭文数量 |
代码请求示例#
shell
curl --location 'https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/get-valid-inscriptions' \
--header 'OK-ACCESS-KEY: your API key' \
--header 'OK-ACCESS-PASSPHRASE: your passphrase' \
--header 'Content-Type: application/json' \
--data '{
"slug": "Fractal Ordinals",
"walletAddress": "bc1qek.....27zgdgqfawx",
"limit": "10",
"isBrc20": false
}'
响应示例#
200
{
"code": 0,
"data": {
"cursor": "MTY5N.......WZhd3g=",
"inscriptionInfos": [
{
"amount": "1",
"inscriptionId": "ad14bd7fa6afee2bc37681f6...9b949746d258e0c8133c259a94198febf66bi0",
"nftId": "17407619...517490",
"ticker": "",
"tickerId": ""
},
{
"amount": "1",
"inscriptionId": "6f776f43d119094...37ce8abab7aea902a4455fc7b8b319122880f71a1ci0",
"nftId": "16635...80929138",
"ticker": "",
"tickerId": ""
},
{
"amount": "1",
"inscriptionId": "e0ae7e1ee159...d836fe692b1fb6b25911f9f6edec666da9fb090fdffe4i0",
"nftId": "166355152...29586",
"ticker": "",
"tickerId": ""
}
]
},
"msg": ""
}