跳到主要内容

24 小时 Ticker

描述​

返回拥有 ticker 记录的一个或全部交易对的 24 小时滚动统计数据。每次成交时增量更新，后台衰减任务每 60 秒重新计算一次，以处理超出时间窗口的成交记录。

HTTP 请求​

GET /spot/ticker/24hr (公开 (无需鉴权))

权重​

0 — 当前公开行情接口对单个 IP 不设权重限制 (MVP)。

请求参数​

名称类型必填描述
symbolSTRING可选交易对标识符（如 DFUSDT）。不传时返回所有拥有 ticker 记录的交易对数组；传入时返回单个对象。**注意：**全交易对模式不做任何 status 过滤 — 仍有 ticker 记录的 halted / delisted 交易对会与 listed 交易对一并返回。（只有 listed 交易对参与每 60 秒的后台重算，因此非 listed 交易对的记录可能已过期。）

响应示例​

单交易对模式（?symbol=DFUSDT）— 200 OK

{
  "symbol":       "DFUSDT",
  "last_price":   "0.5000",
  "open_price":   "0.4800",
  "high":         "0.5100",
  "low":          "0.4700",
  "volume":       "10000",
  "quote_volume": "5000",
  "trade_count":  234,
  "open_time":    1778313600,
  "close_time":   1778400000
}

全交易对模式（不传 symbol）— 200 OK

[
  {
    "symbol":       "DFUSDT",
    "last_price":   "0.5000",
    "open_price":   "0.4800",
    "high":         "0.5100",
    "low":          "0.4700",
    "volume":       "10000",
    "quote_volume": "5000",
    "trade_count":  234,
    "open_time":    1778313600,
    "close_time":   1778400000
  }
]
字段说明
last_price历史上最新的成交价——不受 24 小时窗口限制。
open_price24 小时滚动窗口内的首笔成交价。若窗口内无成交，则等于 last_price。
high / low24 小时窗口内的最高/最低成交价。
volume窗口内基础代币成交量。
quote_volume窗口内报价代币成交额（名义价值）。
trade_count整数（非字符串）。窗口内独立成交笔数。
open_time / close_timeUnix 秒。时间窗口为 [now - 86400, now]。

错误响应​

HTTPerror
404TICKER_NOT_FOUND — 指定 symbol 查询时，该交易对尚无 ticker 记录（尚未发生任何成交）。首笔成交后自动解除。
500DB_ERROR

完整列表：错误代码。

代码示例​

cURL​

# Single market
curl -s "https://api.prex.world/api/v1/spot/ticker/24hr?symbol=DFUSDT"

# All listed markets
curl -s "https://api.prex.world/api/v1/spot/ticker/24hr"

Python​

import requests

BASE = "https://api.prex.world/api/v1"

# Single market
ticker = requests.get(f"{BASE}/spot/ticker/24hr", params={"symbol": "DFUSDT"}).json()
print(ticker["symbol"], "last:", ticker["last_price"],
      "24h range:", ticker["low"], "–", ticker["high"],
      "vol:", ticker["volume"])

# All markets
all_tickers = requests.get(f"{BASE}/spot/ticker/24hr").json()
for t in all_tickers:
    print(t["symbol"], t["last_price"])