Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
API Document
Classic
    P2P
      Get P2P Merchant ListgetGet Merchant InformationgetGet Merchant Advertisement ListgetGet Merchant P2P Ordersget
Classic P2P API
Classic P2P API

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/api/v2/p2p/merchantList
curl https://api.bitget.com/api/v2/p2p/merchantList
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1681195810516, "data": { "merchantList": [ { "registerTime": "1678674575000", "nickName": "test1", "isOnline": "no", "avgPaymentTime": "0", "avgReleaseTime": "0", "totalTrades": "0", "totalBuy": "0", "totalSell": "0", "totalCompletionRate": "0", "trades30d": "8", "sell30d": "4", "buy30d": "4", "completionRate30d": "0.8" } ], "minMerchantId": "1" } }
json
application/json

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

Email

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/api/v2/p2p/merchantInfo
curl https://api.bitget.com/api/v2/p2p/merchantInfo
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1681194805204, "data": { "registerTime": "1672039640000", "nickName": "lz", "merchantId": "1", "avgPaymentTime": "172695", "avgReleaseTime": "33009", "totalTrades": "2", "totalBuy": "1", "totalSell": "0", "totalCompletionRate": "1", "trades30d": "12", "sell30d": "4", "buy30d": "8", "completionRate30d": "0.71", "kycStatus": "yes", "emailBindStatus": "yes", "mobileBindStatus": "yes", "email": "******@*****.com", "mobile": "18*34" } }
json
application/json

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

advId
​string

Advertisement order ID

advNo
​string

Advertisement order number

side
​string

TX type

sell

buy

advSize
​string

Total number of advertisement orders

size
​string

Filled quantity

coin
​string

Coins such as BGB, USDT, BTC, ETH etc.

price
​string

Price

coinPrecision
​string

Currency precision, decimala

fiat
​string

Fiat

fiatPrecision
​string

Fiat decimals

fiatSymbol
​string

Currency symbol

status
​string

Advertisement order status

online: Online

offline: Offline

editing: Editing

completed: Completed

hide
​string

Hide the advertisement order or not

yes: Hide

no: not hide

maxTradeAmount
​string

Maximum order quantity

minTradeAmount
​string

Minimum order quantity

payDuration
​string

Time period for payment after placing an order, min

turnoverNum
​string

Total trading amount

turnoverRate
​string

Close rate

label
​string

Note

ctime
​string

Creation time, Unix millisecond timestamps

utime
​string

Update time, Unix millisecond timestamps

​object

Upper limit of the advertiser order restricted user

Upper limit of the advertiser order restricted user
minCompleteNum
​string

Minimum number of completed user orders

maxCompleteNum
​string

Maximum number of completed user orders

placeOrderNum
​string

Maximum number of orders a user can place under this advertisement

allowMerchantPlace
​string

Whether to allow merchants to place orders

yes: allow

no: not allow

completeRate30d
​string

30-day close rate

country
​string

Only people from these countries are allowed to place orders

​object[]

Payment methods number

paymentMethod
​string

Payment name

paymentId
​string

Payment ID

​object[]

Payment method detail information

required
​boolean

Required or not: true/false

name
​string

Payment details

type
​string

Payment method detail information type

​object[]

Merchant authentication number

imageUrl
​string

Gold Merchant certification pictures

desc
​string

Gold Merchant certification parameter description

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

orderId
​string

ID

orderNo
​string

Order no.

advNo
​string

Advertisement order number

side
​string

Types: buy/sell

count
​string

Amount

coin
​string

Fiat Currency

price
​string

Price

fiat
​string

Fiat

withdrawTime
​string

Time of withdrawal of this order

representTime
​string

Appeal time

releaseTime
​string

Coin release time

paymentTime
​string

Repayment time

amount
​string

Order amount

status
​string

P2P order status

buyerRealName
​string

Buyer name

sellerRealName
​string

Seller name

ctime
​string

Creation time, Unix millisecond timestamps

utime
​string

Update time, Unix millisecond timestamps

​object

Payment Info

Payment Info
paymethodName
​string

Payment method name

paymethodId
​string

Payment method ID

​object[]

Payment method details

name
​string

Payment detail name

required
​string

Required or not: yes/no

type
​string

type, number/file. Ignore this parameter

value
​string

Payment information value

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