P2P 广告管理

获取公开广告列表

GET

https://api.bitget.com

/api/v3/p2p/ad-list

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

获取P2P公开广告列表，仅返回上架状态的广告。

获取公开广告列表 › Request Parameters

token

string · required

加密货币，如 USDT、USDC

fiat

string · required

法币，如 CNY、USD

side

string · required

交易方向： buy 买入 sell 卖出

pageNum

string · required

页码，从1开始

limit

string · required

每页条数，最大 10

amount

string

交易金额，单位为法币，用于过滤可接单广告

获取公开广告列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

advId

string

广告ID

merchantId

string

广告商编号

merchantName

string

广告商名称

token

string

加密货币币种

fiat

string

法币币种

side

string

交易方向： buy 买入 sell 卖出

price

string

广告价格，单位为法币

minAmount

string

单笔最小交易额，单位为法币

maxAmount

string

单笔最大交易额，单位为法币

quantity

string

剩余可交易数量，单位为加密货币

object[]

支持的支付方式列表

completedOrderNum

string

累计完成订单数

completedRate

string

历史成交率

avgReleaseTime

string

平均放币时长，单位为分钟

createdTime

string

广告创建时间（ms时间戳）

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": "支付宝"
        }
      ],
      "completedOrderNum": "1200",
      "completedRate": "0.99",
      "avgReleaseTime": "5",
      "createdTime": "1740000000000"
    }
  ]
}

json

application/json

查询汇率

GET

https://api.bitget.com

/api/v3/p2p/exchange-rate

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

查询指定加密货币与法币的P2P实时汇率。

查询汇率 › Request Parameters

token

string · required

加密货币，如 USDT

fiat

string · required

法币，如 CNY

查询汇率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

rate

string

币对汇率

广告前置（手续费试算）

POST

https://api.bitget.com

/api/v3/p2p/fee-simulate

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

发布广告前预先计算手续费和税费。建议在创建广告前调用此接口以确认预期费用。

广告前置（手续费试算） › Request Parameters

token

string · required

加密货币，如 USDT

fiat

string · required

法币，如 CNY

side

string · required

交易方向： buy 买入 sell 卖出

marketType

string · required

市场类型： public 公开 private 私有

amount

string · required

发布广告数量，单位为加密货币

广告前置（手续费试算） › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

feeToken

string

手续费币种

feeAmount

string

手续费数量

taxToken

string

收税币种

taxAmount

string

收税数量

发布广告查询限额信息

GET

https://api.bitget.com

/api/v3/p2p/ad-limit

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

查询发布P2P广告的数量最小值和最大值限制。

发布广告查询限额信息 › Request Parameters

token

string · required

数字货币

fiat

string · required

法币

side

string · required

交易方向： buy 买入 sell 卖出

发布广告查询限额信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

buyMinTokenAmount

string

购买广告-数字币最小限额，单位为USDT

buyMaxTokenAmount

string

购买广告-数字币最大限额，单位为USDT

sellMinTokenAmount

string

出售广告-数字币最小限额，单位为USDT

sellMaxTokenAmount

string

出售广告-数字币最大限额，单位为USDT

创建广告

POST

https://api.bitget.com

/api/v3/p2p/ad-create

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

创建新的P2P广告。商家可设置固定价或浮动价、支付方式、数量限制及交易方要求。

创建广告 › Request Parameters

token

string · required

加密货币，如 USDT

fiat

string · required

法币，如 CNY

side

string · required

交易方向： buy 买入 sell 卖出

priceType

string · required

价格类型： fixed 固定价 floating 浮动价

minAmount

string · required

单笔最小交易额，单位为法币

maxAmount

string · required

单笔最大交易额，单位为法币

quantity

string · required

挂单总量，单位为加密货币

object[] · required

支付方式ID数组

payTimeLimit

string · required

付款期限，单位为分钟：5、10

price

string

固定单价 priceType=fixed 时必填

premium

string

溢价率 priceType=floating 时必填

remark

string

广告备注

tradeTerms

string

交易条款

创建广告 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

广告ID

更新广告

POST

https://api.bitget.com

/api/v3/p2p/ad-update

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

更新已有的P2P广告信息，仅传入的字段会被更新。

更新广告 › Request Parameters

advId

string · required

广告ID

payTimeLimit

string · required

付款期限，单位为分钟：5、10

priceType

string

价格类型： fixed 固定价 floating 浮动价

price

string

固定单价 priceType=fixed 时必填

premium

string

溢价率 priceType=floating 时必填

minAmount

string

单笔最小交易额，单位为法币

maxAmount

string

单笔最大交易额，单位为法币

quantity

string

挂单总量，单位为加密货币

object[]

支付方式ID数组

remark

string

广告备注

tradeTerms

string

交易条款

更新广告 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

变更广告状态

POST

https://api.bitget.com

/api/v3/p2p/ad-operate

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

变更P2P广告状态：上架、下架或移除。

变更广告状态 › Request Parameters

advId

string · required

广告ID

operation

string · required

操作： publish 上架 delist 下架 remove 移除

变更广告状态 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

获取广告详情

GET

https://api.bitget.com

/api/v3/p2p/ad-info

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

获取指定P2P广告的详细信息。

获取广告详情 › Request Parameters

advId

string · required

广告ID

获取广告详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

广告ID

side

string

交易方向： buy 买入 sell 卖出

priceType

string

价格类型： fixed 固定价 floating 浮动价

token

string

数字货币

fiat

string

法币

price

string

广告价格

amount

string

广告数量

minAmount

string

单笔最小交易额

maxAmount

string

单笔最大交易额

payDuration

string

付款时限，单位为分钟

soldAmount

string

已售出数量

lastAmount

string

剩余数量

premium

string

溢价率

turnover

string

成交量

remark

string

广告备注

tradeTerm

string

交易条款

object[]

支付方式ID数组

tokenPrecision

string

数字货币精度

fiatPrecision

string

法币精度

market

string

广告市场： public 公开 private 私有

avgTime

string

平均用时（出售为放币，购买为付款）

createdTime

string

广告创建时间

updatedTime

string

广告更新时间

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": "快速放币",
    "tradeTerm": "",
    "payMethodIds": [
      {
        "payMethodId": "1",
        "userPayMethodId": "101"
      }
    ],
    "tokenPrecision": "2",
    "fiatPrecision": "2",
    "market": "public",
    "avgTime": "5",
    "createdTime": "1740000000000",
    "updatedTime": "1740000001000"
  }
}

json

application/json

获取我的广告列表

GET

https://api.bitget.com

/api/v3/p2p/my-ads

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

获取当前商家账号发布的广告列表，支持按状态、时间范围、币种筛选以及游标分页。

获取我的广告列表 › Request Parameters

startTime

string

开始时间戳，Unix时间戳的毫秒数格式，如 1597026383085。最大查询范围90天，单次查询范围不超过30天

endTime

string

结束时间戳，Unix时间戳的毫秒数格式，如 1597026383085

limit

string

每页条目数，默认 10

cursor

string

游标ID，用于翻页。首次调用不传，后续调用传上次返回的 nextId

advId

string

广告ID

token

string

加密货币币种

fiat

string

法币币种

status

string

广告状态： publish 已上架 delist 已下架 remove 已删除。不传则默认返回全部状态

获取我的广告列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

数据集合

nextId

string

下一页标识ID

P2P 公共信息 P2P 订单管理

P2P

P2P 广告管理

获取公开广告列表

GET

https://api.bitget.com

/api/v3/p2p/ad-list

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

获取P2P公开广告列表，仅返回上架状态的广告。

获取公开广告列表 › Request Parameters

token

string · required

加密货币，如 USDT、USDC

fiat

string · required

法币，如 CNY、USD

side

string · required

交易方向： buy 买入 sell 卖出

pageNum

string · required

页码，从1开始

limit

string · required

每页条数，最大 10

amount

string

交易金额，单位为法币，用于过滤可接单广告

获取公开广告列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

advId

string

广告ID

merchantId

string

广告商编号

merchantName

string

广告商名称

token

string

加密货币币种

fiat

string

法币币种

side

string

交易方向： buy 买入 sell 卖出

price

string

广告价格，单位为法币

minAmount

string

单笔最小交易额，单位为法币

maxAmount

string

单笔最大交易额，单位为法币

quantity

string

剩余可交易数量，单位为加密货币

object[]

支持的支付方式列表

completedOrderNum

string

累计完成订单数

completedRate

string

历史成交率

avgReleaseTime

string

平均放币时长，单位为分钟

createdTime

string

广告创建时间（ms时间戳）

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": "支付宝"
        }
      ],
      "completedOrderNum": "1200",
      "completedRate": "0.99",
      "avgReleaseTime": "5",
      "createdTime": "1740000000000"
    }
  ]
}

json

application/json

查询汇率

GET

https://api.bitget.com

/api/v3/p2p/exchange-rate

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

查询指定加密货币与法币的P2P实时汇率。

查询汇率 › Request Parameters

token

string · required

加密货币，如 USDT

fiat

string · required

法币，如 CNY

查询汇率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

rate

string

币对汇率

广告前置（手续费试算）

POST

https://api.bitget.com

/api/v3/p2p/fee-simulate

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

发布广告前预先计算手续费和税费。建议在创建广告前调用此接口以确认预期费用。

广告前置（手续费试算） › Request Parameters

token

string · required

加密货币，如 USDT

fiat

string · required

法币，如 CNY

side

string · required

交易方向： buy 买入 sell 卖出

marketType

string · required

市场类型： public 公开 private 私有

amount

string · required

发布广告数量，单位为加密货币

广告前置（手续费试算） › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

feeToken

string

手续费币种

feeAmount

string

手续费数量

taxToken

string

收税币种

taxAmount

string

收税数量

发布广告查询限额信息

GET

https://api.bitget.com

/api/v3/p2p/ad-limit

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

查询发布P2P广告的数量最小值和最大值限制。

发布广告查询限额信息 › Request Parameters

token

string · required

数字货币

fiat

string · required

法币

side

string · required

交易方向： buy 买入 sell 卖出

发布广告查询限额信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

buyMinTokenAmount

string

购买广告-数字币最小限额，单位为USDT

buyMaxTokenAmount

string

购买广告-数字币最大限额，单位为USDT

sellMinTokenAmount

string

出售广告-数字币最小限额，单位为USDT

sellMaxTokenAmount

string

出售广告-数字币最大限额，单位为USDT

创建广告

POST

https://api.bitget.com

/api/v3/p2p/ad-create

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

创建新的P2P广告。商家可设置固定价或浮动价、支付方式、数量限制及交易方要求。

创建广告 › Request Parameters

token

string · required

加密货币，如 USDT

fiat

string · required

法币，如 CNY

side

string · required

交易方向： buy 买入 sell 卖出

priceType

string · required

价格类型： fixed 固定价 floating 浮动价

minAmount

string · required

单笔最小交易额，单位为法币

maxAmount

string · required

单笔最大交易额，单位为法币

quantity

string · required

挂单总量，单位为加密货币

object[] · required

支付方式ID数组

payTimeLimit

string · required

付款期限，单位为分钟：5、10

price

string

固定单价 priceType=fixed 时必填

premium

string

溢价率 priceType=floating 时必填

remark

string

广告备注

tradeTerms

string

交易条款

创建广告 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

广告ID

更新广告

POST

https://api.bitget.com

/api/v3/p2p/ad-update

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

更新已有的P2P广告信息，仅传入的字段会被更新。

更新广告 › Request Parameters

advId

string · required

广告ID

payTimeLimit

string · required

付款期限，单位为分钟：5、10

priceType

string

价格类型： fixed 固定价 floating 浮动价

price

string

固定单价 priceType=fixed 时必填

premium

string

溢价率 priceType=floating 时必填

minAmount

string

单笔最小交易额，单位为法币

maxAmount

string

单笔最大交易额，单位为法币

quantity

string

挂单总量，单位为加密货币

object[]

支付方式ID数组

remark

string

广告备注

tradeTerms

string

交易条款

更新广告 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

变更广告状态

POST

https://api.bitget.com

/api/v3/p2p/ad-operate

限频: 10次/秒/UID

权限: 统一账户P2P读写权限

变更P2P广告状态：上架、下架或移除。

变更广告状态 › Request Parameters

advId

string · required

广告ID

operation

string · required

操作： publish 上架 delist 下架 remove 移除

变更广告状态 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

操作结果

获取广告详情

GET

https://api.bitget.com

/api/v3/p2p/ad-info

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

获取指定P2P广告的详细信息。

获取广告详情 › Request Parameters

advId

string · required

广告ID

获取广告详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

advId

string

广告ID

side

string

交易方向： buy 买入 sell 卖出

priceType

string

价格类型： fixed 固定价 floating 浮动价

token

string

数字货币

fiat

string

法币

price

string

广告价格

amount

string

广告数量

minAmount

string

单笔最小交易额

maxAmount

string

单笔最大交易额

payDuration

string

付款时限，单位为分钟

soldAmount

string

已售出数量

lastAmount

string

剩余数量

premium

string

溢价率

turnover

string

成交量

remark

string

广告备注

tradeTerm

string

交易条款

object[]

支付方式ID数组

tokenPrecision

string

数字货币精度

fiatPrecision

string

法币精度

market

string

广告市场： public 公开 private 私有

avgTime

string

平均用时（出售为放币，购买为付款）

createdTime

string

广告创建时间

updatedTime

string

广告更新时间

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": "快速放币",
    "tradeTerm": "",
    "payMethodIds": [
      {
        "payMethodId": "1",
        "userPayMethodId": "101"
      }
    ],
    "tokenPrecision": "2",
    "fiatPrecision": "2",
    "market": "public",
    "avgTime": "5",
    "createdTime": "1740000000000",
    "updatedTime": "1740000001000"
  }
}

json

application/json

获取我的广告列表

GET

https://api.bitget.com

/api/v3/p2p/my-ads

限频: 10次/秒/UID

权限: 统一账户P2P只读权限

获取当前商家账号发布的广告列表，支持按状态、时间范围、币种筛选以及游标分页。

获取我的广告列表 › Request Parameters

startTime

string

开始时间戳，Unix时间戳的毫秒数格式，如 1597026383085。最大查询范围90天，单次查询范围不超过30天

endTime

string

结束时间戳，Unix时间戳的毫秒数格式，如 1597026383085

limit

string

每页条目数，默认 10

cursor

string

游标ID，用于翻页。首次调用不传，后续调用传上次返回的 nextId

advId

string

广告ID

token

string

加密货币币种

fiat

string

法币币种

status

string

广告状态： publish 已上架 delist 已下架 remove 已删除。不传则默认返回全部状态

获取我的广告列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

数据集合

nextId

string

下一页标识ID

P2P 公共信息 P2P 订单管理