最近成交 (Recent Trades)
获取特定交易对最近的成交历史。
接口信息
- Method:
GET - Path:
/api/v1/markets/:symbol/trades - Authentication: 不需身份验证
路径参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对名称（如 BTCUSDT） |
查询参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| limit | number | 否 | 返回数量（默认 50，最大 500） |
响应示例
{
"symbol": "BTCUSDT",
"trades": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"price": "65000.00",
"amount": "0.1",
"side": "buy",
"timestamp": 1704067200000
},
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"price": "64999.50",
"amount": "0.05",
"side": "sell",
"timestamp": 1704067190000
}
]
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| symbol | string | 交易对名称 |
| trades | array | 成交记录列表 |
Trade 对象字段
| 字段 | 类型 | 描述 |
|---|---|---|
| id | string | 成交 ID |
| price | string | 成交价格 |
| amount | string | 成交数量 |
| side | string | 成交方向（buy 为主动买入，sell 为主动卖出） |
| timestamp | number | 成交时间（Unix 时间戳，毫秒） |
说明
- 成交记录按时间倒序排列（最新的在前）
- 数据来源于数据库的 trades 表
- 所有价格和数量均为字符串格式以保证精度
- side 表示 taker 的方向：
buy: taker 主动买 入（吃掉卖单）sell: taker 主动卖出（吃掉买单）
错误响应
| HTTP 状态码 | 错误码 | 描述 |
|---|---|---|
| 404 | INVALID_MARKET | 未知的交易对 |