最新公开成交

描述

返回某交易对的最新成交记录，按时间倒序排列。每条记录代表一笔已完成的成交，并显示 taker 方向。

HTTP 请求

GET /spot/trades (公开 (无需鉴权))

权重

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

请求参数

名称	类型	必填	描述
symbol	STRING	必填	交易对标识符（如 DFUSDT）。区分大小写。参见 GET /spot/markets。
limit	NUMBER	可选	返回的成交条数。默认 50，范围 1–1000。

响应示例

200 OK

[
  {
    "trade_id": "9f2a1c4e-5b67-4d8a-bf93-2e1f4a6c8d10",
    "symbol":   "DFUSDT",
    "side":     "buy",
    "price":    "0.5000",
    "quantity": "30",
    "ts":       1778400000123
  },
  {
    "trade_id": "3e761331-0cec-481c-81be-f62ab572757b",
    "symbol":   "DFUSDT",
    "side":     "sell",
    "price":    "0.4999",
    "quantity": "50",
    "ts":       1778399990456
  }
]

字段	说明
trade_id	服务端生成的 UUID，唯一标识此笔成交。
side	本次成交的 taker 方向——即主动促成撮合的一方。
ts	Unix 毫秒时间戳。这是现货 REST API 中唯一使用毫秒精度的时间戳；其他时间戳均使用 Unix 秒。

错误响应

HTTP	error
500	DB_ERROR

完整列表：错误代码。

代码示例

cURL

curl -s "https://api-sepolia.p99.world/api/v1/spot/trades?symbol=DFUSDT&limit=5"

Python

import requests

BASE = "https://api-sepolia.p99.world/api/v1"

trades = requests.get(f"{BASE}/spot/trades", params={"symbol": "DFUSDT", "limit": 5}).json()
for t in trades:
    print(t["trade_id"], t["side"], t["price"], "×", t["quantity"], "@", t["ts"], "ms")