查询某个币种的历史价格。
支持主链币、代币的历史币价
支持 Bitcoin 链上的 BRC-20、Runes、ARC-20、SRC-20 铭文代币的历史币价
支持 Fractal Bitcoin 链上的 BRC-20 铭文代币的历史币价。
GET https://www.okx.com/api/v5/wallet/token/historical-price
Parameter | Type | Required | Description |
---|---|---|---|
chainIndex | String | Yes | 链唯一标识 |
tokenAddress | String | No | 代币地址。1 :传""代表查询对应链的主链币。2 :传具体的代币合约地址,代表查询对应的代币。3 :不同铭文代币按如下格式入参:FBRC-20 : 使用 fbtc_fbrc20_name ,如 fbtc_fbrc20_babymusk BRC-20 : 使用 btc-brc20-tick(name) ,如 btc-brc20-ordi Runes : 使用 btc-runesMain-tickId ,如 btc-runesMain-840000:2 SRC-20 :使用 btc-src20-name ,如 btc-src20-utxo |
limit | String | No | 每次查询多少条,默认值为 50,最大 100 |
cursor | String | No | 游标位置,默认为第一个 |
begin | String | No | 开始时间,查询晚于该时间的历史币价。Unix时间戳,用毫秒表示 |
end | String | No | 结束时间,查询早于该时间的历史币价。若 begin 和 end 都不传,查询当前时间以前的历史币价。Unix 时间戳,用毫秒表示 |
period | String | No | 时间间隔单位: 1m : 1分钟 5m : 5分钟 30m : 30分钟 1h : 1小时 1d : 1天(默认) |
Parameter | Type | Description |
---|---|---|
prices | Array | 历史价格的列表 |
>time | String | 分钟时间戳(整分钟) |
>price | String | 币种价格,单位为美元,18 位精度 |
cursor | String | 游标位置 |
For EVM:
curl --location --request GET 'https://www.okx.com/api/v5/wallet/token/historical-price?chainIndex=1&limit=5&begin=1700040600000&period=5m' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
For BTC:
curl --location --request GET 'https://www.okx.com/api/v5/wallet/token/historical-price?chainIndex=0&limit=5&period=5m&tokenAddress=btc-brc20-ordi' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
{
"code": "0",
"msg": "success",
"data": [
{
"cursor":"31",
"prices":[
{
"time": "1700040600000",
"price": "1994.430000000000000000"
},
{
"time": "1700040300000",
"price": "1994.190000000000000000"
},
{
"time": "1700040000000",
"price": "1992.090000000000000000"
},
{
"time": "1700039700000",
"price": "1992.190000000000000000"
},
{
"time": "1700039400000",
"price": "1990.190000000000000000"
}
]
}
]
}