跳转到主要内容
GET
/
v1
/
market
/
ticker
Market Ticker
curl --request GET \
  --url https://api.tickdb.ai/v1/market/ticker \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "BTCUSDT",
      "price": "43250.50",
      "change": "1250.30",
      "change_percent": "2.98",
      "volume": "15420.5",
      "high": "43800.00",
      "low": "41900.00",
      "timestamp": 1703123456789
    }
  ]
}
GET /v1/market/ticker

​
概述

获取一个或多个交易品种的实时市场行情数据。

​
查询参数

名称类型必需描述
symbolsstring是逗号分隔的交易品种，最多 50 个

​
多市场示例

点击任意交易品种自动填充参数： 加密货币：BTCUSDT、ETHUSDT、ADAUSDT 美股：AAPL.US、TSLA.US、MSFT.US 港股：700.HK、9988.HK、3690.HK 外汇：EURUSD、GBPUSD、USDJPY 指数：SPX、NDX、DJI 贵金属：XAUUSD、XAGUSD

​
请求示例

curl -X GET "https://api.tickdb.ai/v1/market/ticker?symbols=BTCUSDT,AAPL.US" \
  -H "X-API-Key: YOUR_API_KEY"

​
响应格式

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "BTCUSDT",
      "price": "43250.50",
      "change": "1250.30",
      "change_percent": "2.98",
      "volume": "15420.5",
      "high": "43800.00",
      "low": "41900.00",
      "timestamp": 1703123456789
    }
  ]
}

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/ticker?symbols=AAPL.US,700.HK,BTCUSDT,XAGUSD"

​
响应示例

{
    "code": 0,
    "message": "success",
    "data": [
        {
            "symbol": "AAPL.US",
            "last_price": "259.62",
            "volume_24h": "45263767",
            "high_24h": "260.26",
            "low_24h": "259.5",
            "timestamp": 1768265997000
        },
        {
            "symbol": "700.HK",
            "last_price": "628",
            "volume_24h": "10154124",
            "high_24h": "0",
            "low_24h": "626.5",
            "timestamp": 1768273479000
        },
        {
            "symbol": "BTCUSDT",
            "last_price": "91170.59000000",
            "volume_24h": "14308.45245000",
            "high_24h": "92519.95000000",
            "low_24h": "90128.44000000",
            "price_change_24h": "-991.91000000",
            "price_change_percent_24h": "-1.076",
            "timestamp": 1768273481005
        },
        {
            "symbol": "XAGUSD",
            "last_price": "85.76650",
            "bid_price": "85.72820",
            "ask_price": "85.80480",
            "timestamp": 1768273481000
        }
    ]
}

授权

​
X-API-Key
string
header
必填

查询参数

​
symbols
string
必填

Comma-separated symbols (max 50)

示例:

"BTCUSDT,AAPL.US"

响应

200 - application/json

Successful response

​
code
integer
示例:

0

​
message
string
示例:

"success"

​
data
object[]