P2P Order Management

Get Pending Orders

GET

https://api.bitget.com

/api/v3/p2p/pending-orders

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of ongoing P2P orders (pending payment, pending release, or in appeal).

Get Pending Orders › Request Parameters

orderId

string

Order ID

side

string

Trade direction: buy buy sell sell. Returns all types if not provided

startTime

string

Query start time. Unix timestamp in milliseconds

endTime

string

Query end time. Unix timestamp in milliseconds

cursor

string

Cursor for pagination

limit

string

Number of items per page. Maximum: 10

Get Pending Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Data list

nextId

string

Next page cursor ID

Get All Orders

GET

https://api.bitget.com

/api/v3/p2p/all-orders

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the full history of P2P orders with support for filtering by status, time range, and pagination via cursor. Maximum query range is 90 days; single query range cannot exceed 30 days.

Get All Orders › Request Parameters

startTime

string

Start time. Unix timestamp in milliseconds, e.g. 1597026383085. Maximum query range: 90 days; single query range: 30 days

endTime

string

End time. Unix timestamp in milliseconds, e.g. 1597026383085

limit

string

Number of items per page. Default: 10

cursor

string

Cursor ID for pagination. Leave empty for the first request; pass the nextId returned in the previous response for subsequent requests

orderId

string

Order ID

side

string

Trade direction: buy buy sell sell. Returns all types if not provided

status

string

Order status: pending_payment pending payment pending_release pending release completed completed cancelled cancelled in_appeal in appeal. Returns all statuses if not provided

Get All Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Data list

nextId

string

Next page cursor ID

Get Order Info

GET

https://api.bitget.com

/api/v3/p2p/order-info

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get detailed information for a specific P2P order, including payment method details, buyer/seller info, and order status.

Get Order Info › Request Parameters

orderId

string · required

Order ID

Get Order Info › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

side

string

Trade direction: buy buy sell sell

token

string

Cryptocurrency

fiat

string

Fiat currency

price

string

Trade unit price

quantity

string

Trade quantity in cryptocurrency

amount

string

Trade amount in fiat currency

status

string

Order status: pending_payment pending payment pending_release pending release completed completed cancelled cancelled in_appeal in appeal

advId

string

Corresponding ad ID

remark

string

Ad remarks

orderCancelCountdown

string

Remaining countdown for order cancellation in seconds

fee

string

Fee

verifyCapital

string

Whether asset-verification order: yes yes no no

object

Payment method details. Only returned for non-asset-verification orders

object

Seller details

object

Buyer details

createdTime

string

Order creation time in ms

updatedTime

string

Order last update time in 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": "Fast release",
    "orderCancelCountdown": "600",
    "fee": "0",
    "verifyCapital": "no",
    "payMethodDetail": {
      "payMethodId": "1",
      "payMethodName": "Alipay",
      "payMethodUserName": "UserA",
      "postscript": "",
      "payMethodInfo": [
        {
          "name": "Account",
          "type": "txt",
          "value": "13800138000"
        }
      ]
    },
    "sellUserInfo": {
      "nickName": "MerchantA",
      "realName": "A"
    },
    "buyUserInfo": {
      "nickName": "UserA",
      "realName": "B"
    },
    "createdTime": "1740000000000",
    "updatedTime": "1740000001000"
  }
}

json

application/json

Confirm Payment

POST

https://api.bitget.com

/api/v3/p2p/order-pay

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Mark a P2P order as paid. Call this endpoint after the buyer has completed the payment to notify the seller.

Confirm Payment › Request Parameters

orderId

string · required

Order ID

Confirm Payment › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Operation result

Release Asset

POST

https://api.bitget.com

/api/v3/p2p/order-release

Rate limit: 10/sec/UID

Permission: UTA withdrawal

Confirm coin release for a P2P sell order after verifying the buyer's payment. This endpoint requires the withdrawal IP whitelist to be configured.

Release Asset › Request Parameters

orderId

string · required

Order ID

Release Asset › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Operation result

P2P Ad Management P2P Account Management

Get Pending Orders

GET

https://api.bitget.com

/api/v3/p2p/pending-orders

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of ongoing P2P orders (pending payment, pending release, or in appeal).

Get Pending Orders › Request Parameters

orderId

string

Order ID

side

string

Trade direction: buy buy sell sell. Returns all types if not provided

startTime

string

Query start time. Unix timestamp in milliseconds

endTime

string

Query end time. Unix timestamp in milliseconds

cursor

string

Cursor for pagination

limit

string

Number of items per page. Maximum: 10

Get Pending Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Data list

nextId

string

Next page cursor ID

Get All Orders

GET

https://api.bitget.com

/api/v3/p2p/all-orders

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the full history of P2P orders with support for filtering by status, time range, and pagination via cursor. Maximum query range is 90 days; single query range cannot exceed 30 days.

Get All Orders › Request Parameters

startTime

string

Start time. Unix timestamp in milliseconds, e.g. 1597026383085. Maximum query range: 90 days; single query range: 30 days

endTime

string

End time. Unix timestamp in milliseconds, e.g. 1597026383085

limit

string

Number of items per page. Default: 10

cursor

string

Cursor ID for pagination. Leave empty for the first request; pass the nextId returned in the previous response for subsequent requests

orderId

string

Order ID

side

string

Trade direction: buy buy sell sell. Returns all types if not provided

status

string

Order status: pending_payment pending payment pending_release pending release completed completed cancelled cancelled in_appeal in appeal. Returns all statuses if not provided

Get All Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Data list

nextId

string

Next page cursor ID

Get Order Info

GET

https://api.bitget.com

/api/v3/p2p/order-info

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get detailed information for a specific P2P order, including payment method details, buyer/seller info, and order status.

Get Order Info › Request Parameters

orderId

string · required

Order ID

Get Order Info › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

side

string

Trade direction: buy buy sell sell

token

string

Cryptocurrency

fiat

string

Fiat currency

price

string

Trade unit price

quantity

string

Trade quantity in cryptocurrency

amount

string

Trade amount in fiat currency

status

string

Order status: pending_payment pending payment pending_release pending release completed completed cancelled cancelled in_appeal in appeal

advId

string

Corresponding ad ID

remark

string

Ad remarks

orderCancelCountdown

string

Remaining countdown for order cancellation in seconds

fee

string

Fee

verifyCapital

string

Whether asset-verification order: yes yes no no

object

Payment method details. Only returned for non-asset-verification orders

object

Seller details

object

Buyer details

createdTime

string

Order creation time in ms

updatedTime

string

Order last update time in ms

Confirm Payment

POST

https://api.bitget.com

/api/v3/p2p/order-pay

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Mark a P2P order as paid. Call this endpoint after the buyer has completed the payment to notify the seller.

Confirm Payment › Request Parameters

orderId

string · required

Order ID

Confirm Payment › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Operation result

Release Asset

POST

https://api.bitget.com

/api/v3/p2p/order-release

Rate limit: 10/sec/UID

Permission: UTA withdrawal

Confirm coin release for a P2P sell order after verifying the buyer's payment. This endpoint requires the withdrawal IP whitelist to be configured.

Release Asset › Request Parameters

orderId

string · required

Order ID

Release Asset › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Operation result