市场 API

获取铭文资产列表#

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

请求地址#

POST https://www.okx.com/api/v5/mktplace/nft/fractal-ordinals/get-valid-inscriptions

请求参数#

参数类型必传描述
slugString合集 slug 名称,即合集的唯一标识
cursorString指向要检索的页面的游标
limitString分页大小 (默认值 10,最大 100)。返回最大的合集数
sortString挂单排序规则:listing_time_desc:订单创建时间最新的在前 listing_time_asc:订单创建时间最早的在前 price_desc:价格最高的在前 price_asc:价格最低的在前 unit_price_desc:单价最高的在前 unit_price_asc:单价最低的在前 默认排序为订单创建时间最新的在前
isBrc20Boolean获取全部 Fractal NFT 或 BRC-20 合集的列表,默认为 BRC-20
walletAddressString获取铭文的钱包地址

响应参数#

铭文数据的列表

参数类型描述
inscriptionIdString铭文 ID
cursorString现在指向的游标
nftIdString铭文 NFT ID 是唯一标识
tickerString币种
tickerIdString币种的 ID
amountString铭文数量

代码请求示例#

shell
curl --location 'https://www.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": ""
  }