P2P

Classic Account — P2P

Get P2P Merchant List

GET

https://api.bitget.com

/api/v2/p2p/merchantList

Rate limit:10 requests/s (UID)

Get P2P merchant list

Get P2P Merchant List › Request Parameters

online

string

Whether online? yes: online no: offline

idLessThan

string

The minMerchantId returned from the previous query. Returns data whose ID is less than the entry parameter.

limit

string

Number of queries The default value is 100

Get P2P Merchant List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

merchantList

string[]

Merchant list

registerTime

string

Registration time

nickName

string

Alias

isOnline

string

Whether online

avgPaymentTime

string

Average payment time (in minutes)

avgReleaseTime

string

Average time to release coins (in minutes)

totalTrades

string

Total traded orders

totalBuy

string

Total number of purchase orders

totalSell

string

Total number of sell orders

totalCompletionRate

string

Total execution rate

trades30d

string

30-day trading volume

sell30d

string

30-day sell orders

buy30d

string

30-day purchase orders

completionRate30d

string

30-day close rate

minMerchantId

string

Returns the smallest merchantId in the result

Get Merchant Information

GET

https://api.bitget.com

/api/v2/p2p/merchantInfo

Frequency limit:10 times/1s (UID)

Get Merchant Information

Get Merchant Information › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

registerTime

string

Registration time

nickName

string

Alias

merchantId

string

Merchant ID

kycStatus

string

KYC or not yes no

emailBindStatus

string

Email bound? yes no

mobileBindStatus

string

Phone number bound? yes no

email

string

mobile

string

Phone number

avgPaymentTime

string

Average payment time in minutes

avgReleaseTime

string

Average coin release time in minutes

totalTrades

string

Total traded orders

totalBuy

string

Total number of purchase orders

totalSell

string

Total number of sell orders

totalCompletionRate

string

Total execution rate

trades30d

string

30-day trading volume

sell30d

string

30-day sell orders

buy30d

string

30-day purchase orders

completionRate30d

string

30-day close rate

Get Merchant Advertisement List

GET

https://api.bitget.com

/api/v2/p2p/advList

Frequency limit:10 times/1s (UID)

Get Merchant Advertisement List

Get Merchant Advertisement List › Request Parameters

startTime

string · required

Start time, Unix millisecond timestamp, e.g. 1690196141868

status

string · required

Advertisement order status online: Online offline: Offline editing: Editing completed: Completed

side

string · required

TX type buy: Buy sell: Sell

coin

string · required

Digital currency

fiat

string · required

Fiat

endTime

string

End time, Unix millisecond timestamp, e.g. 1690196141868 Maximum interval between start time and end time is 90 days

idLessThan

string

The minAdvId returned from the previous query. Returns the data whose advId is less than the specified input parameter.

limit

string

Number of queries: Default: 20, max:20.

advNo

string

Advertisement order

language

string

Language zh-CN: Chinese en-US: English

orderBy

string

Sort Fields createTime: Create time price: Price Descending, by createTime by default

payMethodId

string

Payment method id

sourceType

string

Query range owner:query owner advertisement(default) competitior:query other merchant advertisement ownerAndCompetitior:query all advertisement

Get Merchant Advertisement List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Number of advertisement orders

minAdvId

string

Returns the minimum advId of the result

GET/api/v2/p2p/advList

curl 'https://api.bitget.com/api/v2/p2p/advList?startTime=<string>&status=<string>&side=<string>&coin=<string>&fiat=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1696930053072,
  "data": {
    "advList": [
      {
        "advId": "1",
        "advNo": "1",
        "side": "buy",
        "advSize": "0.6",
        "size": "0",
        "coin": "BTC",
        "price": "155570.9",
        "coinPrecision": "36",
        "fiat": "CNY",
        "fiatPrecision": "2",
        "fiatSymbol": "￥",
        "status": "online",
        "hide": "no",
        "maxTradeAmount": "93342.54",
        "minTradeAmount": "100",
        "payDuration": "4",
        "turnoverNum": "8",
        "turnoverRate": "1.00",
        "label": null,
        "userLimitList": {
          "minCompleteNum": "0",
          "maxCompleteNum": "0",
          "placeOrderNum": "0",
          "allowMerchantPlace": "no",
          "completeRate30d": "0",
          "country": ""
        },
        "paymentMethodList": [
          {
            "paymentMethod": "Bank Card",
            "paymentId": "11",
            "paymentInfo": [
              {
                "name": "Bank Card",
                "required": true,
                "type": "txt"
              }
            ]
          },
          {
            "paymentMethod": "WeChat",
            "paymentId": "12",
            "paymentInfo": [
              {
                "name": "Payment code",
                "required": true,
                "type": "file"
              },
              {
                "name": "WeChatAccount",
                "required": true,
                "type": "txt"
              }
            ]
          },
          {
            "paymentMethod": "Alipay",
            "paymentId": "13",
            "paymentInfo": [
              {
                "name": "AlipayAccount",
                "required": true,
                "type": "txt"
              },
              {
                "name": "Payment code",
                "required": true,
                "type": "file"
              }
            ]
          }
        ],
        "merchantCertifiedList": [],
        "utime": "1696733724267",
        "ctime": "1696733724267"
      }
    ],
    "minAdvId": "1"
  }
}

json

application/json

Get Merchant P2P Orders

GET

https://api.bitget.com

/api/v2/p2p/orderList

Frequency limit:10 times/1s (UID)

Merchant queries P2P orders

Get Merchant P2P Orders › Request Parameters

startTime

string

Start time, Unix millisecond timestamp, e.g. 1690196141868

endTime

string

End time, Unix millisecond timestamp, e.g. 1690196141868 Maximum interval between start time and end time is 90 days

idLessThan

string

The minOrderId returned from the previous query. Returns p2p order data less than the specified entry parameter.

limit

string

Number of queries, default 100

status

string

P2P order status pending_pay: pending payment Paid: coins to be released Appeal: Appeal in progress Completed: Completed cancelled: cancelled

advNo

string

Advertisement order number

side

string

TX type buy: Buy sell: Sell

coin

string

Digital currency name, e.g. USDT

language

string

Language zh-CN: Chinese en-US: English

fiat

string

Fiat currency name, e.g. USD

orderNo

string

Order no.

Get Merchant P2P Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Order number

minOrderId

string

Returns the minimum orderId of record.

GET/api/v2/p2p/orderList

curl https://api.bitget.com/api/v2/p2p/orderList

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1681201761390,
  "data": {
    "orderList": [
      {
        "orderId": "1",
        "orderNo": "1",
        "advNo": "1",
        "price": "1",
        "count": "11",
        "side": "buy",
        "fiat": "USD",
        "coin": "USDT",
        "withdrawTime": "",
        "representTime": "",
        "paymentTime": "",
        "releaseTime": "",
        "amount": "11",
        "buyerRealName": "",
        "sellerRealName": "兰州",
        "status": "cancelled",
        "paymentInfo": {
          "paymethodName": "paypal",
          "paymethodId": "1",
          "paymethodInfo": [
            {
              "name": "繁体中文",
              "required": "yes",
              "type": "number",
              "value": "11****"
            },
            {
              "name": "繁体中文",
              "required": "yes",
              "type": "file",
              "value": "http://abc.x.com/otc/images/20230116/1.jpg"
            }
          ]
        },
        "utime": "1696732368875",
        "ctime": "1681111722251"
      }
    ],
    "minOrderId": "1"
  }
}

json

application/json

Get P2P Merchant List

GET

https://api.bitget.com

/api/v2/p2p/merchantList

Rate limit:10 requests/s (UID)

Get P2P merchant list

Get P2P Merchant List › Request Parameters

online

string

Whether online? yes: online no: offline

idLessThan

string

The minMerchantId returned from the previous query. Returns data whose ID is less than the entry parameter.

limit

string

Number of queries The default value is 100

Get P2P Merchant List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

merchantList

string[]

Merchant list

registerTime

string

Registration time

nickName

string

Alias

isOnline

string

Whether online

avgPaymentTime

string

Average payment time (in minutes)

avgReleaseTime

string

Average time to release coins (in minutes)

totalTrades

string

Total traded orders

totalBuy

string

Total number of purchase orders

totalSell

string

Total number of sell orders

totalCompletionRate

string

Total execution rate

trades30d

string

30-day trading volume

sell30d

string

30-day sell orders

buy30d

string

30-day purchase orders

completionRate30d

string

30-day close rate

minMerchantId

string

Returns the smallest merchantId in the result

Get Merchant Information

GET

https://api.bitget.com

/api/v2/p2p/merchantInfo

Frequency limit:10 times/1s (UID)

Get Merchant Information

Get Merchant Information › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

registerTime

string

Registration time

nickName

string

Alias

merchantId

string

Merchant ID

kycStatus

string

KYC or not yes no

emailBindStatus

string

Email bound? yes no

mobileBindStatus

string

Phone number bound? yes no

email

string

mobile

string

Phone number

avgPaymentTime

string

Average payment time in minutes

avgReleaseTime

string

Average coin release time in minutes

totalTrades

string

Total traded orders

totalBuy

string

Total number of purchase orders

totalSell

string

Total number of sell orders

totalCompletionRate

string

Total execution rate

trades30d

string

30-day trading volume

sell30d

string

30-day sell orders

buy30d

string

30-day purchase orders

completionRate30d

string

30-day close rate

Get Merchant Advertisement List

GET

https://api.bitget.com

/api/v2/p2p/advList

Frequency limit:10 times/1s (UID)

Get Merchant Advertisement List

Get Merchant Advertisement List › Request Parameters

startTime

string · required

Start time, Unix millisecond timestamp, e.g. 1690196141868

status

string · required

Advertisement order status online: Online offline: Offline editing: Editing completed: Completed

side

string · required

TX type buy: Buy sell: Sell

coin

string · required

Digital currency

fiat

string · required

Fiat

endTime

string

End time, Unix millisecond timestamp, e.g. 1690196141868 Maximum interval between start time and end time is 90 days

idLessThan

string

The minAdvId returned from the previous query. Returns the data whose advId is less than the specified input parameter.

limit

string

Number of queries: Default: 20, max:20.

advNo

string

Advertisement order

language

string

Language zh-CN: Chinese en-US: English

orderBy

string

Sort Fields createTime: Create time price: Price Descending, by createTime by default

payMethodId

string

Payment method id

sourceType

string

Query range owner:query owner advertisement(default) competitior:query other merchant advertisement ownerAndCompetitior:query all advertisement

Get Merchant Advertisement List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Number of advertisement orders

minAdvId

string

Returns the minimum advId of the result

Get Merchant P2P Orders

GET

https://api.bitget.com

/api/v2/p2p/orderList

Frequency limit:10 times/1s (UID)

Merchant queries P2P orders

Get Merchant P2P Orders › Request Parameters

startTime

string

Start time, Unix millisecond timestamp, e.g. 1690196141868

endTime

string

End time, Unix millisecond timestamp, e.g. 1690196141868 Maximum interval between start time and end time is 90 days

idLessThan

string

The minOrderId returned from the previous query. Returns p2p order data less than the specified entry parameter.

limit

string

Number of queries, default 100

status

string

P2P order status pending_pay: pending payment Paid: coins to be released Appeal: Appeal in progress Completed: Completed cancelled: cancelled

advNo

string

Advertisement order number

side

string

TX type buy: Buy sell: Sell

coin

string

Digital currency name, e.g. USDT

language

string

Language zh-CN: Chinese en-US: English

fiat

string

Fiat currency name, e.g. USD

orderNo

string

Order no.

Get Merchant P2P Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Order number

minOrderId

string

Returns the minimum orderId of record.