Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
P2P
    P2P 公共信息
      查询当前账户余额get
    P2P 广告管理
      获取公开广告列表get查询汇率get广告前置(手续费试算)post发布广告查询限额信息get创建广告post更新广告post变更广告状态post获取广告详情get获取我的广告列表get
    P2P 订单管理
      获取进行中订单get获取全部订单get获取订单详情get标记订单已付款(确认付款)post释放资产(确认放币)post
    P2P 账户管理
      获取当前商家账户信息get获取支持交易的法币/数字币信息get获取当前账户支付方式get
P2P
P2P

P2P 账户管理

P2P 账户管理


获取当前商家账户信息

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

限频: 10次/秒/UID

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

获取当前商家的P2P账户信息,包括账户等级、交易统计数据和发布权益限制。

获取当前商家账户信息 › Response Parameters

200

Successful response

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

账户ID

nickName
​string

昵称

accountLevel
​string

账户等级: starter 普通用户 advanced 进阶商家 master 顶级商家

completedOrderNum
​string

交易总订单数

positiveRate
​string

好评率,小数形式,如0.99代表99%

completedOrderNum30D
​string

30日成单

completedRate30D
​string

30日成单率

avgPayTime30D
​string

30日平均付款时长,单位为分钟

avgReleaseTime30D
​string

30日平均放币时长,单位为分钟

​object

权益详情

registerTime
​string

注册时间,Unix毫秒时间戳

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
https://api.bitget.com
/api/v3/p2p/currencies

限频: 10次/秒/UID

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

获取P2P交易支持的加密货币和法币列表,以及精度、价格限制和可用支付方式。

获取支持交易的法币/数字币信息 › Response Parameters

200

Successful response

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

数字币列表

​object[]

法币列表

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": "支付宝", "iconUrl": "https://example.com/icon.png", "payMethodId": "1" }, "withdrawalLimit": { "withdrawLimitKey": "T+1", "withdrawLimitValue": "1" }, "payTimeLimit": [ 10, 20 ] } ] } }
json
application/json

获取当前账户支付方式

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

限频: 10次/秒/UID

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

获取当前商家账号配置的支付方式,创建或更新广告时使用返回的ID。

获取当前账户支付方式 › Response Parameters

200

Successful response

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

支付方式ID

payMethodName
​string

支付方式名称

payMethodUserName
​string

收款方用户名称

userPayMethodId
​string

用户支付方式ID

​object[]

支付方式信息

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": "支付宝", "payMethodUserName": "UserA", "userPayMethodId": "101", "payMethodInfo": [ { "name": "账号", "type": "txt", "value": "13800138000" } ] } ] }
json
application/json

P2P 订单管理