Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
P2P
    P2P Common
      Get Balanceget
    P2P Ad Management
      Get Ad ListgetGet Exchange RategetFee SimulatepostGet Ad LimitgetCreate AdpostUpdate AdpostOperate AdpostGet Ad InfogetGet My Adsget
    P2P Order Management
      Get Pending OrdersgetGet All OrdersgetGet Order InfogetConfirm PaymentpostRelease Assetpost
    P2P Account Management
      Get User InfogetGet CurrenciesgetGet Pay Methodsget
P2P
P2P

P2P Account Management

P2P Account Management


Get User Info

GET
https://api.bitget.com
/api/v3/p2p/user-info

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the current merchant's P2P account information, including account level, trading statistics, and posting limits.

Get User Info › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
uid
​string

Account ID

nickName
​string

Nickname

accountLevel
​string

Account level: starter regular user advanced advanced merchant master top merchant

completedOrderNum
​string

Total completed orders

positiveRate
​string

Positive review rate (decimal, e.g. 0.99 = 99%)

completedOrderNum30D
​string

Orders completed in the last 30 days

completedRate30D
​string

Completion rate in the last 30 days

avgPayTime30D
​string

Average payment time in the last 30 days in minutes

avgReleaseTime30D
​string

Average coin release time in the last 30 days in minutes

​object

Posting limit details

registerTime
​string

Registration time. Unix timestamp in milliseconds

GET/api/v3/p2p/user-info
curl https://api.bitget.com/api/v3/p2p/user-info
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "uid": "1234567890", "nickName": "MerchantA", "accountLevel": "advanced", "completedOrderNum": "500", "positiveRate": "0.99", "completedOrderNum30D": "50", "completedRate30D": "0.98", "avgPayTime30D": "3", "avgReleaseTime30D": "5", "equityDetail": { "maxAdvSellNum": "5", "maxAdvSellLimit": "100000", "maxAdvBuyNum": "5", "maxAdvBuyLimit": "100000", "totalMaxPendingOrder": "20", "advMaxPendingOrder": "5" }, "registerTime": "1600000000000" } }
json
application/json

Get Currencies

GET
https://api.bitget.com
/api/v3/p2p/currencies

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of supported cryptocurrencies and fiat currencies for P2P trading, along with their precision, price limits, and available payment methods.

Get Currencies › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

Cryptocurrency list

​object[]

Fiat currency list

GET/api/v3/p2p/currencies
curl https://api.bitget.com/api/v3/p2p/currencies
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "tokenDetailList": [ { "token": "USDT", "precision": "2" } ], "fiatDetailList": [ { "fiat": "CNY", "precision": "2", "floatRateMin": "0.8", "floatRateMax": "1.2", "fixedRateMin": "6.5", "fixedRateMax": "8.5", "adMinLimit": "100", "adMaxLimit": "1000000", "payMethods": { "payMethodName": "Alipay", "iconUrl": "https://example.com/icon.png", "payMethodId": "1" }, "withdrawalLimit": { "withdrawLimitKey": "T+1", "withdrawLimitValue": "1" }, "payTimeLimit": [ 10, 20 ] } ] } }
json
application/json

Get Pay Methods

GET
https://api.bitget.com
/api/v3/p2p/pay-method

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the payment methods configured for the current merchant account. Use the returned IDs when creating or updating ads.

Get Pay Methods › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
payMethodId
​string

Payment method ID

payMethodName
​string

Payment method name

payMethodUserName
​string

Payee username

userPayMethodId
​string

User payment method ID

​object[]

Payment method info

GET/api/v3/p2p/pay-method
curl https://api.bitget.com/api/v3/p2p/pay-method
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": [ { "payMethodId": "1", "payMethodName": "Alipay", "payMethodUserName": "UserA", "userPayMethodId": "101", "payMethodInfo": [ { "name": "Account", "type": "txt", "value": "13800138000" } ] } ] }
json
application/json

P2P Order Management