钱包 API

实时币价#

批量查询币种的实时价格。

  • 支持主链币、代币的实时币价

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

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

每次最多可以批量查询 100 个代币的实时价格,按请求示例内的数组格式查询。

请求路径#

POST https://www.okx.com/api/v5/wallet/token/current-price

请求参数#

ParameterTypeRequiredDescription
chainIndexStringYes链唯一标识
tokenAddressStringYes代币地址。
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

响应参数#

ParameterTypeDescription
priceString代币价格,单位为美元
timeString价格的时间,Unix 时间戳格式,用毫秒表示
chainIndexString链唯一标识
tokenAddressString代币地址。为空 "" 代表返回结果是相关链,主链币的数据

请求示例#

shell
curl --location --request POST 'https://www.okx.com/api/v5/wallet/token/current-price' \
--header 'Content-Type: application/json' \
--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' \
--data-raw '[
        {
            "chainIndex": "1",
            "tokenAddress":"0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"
        },
        {
            "chainIndex": "0",
            "tokenAddress": "btc-brc20-ordi"
        },
        {
            "chainIndex": "0",
            "tokenAddress": "btc-arc20-00009b954c9f1358de9c089f95ec420132e4106a89c8fbb3cfda198ae1e5f9d5i0"
        },
        {
            "chainIndex": "0",
            "tokenAddress": "btc-runesMain-840000:2"
        }  
    ]'

响应示例#

200
{
    "code": "0",
    "msg": "success",
    "data": [
        {
            "chainIndex": "1",
            "tokenAddress": "0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"
            "time": "1716892020000",
            "price": "26.458143090226812",
        },
        {
            "chainIndex": "0",
            "tokenAddress": "btc-brc20-ordi",
            "time": "1724147119541",
            "price": "32.430139864000000000"
        },
        {
            "chainIndex": "0",
            "tokenAddress": "btc-arc20-00009b954c9f1358de9c089f95ec420132e4106a89c8fbb3cfda198ae1e5f9d5i0",
            "time": "1724153703045",
            "price": "0.003558564230000000"
        },
        {
            "chainIndex": "0",
            "tokenAddress": "btc-runesMain-840000:2",
            "time": "1724145196000",
            "price": "0.000455104500000000"
        }
   ]
}