Fractal Ordinals API 提供了一套标准化的接口，允许开发者获取特定集合下的所有交易记录。无论是用于市场分析、数据监控还是构建交易工具，该接口都提供了关键的交易细节，包括交易双方地址、时间戳、交易价格和交易类型等信息。
接口功能概述
此接口主要用于返回特定 NFT 集合的所有交易历史记录。返回的数据默认按交易时间降序排列，支持分页查询、排序方式选择，并可按交易类型、平台来源或钱包地址进行筛选。
关键返回信息包括：
- 交易双方的地址
- 交易时间戳
- 交易价格（以 FB 计价）
- 交易类型（如销售、上架、转账等）
- 订单来源平台
请求详情
请求地址
使用 POST 方法调用以下端点：
https://web3.okx.com/api/v5/mktplace/nft/fractal-ordinals/trade-history请求参数说明
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| slug | String | 是 | 集合的唯一标识符 |
| cursor | String | 否 | 分页游标，用于获取指定页码的数据 |
| limit | String | 否 | 每页返回记录数，默认值为 10，最大为 100 |
| sort | String | 否 | 排序方式，可选 desc（降序，默认）或 asc（升序） |
| isBrc20 | Boolean | 否 | 是否检索 Brc20 交易记录，默认为 True |
| orderSourceList | Integer[] | 否 | 按订单来源平台筛选，可填入平台代码，如 [34,54]（34代表OKX，54代表Magic Eden） |
| tradeWalletAddress | String | 否 | 筛选特定钱包地址参与的交易 |
| type | String | 否 | 交易类型，多选用逗号分隔，如 SALE, LIST, TRANSFER；默认为 SALE |
返回参数说明
接口返回一个 Ordinals 活动模型数组，主要包括以下字段：
| 字段名 | 类型 | 说明 |
|---|---|---|
| fromAddress | String | 交易发起方地址 |
| inscriptionId | String | 铭文编号 |
| price | String | 交易价格（FB 计价） |
| timestamp | Long | 交易时间戳 |
| toAddress | String | 交易接收方地址 |
| unitPrice | String | 订单单价（FB 计价） |
| amount | String | 订单中的铭文数量 |
| isBrc20 | Boolean | 是否为 Brc20 类型铭文 |
| orderSource | Integer | 订单来源平台代码 |
| orderSourceName | String | 订单来源平台名称 |
| type | String | 交易类型 |
使用示例
请求示例
以下示例展示如何请求某个 Slug 集合的交易记录，并限制返回数量为 20：
{
"slug": "example-collection",
"limit": "20",
"sort": "desc"
}返回示例
返回数据以数组形式呈现，每条记录包含完整的交易元数据：
[
{
"fromAddress": "abc123...",
"toAddress": "def456...",
"price": "1500",
"timestamp": 1678886400,
"type": "SALE",
"orderSourceName": "OKX"
}
]常见问题
什么是 Fractal Ordinals API？
Fractal Ordinals API 是一套用于获取区块链上 Ordinals 相关交易记录的编程接口，支持按集合、交易类型、平台等多维度筛选数据。
如何按交易类型筛选记录？
在请求参数 type 中填入需要的交易类型，如 SALE,LIST，多个类型之间用英文逗号分隔。
是否支持分页查询？
支持。使用 cursor 和 limit 参数可以实现分页效果，避免单次请求数据量过大。
如何获取 Brc20 以外的交易记录？
将参数 isBrc20 设置为 false，即可检索非 Brc20 类型的 Fractal NFT 交易活动。
能否查询特定钱包的交易历史？
可以，通过 tradeWalletAddress 参数指定钱包地址，接口将返回该地址参与的所有相关交易。
订单来源平台代码有哪些？
常见平台代码包括：34（OKX）、54（Magic Eden）、55（OrdinalsWallet）和 57（Unisat）。在 orderSourceList 中填入数组即可过滤平台。
通过本文介绍的接口及参数，您可以高效获取和管理 Fractal Ordinals 的交易数据，为项目开发或市场分析提供可靠支持。如需进一步了解如何在您的应用中集成这一功能，可以 👉 获取完整的开发文档。