获取全部订单
获取全部订单
描述
获取P2P全部历史订单,支持按状态、时间范围筛选及游标分页。最大查询范围90天,单次查询范围不超过30天。
HTTP请求
- GET /api/v3/p2p/all-orders
- 限频规则: 10次/秒/UID
- 需要统一账户P2P只读权限
请求示例
curl "https://api.bitget.com/api/v3/p2p/all-orders?limit=10" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json"
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| startTime | String | 否 | 开始时间戳,Unix时间戳的毫秒数格式,如 1597026383085。最大查询范围90天,单次查询范围不超过30天 |
| endTime | String | 否 | 结束时间戳,Unix时间戳的毫秒数格式,如 1597026383085 |
| limit | String | 否 | 每页条目数,默认 10 |
| cursor | String | 否 | 游标ID,用于翻页。首次调用不传,后续调用传上次返回的 nextId |
| orderId | String | 否 | 订单编号 |
| side | String | 否 | 交易方向:buy 买入 sell 卖出。不传则默认为全部类型 |
| status | String | 否 | 订单状态:pending_payment 待付款 pending_release 待放币 completed 已完成 cancelled 已取消 in_appeal 申诉中。不传则默认为全部状态 |
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": {
"items": [
{
"orderId": "ORD123456",
"side": "sell",
"token": "USDT",
"fiat": "CNY",
"price": "7.28",
"amount": "728",
"quantity": "100",
"fee": "0",
"counterparty": "UserA",
"status": "completed",
"createdTime": "1740000000000",
"updatedTime": "1740000001000"
}
],
"nextId": "ORD123455"
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| items | List | 数据集合 |
| >orderId | String | 订单编号 |
| >side | String | 交易方向:buy 买入 sell 卖出 |
| >token | String | 加密货币币种 |
| >fiat | String | 法币币种 |
| >price | String | 成交单价 |
| >amount | String | 成交金额,单位为法币 |
| >quantity | String | 成交数量,单位为加密货币 |
| >fee | String | 手续费 |
| >counterparty | String | 交易对象 |
| >status | String | 订单状态:0 pending_payment 待付款 1 pending_release 待放币 2 completed 已完成 3 cancelled 已取消 4 in_appeal 申诉中 |
| >createdTime | String | 订单创建时间,Unix毫秒时间戳 |
| >updatedTime | String | 订单更新时间,Unix毫秒时间戳 |
| nextId | String | 下一页标识ID |