P2P 订单管理

获取进行中订单

GET

https://api.bitget.com

/api/v3/p2p/pending-orders

限频规则: 10次/秒/UID

权限: 统一账户P2P只读权限

获取进行中的P2P订单列表（待付款、待放币或申诉中）。

获取进行中订单 › Request Parameters

orderId

string

订单编号

side

string

交易方向： buy 买入 sell 卖出。不传则默认为全部类型

startTime

string

查询开始时间，Unix毫秒时间戳

endTime

string

查询结束时间，Unix毫秒时间戳

cursor

string

游标

limit

string

每页条数，最大 10

获取进行中订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

数据集合

nextId

string

下一页标识ID

获取全部订单

GET

https://api.bitget.com

/api/v3/p2p/all-orders

限频规则: 10次/秒/UID

权限: 统一账户P2P只读权限

获取P2P全部历史订单，支持按状态、时间范围筛选及游标分页。最大查询范围90天，单次查询范围不超过30天。

获取全部订单 › Request Parameters

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 申诉中。不传则默认为全部状态

获取全部订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

数据集合

nextId

string

下一页标识ID

获取订单详情

GET

https://api.bitget.com

/api/v3/p2p/order-info

限频规则: 10次/秒/UID

权限: 统一账户P2P只读权限

获取指定P2P订单的详细信息，包括支付方式详情、买卖双方信息及订单状态。

获取订单详情 › Request Parameters

orderId

string · required

订单ID

获取订单详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单ID

side

string

交易方向： buy 买 sell 卖

token

string

加密货币

fiat

string

法币

price

string

成交单价

quantity

string

成交数量（加密货币）

amount

string

成交金额（法币）

status

string

订单状态： pending_payment 待付款 pending_release 待放币 completed 已完成 cancelled 已取消 in_appeal 申诉中

advId

string

对应广告ID

remark

string

广告备注

orderCancelCountdown

string

订单取消倒计时剩余时间，单位为秒

fee

string

手续费

verifyCapital

string

是否验资订单： yes 验资单 no 非验资单

object

支付方式详情，仅非验资订单返回

object

卖家详情

object

买家详情

createdTime

string

订单创建时间（ms）

updatedTime

string

最近更新时间（ms）

GET/api/v3/p2p/order-info

curl 'https://api.bitget.com/api/v3/p2p/order-info?orderId=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "orderId": "ORD123456",
    "side": "sell",
    "token": "USDT",
    "fiat": "CNY",
    "price": "7.28",
    "quantity": "100",
    "amount": "728",
    "status": "pending_release",
    "advId": "1234567890",
    "remark": "快速放币",
    "orderCancelCountdown": "600",
    "fee": "0",
    "verifyCapital": "no",
    "payMethodDetail": {
      "payMethodId": "1",
      "payMethodName": "支付宝",
      "payMethodUserName": "UserA",
      "postscript": "",
      "payMethodInfo": [
        {
          "name": "账号",
          "type": "txt",
          "value": "13800138000"
        }
      ]
    },
    "sellUserInfo": {
      "nickName": "MerchantA",
      "realName": "A"
    },
    "buyUserInfo": {
      "nickName": "UserA",
      "realName": "B"
    },
    "createdTime": "1740000000000",
    "updatedTime": "1740000001000"
  }
}

json

application/json

标记订单已付款（确认付款）

POST

https://api.bitget.com

/api/v3/p2p/order-pay

限频规则: 10次/秒/UID

权限: 统一账户P2P读写权限

将P2P订单标记为已付款。买方完成付款后调用此接口通知卖方。

标记订单已付款（确认付款） › Request Parameters

orderId

string · required

订单ID

标记订单已付款（确认付款） › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

释放资产（确认放币）

POST

https://api.bitget.com

/api/v3/p2p/order-release

限频规则: 10次/秒/UID

权限: 统一账户提币权限

P2P出售订单中，卖方确认收款后调用此接口释放加密货币给买方。此接口需要配置提币IP白名单。

释放资产（确认放币） › Request Parameters

orderId

string · required

订单ID

释放资产（确认放币） › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

P2P 广告管理 P2P 账户管理

获取进行中订单

GET

https://api.bitget.com

/api/v3/p2p/pending-orders

限频规则: 10次/秒/UID

权限: 统一账户P2P只读权限

获取进行中的P2P订单列表（待付款、待放币或申诉中）。

获取进行中订单 › Request Parameters

orderId

string

订单编号

side

string

交易方向： buy 买入 sell 卖出。不传则默认为全部类型

startTime

string

查询开始时间，Unix毫秒时间戳

endTime

string

查询结束时间，Unix毫秒时间戳

cursor

string

游标

limit

string

每页条数，最大 10

获取进行中订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

数据集合

nextId

string

下一页标识ID

获取全部订单

GET

https://api.bitget.com

/api/v3/p2p/all-orders

限频规则: 10次/秒/UID

权限: 统一账户P2P只读权限

获取P2P全部历史订单，支持按状态、时间范围筛选及游标分页。最大查询范围90天，单次查询范围不超过30天。

获取全部订单 › Request Parameters

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 申诉中。不传则默认为全部状态

获取全部订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

数据集合

nextId

string

下一页标识ID

获取订单详情

GET

https://api.bitget.com

/api/v3/p2p/order-info

限频规则: 10次/秒/UID

权限: 统一账户P2P只读权限

获取指定P2P订单的详细信息，包括支付方式详情、买卖双方信息及订单状态。

获取订单详情 › Request Parameters

orderId

string · required

订单ID

获取订单详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单ID

side

string

交易方向： buy 买 sell 卖

token

string

加密货币

fiat

string

法币

price

string

成交单价

quantity

string

成交数量（加密货币）

amount

string

成交金额（法币）

status

string

订单状态： pending_payment 待付款 pending_release 待放币 completed 已完成 cancelled 已取消 in_appeal 申诉中

advId

string

对应广告ID

remark

string

广告备注

orderCancelCountdown

string

订单取消倒计时剩余时间，单位为秒

fee

string

手续费

verifyCapital

string

是否验资订单： yes 验资单 no 非验资单

object

支付方式详情，仅非验资订单返回

object

卖家详情

object

买家详情

createdTime

string

订单创建时间（ms）

updatedTime

string

最近更新时间（ms）

标记订单已付款（确认付款）

POST

https://api.bitget.com

/api/v3/p2p/order-pay

限频规则: 10次/秒/UID

权限: 统一账户P2P读写权限

将P2P订单标记为已付款。买方完成付款后调用此接口通知卖方。

标记订单已付款（确认付款） › Request Parameters

orderId

string · required

订单ID

标记订单已付款（确认付款） › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

释放资产（确认放币）

POST

https://api.bitget.com

/api/v3/p2p/order-release

限频规则: 10次/秒/UID

权限: 统一账户提币权限

P2P出售订单中，卖方确认收款后调用此接口释放加密货币给买方。此接口需要配置提币IP白名单。

释放资产（确认放币） › Request Parameters

orderId

string · required

订单ID

释放资产（确认放币） › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果