获取 Fractal Ordinals 交易历史#
该接口用于返回某个合集下所有成交的记录，包括交易 From 和 To 地址、交易时间和交易价格等。默认按照成交时间倒序。
请求地址#
POST https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/trade-history
请求参数#
| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| slug | String | 是 | 合集 slug 名称，即合集的唯一标识 |
| cursor | String | 否 | 指向要检索的页面的游标 |
| limit | String | 否 | 分页大小（默认值 10，最大 100）。每页返回最多交易历史的条数 |
| sort | String | 否 | 排序规则：交易历史默认按时间倒序 desc 排序，可选正序 asc |
| isBrc20 | Boolean | 否 | 获取全部 Fractal NFT 或 Brc20 合集的交易历史，默认返回 BRC-20 。 |
| orderSourceList | Integer[] | 否 | 获取某些平台的订单，请填入代号，如[34,54]（34:OKX 54:Magic Eden 55:OrdinalsWallet 57:Unisat ）。 |
| tradeWalletAddress | String | 否 | 交易涉及的钱包地址 |
| type | String | 否 | 交易类型，多个以‘,’分割。默认返回成交数据（SALE、LIST、TRANSFER、CANCEL_LIST、UPDATE_PRICE） |
响应参数#
一个 Ordinals 交易历史模型的对象数组
| 参数 | 类型 | 描述 |
|---|---|---|
| fromAddress | String | 交易 From 地址 |
| inscriptionId | String | 铭文编号 |
| price | String | 交易价格，FB 计价 |
| timestamp | Long | 交易时间戳 |
| toAddress | String | 交易 To 地址 |
| unitPrice | String | 订单单价，FB 计价 |
| amount | String | 订单中的铭文数量 |
| isBrc20 | Boolean | 用于区分 Ordinals 铭文类型：Brc20 或者 Fractal NFT |
| orderSource | Integer | 订单来源 |
| orderSourceName | String | 订单来源名称 |
| type | String | 交易类型 |
请求示例#
shell
curl -X POST "https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/trade-history" \
-H 'OK-ACCESS-KEY: XXX' \
-H 'OK-ACCESS-TIMESTAMP: XXX' \
-H 'OK-ACCESS-PASSPHRASE: XXX' \
-H 'OK-ACCESS-SIGN: XXX' \
-d "slug=xxx" \
-d "limit=1"
响应示例#
200
{
"code": 0,
"data": {
"cursor": "MTcwMTE1NTM5MDo5OTZkYzdmMjljMzM1ODJhZjEwNDhjN2ZlMDgyZTU4Y2NhMTQ0ZDA3MzY0YTdkODc4NjUyYjhkM2ZhNGI2MTc3LTAtMjMzNTc5NTYzMDUxOTUxMjI=",
"data": [
{
"amount": "3096",
"fromAddress": "bc1pgnwyzfjl0fmw4n87tr4stv8hyeed3fc2qnavrpkgv2cqv4vywfjsm69w7n",
"inscriptionId": "b4f9d43757afdc94b04738577cf4d8a6f1262cff4c6f489b641c614539d285bdi0",
"inscriptionNumber": "119738160",
"isBrc20": true,
"price": "6.192",
"slug": "people",
"timestamp": 1728991566,
"toAddress": "bc1p9xuw2vdtk0z5m3nv3x6ljr32m4eu30u69472x6yy4rj9zsyguy0qwdu8p7",
"unitPrice": "2000000",
"orderSource": 84,
"orderSourceName": "okx",
"type": "SALE"
}
]
},
"msg": ""
}