跳轉到主要內容
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": "700.HK",
      "last_price": "543",
      "volume_24h": "11205874",
      "high_24h": "557",
      "low_24h": "543",
      "price_change_24h": "-9",
      "price_change_percent_24h": "-1.63",
      "timestamp": 1773292807000
    },
    {
      "symbol": "AAPL.US",
      "last_price": "260.81",
      "volume_24h": "26218927",
      "high_24h": "262.13",
      "low_24h": "259.55",
      "price_change_24h": "-0.02",
      "price_change_percent_24h": "-0.01",
      "timestamp": 1773259201000
    }
  ]
}

​
注意事項

  • 最多可同時查詢 50 個交易品種
  • 時間戳單位為毫秒（UTC）

​
支持的市場

外匯、貴金屬、指數、美股、港股、A股、加密貨幣 示例：
  • 外匯：EURUSD、GBPUSD、USDJPY
  • 貴金屬：XAUUSD、XAGUSD
  • 指數：SPX、NDX、DJI
  • 美股：AAPL.US、TSLA.US、MSFT.US
  • 港股：700.HK、9988.HK、3690.HK
  • A股：600519.SH、000001.SZ、920186.BJ
  • 加密貨幣：BTCUSDT、ETHUSDT、ADAUSDT

​
請求參數

參數名是否必須描述
symbols是交易產品代碼，多個用逗號分隔，最多50個
type否產品類型，可選。代碼無歧義時無需傳遞；若返回 AMBIGUOUS_SYMBOL 錯誤，按提示傳入對應值即可。可選值：stock、indices、crypto、forex

​
返回字段說明

字段說明
symbol交易產品
last_price最新成交價
volume_24h24小時成交量
high_24h24小時最高價
low_24h24小時最低價
price_change_24h24小時價格變化
price_change_percent_24h24小時價格變化百分比
timestamp數據時間戳（毫秒，UTC）

授權

​
X-API-Key
string
header
必填

查詢參數

​
symbols
string
預設值:700.HK,AAPL.US
必填

Comma-separated symbols (max 50)

範例:

"700.HK,AAPL.US"

​
type
enum<string>

Symbol type, optional. Not required when the symbol is unambiguous; if the API returns an AMBIGUOUS_SYMBOL error, pass the value as indicated

可用選項:
stock,
indices,
crypto,
forex
範例:

"stock"

回應

200 - application/json

Successful response

​
code
integer
範例:

0

​
message
string
範例:

"success"

​
data
object[]
範例:
[
  {
    "symbol": "700.HK",
    "last_price": "543",
    "volume_24h": "11205874",
    "high_24h": "557",
    "low_24h": "543",
    "price_change_24h": "-9",
    "price_change_percent_24h": "-1.63",
    "timestamp": 1773292807000
  },
  {
    "symbol": "AAPL.US",
    "last_price": "260.81",
    "volume_24h": "26218927",
    "high_24h": "262.13",
    "low_24h": "259.55",
    "price_change_24h": "-0.02",
    "price_change_percent_24h": "-0.01",
    "timestamp": 1773259201000
  }
]