钱包 API

历史币价#

查询某个币种的历史价格。

  • 支持主链币、代币的历史币价

  • 支持 Bitcoin 链上的 BRC-20、Runes、ARC-20、SRC-20 铭文代币的历史币价

  • 支持 Fractal Bitcoin 链上的 BRC-20 铭文代币的历史币价。

请求路径#

GET https://www.okx.com/api/v5/wallet/token/historical-price

请求参数#

ParameterTypeRequiredDescription
chainIndexStringYes链唯一标识
tokenAddressStringNo代币地址。
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
limitStringNo每次查询多少条,默认值为 50,最大 100
cursorStringNo游标位置,默认为第一个
beginStringNo开始时间,查询晚于该时间的历史币价。Unix时间戳,用毫秒表示
endStringNo结束时间,查询早于该时间的历史币价。若 begin 和 end 都不传,查询当前时间以前的历史币价。Unix 时间戳,用毫秒表示
periodStringNo时间间隔单位:
1m: 1分钟
5m: 5分钟
30m: 30分钟
1h: 1小时
1d: 1天(默认)

响应参数#

ParameterTypeDescription
pricesArray历史价格的列表
>timeString分钟时间戳(整分钟)
>priceString币种价格,单位为美元,18 位精度
cursorString游标位置

请求示例#

shell
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' 

响应示例#

200
{
    "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"
            }
        ]
      }
    ]
}