P2P Ad Management

Get Ad List

GET

https://api.bitget.com

/api/v3/p2p/ad-list

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of public P2P advertisements. Only ads in the published (on-shelf) status are returned.

Get Ad List › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT, USDC

fiat

string · required

Fiat currency, e.g. CNY, USD

side

string · required

Trade direction: buy buy sell sell

pageNum

string · required

Page number, starting from 1.

limit

string · required

Number of items per page. Maximum: 10

amount

string

Trade amount in fiat currency, used to filter eligible ads

Get Ad List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

advId

string

Ad ID

merchantId

string

Merchant ID

merchantName

string

Merchant name

token

string

Cryptocurrency

fiat

string

Fiat currency

side

string

Trade direction: buy buy sell sell

price

string

Ad price in fiat currency

minAmount

string

Minimum trade amount per order in fiat currency

maxAmount

string

Maximum trade amount per order in fiat currency

quantity

string

Remaining tradable quantity in cryptocurrency

object[]

Supported payment methods

completedOrderNum

string

Total completed orders

completedRate

string

Historical completion rate

avgReleaseTime

string

Average coin release time in minutes

createdTime

string

Ad creation time (ms timestamp)

GET/api/v3/p2p/ad-list

curl 'https://api.bitget.com/api/v3/p2p/ad-list?token=<string>&fiat=<string>&side=<string>&pageNum=<string>&limit=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": [
    {
      "advId": "1234567890",
      "merchantId": "9876543210",
      "merchantName": "MerchantA",
      "token": "USDT",
      "fiat": "CNY",
      "side": "buy",
      "price": "7.28",
      "minAmount": "100",
      "maxAmount": "10000",
      "quantity": "500",
      "payMethods": [
        {
          "payMethodId": "1",
          "payMethodName": "Alipay"
        }
      ],
      "completedOrderNum": "1200",
      "completedRate": "0.99",
      "avgReleaseTime": "5",
      "createdTime": "1740000000000"
    }
  ]
}

json

application/json

Get Exchange Rate

GET

https://api.bitget.com

/api/v3/p2p/exchange-rate

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the current P2P exchange rate for a cryptocurrency/fiat currency pair.

Get Exchange Rate › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT

fiat

string · required

Fiat currency, e.g. CNY

Get Exchange Rate › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

rate

string

Exchange rate of the currency pair

Fee Simulate

POST

https://api.bitget.com

/api/v3/p2p/fee-simulate

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Pre-calculate the fee and tax for publishing a P2P advertisement. Use this endpoint before creating an ad to confirm the expected fee details.

Fee Simulate › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT

fiat

string · required

Fiat currency, e.g. CNY

side

string · required

Trade direction: buy buy sell sell

marketType

string · required

Market type: public public private private

amount

string · required

Ad quantity in cryptocurrency

Fee Simulate › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

feeToken

string

Fee currency

feeAmount

string

Fee amount

taxToken

string

Tax currency

taxAmount

string

Tax amount

Get Ad Limit

GET

https://api.bitget.com

/api/v3/p2p/ad-limit

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the minimum and maximum quantity limits for publishing a P2P advertisement.

Get Ad Limit › Request Parameters

token

string · required

Cryptocurrency

fiat

string · required

Fiat currency

side

string · required

Trade direction: buy buy sell sell

Get Ad Limit › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

buyMinTokenAmount

string

Buy ad - minimum cryptocurrency amount, in USDT

buyMaxTokenAmount

string

Buy ad - maximum cryptocurrency amount, in USDT

sellMinTokenAmount

string

Sell ad - minimum cryptocurrency amount, in USDT

sellMaxTokenAmount

string

Sell ad - maximum cryptocurrency amount, in USDT

Create Ad

POST

https://api.bitget.com

/api/v3/p2p/ad-create

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Create a new P2P advertisement. Merchants can set fixed or floating price, payment methods, quantity limits, and trader requirements.

Create Ad › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT

fiat

string · required

Fiat currency, e.g. CNY

side

string · required

Trade direction: buy buy sell sell

priceType

string · required

Price type: fixed fixed price floating floating price

minAmount

string · required

Minimum trade amount per order in fiat currency

maxAmount

string · required

Maximum trade amount per order in fiat currency

quantity

string · required

Total ad quantity in cryptocurrency

object[] · required

Payment method ID array

payTimeLimit

string · required

Payment time limit in minutes: 5, 10

price

string

Fixed unit price Required when priceType=fixed

premium

string

Premium rate Required when priceType=floating

remark

string

Ad remarks

tradeTerms

string

Trade terms

Create Ad › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

Ad ID

Update Ad

POST

https://api.bitget.com

/api/v3/p2p/ad-update

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Update an existing P2P advertisement. Only the fields provided will be updated.

Update Ad › Request Parameters

advId

string · required

Ad ID

payTimeLimit

string · required

Payment time limit in minutes: 5, 10

priceType

string

Price type: fixed fixed price floating floating price

price

string

Fixed unit price Required when priceType=fixed

premium

string

Premium rate Required when priceType=floating

minAmount

string

Minimum trade amount per order in fiat currency

maxAmount

string

Maximum trade amount per order in fiat currency

quantity

string

Total ad quantity in cryptocurrency

object[]

Payment method ID array

remark

string

Ad remarks

tradeTerms

string

Trade terms

Update Ad › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result of the operation

Operate Ad

POST

https://api.bitget.com

/api/v3/p2p/ad-operate

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Change the status of a P2P advertisement: publish (on-shelf), delist (off-shelf), or remove.

Operate Ad › Request Parameters

advId

string · required

Ad ID

operation

string · required

Operation: publish publish (on-shelf) delist delist (off-shelf) remove remove

Operate Ad › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result of the operation

Get Ad Info

GET

https://api.bitget.com

/api/v3/p2p/ad-info

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get detailed information for a specific P2P advertisement.

Get Ad Info › Request Parameters

advId

string · required

Ad ID

Get Ad Info › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

Ad ID

side

string

Trade direction: buy buy sell sell

priceType

string

Price type: fixed fixed price floating floating price

token

string

Cryptocurrency

fiat

string

Fiat currency

price

string

Ad price

amount

string

Ad quantity

minAmount

string

Minimum trade amount per order

maxAmount

string

Maximum trade amount per order

payDuration

string

Payment time limit in minutes

soldAmount

string

Sold quantity

lastAmount

string

Remaining quantity

premium

string

Premium rate

turnover

string

Turnover

remark

string

Ad remarks

tradeTerm

string

Trade terms

object[]

Payment method ID array

tokenPrecision

string

Cryptocurrency decimal precision

fiatPrecision

string

Fiat currency decimal precision

market

string

Ad market: public public private private

avgTime

string

Average processing time (release time for sell / payment time for buy)

createdTime

string

Ad creation time

updatedTime

string

Ad last update time

GET/api/v3/p2p/ad-info

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

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "advId": "1234567890",
    "side": "sell",
    "priceType": "fixed",
    "token": "USDT",
    "fiat": "CNY",
    "price": "7.28",
    "amount": "1000",
    "minAmount": "100",
    "maxAmount": "10000",
    "payDuration": "15",
    "soldAmount": "300",
    "lastAmount": "700",
    "premium": "",
    "turnover": "2184",
    "remark": "Fast release",
    "tradeTerm": "",
    "payMethodIds": [
      {
        "payMethodId": "1",
        "userPayMethodId": "101"
      }
    ],
    "tokenPrecision": "2",
    "fiatPrecision": "2",
    "market": "public",
    "avgTime": "5",
    "createdTime": "1740000000000",
    "updatedTime": "1740000001000"
  }
}

json

application/json

Get My Ads

GET

https://api.bitget.com

/api/v3/p2p/my-ads

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of advertisements created by the current merchant account, with support for filtering by status, time range, currency, and pagination via cursor.

Get My Ads › 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

advId

string

Ad ID

token

string

Cryptocurrency

fiat

string

Fiat currency

status

string

Ad status: publish on-shelf delist off-shelf remove removed. Returns all statuses if not provided

Get My Ads › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Data list

nextId

string

Next page cursor ID

P2P Common P2P Order Management

P2P

P2P Ad Management

Get Ad List

GET

https://api.bitget.com

/api/v3/p2p/ad-list

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of public P2P advertisements. Only ads in the published (on-shelf) status are returned.

Get Ad List › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT, USDC

fiat

string · required

Fiat currency, e.g. CNY, USD

side

string · required

Trade direction: buy buy sell sell

pageNum

string · required

Page number, starting from 1.

limit

string · required

Number of items per page. Maximum: 10

amount

string

Trade amount in fiat currency, used to filter eligible ads

Get Ad List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

advId

string

Ad ID

merchantId

string

Merchant ID

merchantName

string

Merchant name

token

string

Cryptocurrency

fiat

string

Fiat currency

side

string

Trade direction: buy buy sell sell

price

string

Ad price in fiat currency

minAmount

string

Minimum trade amount per order in fiat currency

maxAmount

string

Maximum trade amount per order in fiat currency

quantity

string

Remaining tradable quantity in cryptocurrency

object[]

Supported payment methods

completedOrderNum

string

Total completed orders

completedRate

string

Historical completion rate

avgReleaseTime

string

Average coin release time in minutes

createdTime

string

Ad creation time (ms timestamp)

GET/api/v3/p2p/ad-list

curl 'https://api.bitget.com/api/v3/p2p/ad-list?token=<string>&fiat=<string>&side=<string>&pageNum=<string>&limit=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": [
    {
      "advId": "1234567890",
      "merchantId": "9876543210",
      "merchantName": "MerchantA",
      "token": "USDT",
      "fiat": "CNY",
      "side": "buy",
      "price": "7.28",
      "minAmount": "100",
      "maxAmount": "10000",
      "quantity": "500",
      "payMethods": [
        {
          "payMethodId": "1",
          "payMethodName": "Alipay"
        }
      ],
      "completedOrderNum": "1200",
      "completedRate": "0.99",
      "avgReleaseTime": "5",
      "createdTime": "1740000000000"
    }
  ]
}

json

application/json

Get Exchange Rate

GET

https://api.bitget.com

/api/v3/p2p/exchange-rate

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the current P2P exchange rate for a cryptocurrency/fiat currency pair.

Get Exchange Rate › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT

fiat

string · required

Fiat currency, e.g. CNY

Get Exchange Rate › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

rate

string

Exchange rate of the currency pair

Fee Simulate

POST

https://api.bitget.com

/api/v3/p2p/fee-simulate

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Pre-calculate the fee and tax for publishing a P2P advertisement. Use this endpoint before creating an ad to confirm the expected fee details.

Fee Simulate › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT

fiat

string · required

Fiat currency, e.g. CNY

side

string · required

Trade direction: buy buy sell sell

marketType

string · required

Market type: public public private private

amount

string · required

Ad quantity in cryptocurrency

Fee Simulate › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

feeToken

string

Fee currency

feeAmount

string

Fee amount

taxToken

string

Tax currency

taxAmount

string

Tax amount

Get Ad Limit

GET

https://api.bitget.com

/api/v3/p2p/ad-limit

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the minimum and maximum quantity limits for publishing a P2P advertisement.

Get Ad Limit › Request Parameters

token

string · required

Cryptocurrency

fiat

string · required

Fiat currency

side

string · required

Trade direction: buy buy sell sell

Get Ad Limit › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

buyMinTokenAmount

string

Buy ad - minimum cryptocurrency amount, in USDT

buyMaxTokenAmount

string

Buy ad - maximum cryptocurrency amount, in USDT

sellMinTokenAmount

string

Sell ad - minimum cryptocurrency amount, in USDT

sellMaxTokenAmount

string

Sell ad - maximum cryptocurrency amount, in USDT

Create Ad

POST

https://api.bitget.com

/api/v3/p2p/ad-create

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Create a new P2P advertisement. Merchants can set fixed or floating price, payment methods, quantity limits, and trader requirements.

Create Ad › Request Parameters

token

string · required

Cryptocurrency, e.g. USDT

fiat

string · required

Fiat currency, e.g. CNY

side

string · required

Trade direction: buy buy sell sell

priceType

string · required

Price type: fixed fixed price floating floating price

minAmount

string · required

Minimum trade amount per order in fiat currency

maxAmount

string · required

Maximum trade amount per order in fiat currency

quantity

string · required

Total ad quantity in cryptocurrency

object[] · required

Payment method ID array

payTimeLimit

string · required

Payment time limit in minutes: 5, 10

price

string

Fixed unit price Required when priceType=fixed

premium

string

Premium rate Required when priceType=floating

remark

string

Ad remarks

tradeTerms

string

Trade terms

Create Ad › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

Ad ID

Update Ad

POST

https://api.bitget.com

/api/v3/p2p/ad-update

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Update an existing P2P advertisement. Only the fields provided will be updated.

Update Ad › Request Parameters

advId

string · required

Ad ID

payTimeLimit

string · required

Payment time limit in minutes: 5, 10

priceType

string

Price type: fixed fixed price floating floating price

price

string

Fixed unit price Required when priceType=fixed

premium

string

Premium rate Required when priceType=floating

minAmount

string

Minimum trade amount per order in fiat currency

maxAmount

string

Maximum trade amount per order in fiat currency

quantity

string

Total ad quantity in cryptocurrency

object[]

Payment method ID array

remark

string

Ad remarks

tradeTerms

string

Trade terms

Update Ad › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result of the operation

Operate Ad

POST

https://api.bitget.com

/api/v3/p2p/ad-operate

Rate limit: 10/sec/UID

Permission: UTA P2P (read and write)

Change the status of a P2P advertisement: publish (on-shelf), delist (off-shelf), or remove.

Operate Ad › Request Parameters

advId

string · required

Ad ID

operation

string · required

Operation: publish publish (on-shelf) delist delist (off-shelf) remove remove

Operate Ad › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result of the operation

Get Ad Info

GET

https://api.bitget.com

/api/v3/p2p/ad-info

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get detailed information for a specific P2P advertisement.

Get Ad Info › Request Parameters

advId

string · required

Ad ID

Get Ad Info › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

Ad ID

side

string

Trade direction: buy buy sell sell

priceType

string

Price type: fixed fixed price floating floating price

token

string

Cryptocurrency

fiat

string

Fiat currency

price

string

Ad price

amount

string

Ad quantity

minAmount

string

Minimum trade amount per order

maxAmount

string

Maximum trade amount per order

payDuration

string

Payment time limit in minutes

soldAmount

string

Sold quantity

lastAmount

string

Remaining quantity

premium

string

Premium rate

turnover

string

Turnover

remark

string

Ad remarks

tradeTerm

string

Trade terms

object[]

Payment method ID array

tokenPrecision

string

Cryptocurrency decimal precision

fiatPrecision

string

Fiat currency decimal precision

market

string

Ad market: public public private private

avgTime

string

Average processing time (release time for sell / payment time for buy)

createdTime

string

Ad creation time

updatedTime

string

Ad last update time

GET/api/v3/p2p/ad-info

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

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "advId": "1234567890",
    "side": "sell",
    "priceType": "fixed",
    "token": "USDT",
    "fiat": "CNY",
    "price": "7.28",
    "amount": "1000",
    "minAmount": "100",
    "maxAmount": "10000",
    "payDuration": "15",
    "soldAmount": "300",
    "lastAmount": "700",
    "premium": "",
    "turnover": "2184",
    "remark": "Fast release",
    "tradeTerm": "",
    "payMethodIds": [
      {
        "payMethodId": "1",
        "userPayMethodId": "101"
      }
    ],
    "tokenPrecision": "2",
    "fiatPrecision": "2",
    "market": "public",
    "avgTime": "5",
    "createdTime": "1740000000000",
    "updatedTime": "1740000001000"
  }
}

json

application/json

Get My Ads

GET

https://api.bitget.com

/api/v3/p2p/my-ads

Rate limit: 10/sec/UID

Permission: UTA P2P (read)

Get the list of advertisements created by the current merchant account, with support for filtering by status, time range, currency, and pagination via cursor.

Get My Ads › 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

advId

string

Ad ID

token

string

Cryptocurrency

fiat

string

Fiat currency

status

string

Ad status: publish on-shelf delist off-shelf remove removed. Returns all statuses if not provided

Get My Ads › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Data list

nextId

string

Next page cursor ID

P2P Common P2P Order Management