跳到主要内容

Ticker

获取一个或多个交易对的最新价格以及滚动 24 小时统计数据。

接口​

GET /v1/market/ticker

权重： 单个交易对 2；当 symbol 与 symbols 均未提供时（返回所有交易对）为 40。

鉴权： 公开（可选签名）。

查询参数​

名称类型必填说明
symbolstring否单个交易对，例如 BTCUSDT。返回单个对象。
symbolsstring否JSON 编码的交易对数组，例如 ["BTCUSDT","ETHUSDT"]。返回数组。请对值进行 URL 编码。

symbol 与 symbols 互斥。若两者均未提供，接口将返回所有正在交易的交易对的 Ticker。

响应​

单个交易对（symbol=BTCUSDT）：

{
  "symbol": "BTCUSDT",
  "price": "67432.15",
  "bid": "67431.90",
  "ask": "67432.40",
  "volume_24h": "18234.4521",
  "quote_volume_24h": "1229874512.33",
  "change_24h_pct": "2.34",
  "high_24h": "68120.00",
  "low_24h": "65890.10",
  "count_24h": 482913,
  "close_time": 1745923200000
}

多个交易对（symbols=["BTCUSDT","ETHUSDT"]）或不带参数——返回数组：

[
  {
    "symbol": "BTCUSDT",
    "price": "67432.15",
    "bid": "67431.90",
    "ask": "67432.40",
    "volume_24h": "18234.4521",
    "quote_volume_24h": "1229874512.33",
    "change_24h_pct": "2.34",
    "high_24h": "68120.00",
    "low_24h": "65890.10",
    "count_24h": 482913,
    "close_time": 1745923200000
  },
  {
    "symbol": "ETHUSDT",
    "price": "3421.88",
    "bid": "3421.80",
    "ask": "3421.95",
    "volume_24h": "215431.221",
    "quote_volume_24h": "738912334.10",
    "change_24h_pct": "-0.91",
    "high_24h": "3489.50",
    "low_24h": "3380.00",
    "count_24h": 318204,
    "close_time": 1745923200000
  }
]

响应字段​

字段类型说明
symbolstring交易对，大写。
pricestring (decimal)最新成交价。
bidstring (decimal)订单簿上的最优买价。
askstring (decimal)订单簿上的最优卖价。
volume_24hstring (decimal)滚动 24 小时基础资产成交量。
quote_volume_24hstring (decimal)滚动 24 小时计价资产成交量。
change_24h_pctstring (decimal)24 小时价格变动百分比。"2.34" 表示 +2.34%；"-0.91" 表示 -0.91%。
high_24hstring (decimal)滚动 24 小时窗口内的最高成交价。
low_24hstring (decimal)滚动 24 小时窗口内的最低成交价。
count_24hinteger滚动 24 小时窗口内的成交笔数。
close_timeinteger窗口收盘时间，Unix 毫秒（ms）。

错误​

HTTP错误码含义
400INVALID_PARAMETER同时提供了 symbol 和 symbols，或 symbols 不是合法 JSON。
400UNKNOWN_SYMBOL一个或多个请求的交易对不存在。
429RATE_LIMITED单个 Key 的请求权重已超限。

示例​

curl -s "https://api.pipai.io/v1/market/ticker?symbol=BTCUSDT"
curl -s --get "https://api.pipai.io/v1/market/ticker" \
  --data-urlencode 'symbols=["BTCUSDT","ETHUSDT"]'