获取铭文资产列表#

该接口用于获取指定地址上的 BTC NFT 和 BRC-20 合集的铭文资产，包括铭文数量，币种和 NFT ID。默认按照成交时间倒序。

请求地址#

POST https://www.okx.com/api/v5/mktplace/nft/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	否	获取全部 BTC 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://www.okx.com/api/v5/mktplace/nft/ordinals/get-valid-inscriptions' \
--header 'OK-ACCESS-KEY: your API key' \
--header 'OK-ACCESS-PASSPHRASE: your passphrase' \
--header 'Content-Type: application/json' \
--data '{
    "slug": "BTC Ordinals",
    "walletAddress": "bc1qek.....27zgdgqfawx",
    "limit": "10",
    "isBrc20": false
}'

响应示例#

200

{
      "code": 0,
      "data": {
          "cursor": "MTY5N.......WZhd3g=",
          "inscriptionInfos": [
              {
                  "amount": "1",
                  "inscriptionId": "6218a48de6039b1e...fdce171601083961f45a326856dd30ffi0",
                  "nftId": "208249...3273458",
                  "ticker": "",
                  "tickerId": ""
              },
              {
                  "amount": "1",
                  "inscriptionId": "caf70bcc595389...a1ccb4ec81fa0a0612a95f2e8402a10710a373i0",
                  "nftId": "20793046...2400114",
                  "ticker": "",
                  "tickerId": ""
              },
              {
                  "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": ""
  }