获取交易历史#
该接口用于获取合集下的成交数据（最近成交价、数量），支持通过runesid获取指定项目成交事件。
请求地址#
GET https://web3.okx.com/api/v5/mktplace/nft/runes/trade-history
请求参数#
| 字段名 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| runesIds | String | 否 | 代币唯一标识，如果多个以英文逗号(,)分隔，不超过20个，空串会查询所有代币的交易历史 |
| cursor | String | 否 | 指向要检索的排序序号的游标 |
| limit | Integer | 否 | 分页大小（默认值 10，最大100）。返回最大的交易历史数 |
| startTime | Long | 否 | 交易动态的起始时间（单位：秒） |
| endTime | Long | 否 | 交易动态的截止时间（单位：秒） |
返回参数#
| 参数 | 类型 | 参数说明 |
|---|---|---|
| runesId | String | runesId |
| name | String | 代币名称 |
| txHash | String | 交易hash |
| typeName | String | activity-类型名称（SALE、TRANSFER等） |
| amount | String | 代币数量 |
| from | String | from地址 |
| to | String | to地址 |
| createOn | Date | 创建时间 |
| platformName | Long | 平台名称 |
| currency | String | 总价 - 币种 |
| currencyUrl | String | 总价 - 币种 url |
| satPrice | BigDecimal | 总价 - sat 价格 |
| price | BigDecimal | 总价 - btc 价格 |
| usdPrice | BigDecimal | 总价 - usd 价格 |
| currency | String | 单价 - 币种 |
| currencyUrl | String | 单价 - 币种 url |
| satPrice | BigDecimal | 单价 - sat 价格 |
| price | BigDecimal | 单价 - btc 价格 |
| usdPrice | BigDecimal | 单价 - usd 价格 |
| status | Integer | 状态，1：成功，2：pending |
请求示例#
shell
curl --location --request GET 'https://beta.okex.org/api/v5/mktplace/nft/runes/trade-history?runesIds=840000:3&type=SALE&startTime=1713604337&endTime=1713607937' \
--header 'OK-ACCESS-KEY: XXXX' \
--header 'OK-ACCESS-PASSPHRASE: XXXX'
返回示例#
200
{
"code": 0,
"data": {
"activityList": [
{
"amount": "3360",
"createOn": 1714398184000,
"from": "bc1p0a9xxqvh7c4l3xzcxuhdmsntlau69jnzu79jau20fza8676lfwmqnyy393",
"name": "RSIC•GENESIS•RUNE",
"platformName": "OKX",
"runesId": "840000:28",
"status": 1,
"to": "bc1pnhukwhm2vmgsepkfxjyccgv2l0h2nu4fq0dchxdlkjpssmt2k45qkvnqjr",
"totalPrice": {
"currency": "BTC",
"currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
"price": "0.00079968",
"satPrice": "79968",
"usdPrice": "49.54137552"
},
"txHash": "6ef9a11965cd8771a383f6447a5cdf438832368c86a46fa465aee1cd59cc4ad7",
"typeName": "SALE",
"unitPrice": {
"currency": "BTC",
"currencyUrl": "https://static.coinall.ltd/cdn/nft/4834651a-7c4e-4249-91c1-cf680af39dc0.png",
"price": "0.000000238",
"satPrice": "23.8",
"usdPrice": "0.014744457"
}
}
],
"cursor": "MTMyMjM3MTEwNTQyMzM2MTE=",
"hasNext": true
},
"msg": ""
}