P2P

经典账户 — P2P

获取p2p商家列表

GET

https://api.bitget.com

/api/v2/p2p/merchantList

限速规则 10次/1s (UID)

获取p2p商家列表

获取p2p商家列表 › Request Parameters

online

string

是否在线

yes在线

no不在线

idLessThan

string

上一次查询返回的minMerchantId，

返回ID小于该入参的数据

limit

string

查询条数

默认值为100

获取p2p商家列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

merchantList

string[]

商家列表

registerTime

string

注册时间

nickName

string

昵称

isOnline

string

是否在线

avgPaymentTime

string

平均支付时间

单位为分钟

avgReleaseTime

string

平均放币时间

单位为分钟

totalTrades

string

总交易订单数

totalBuy

string

总买单数

totalSell

string

总卖单数

totalCompletionRate

string

总成交率

trades30d

string

30日总成交数

sell30d

string

30日卖单数

buy30d

string

30日买单数

completionRate30d

string

30日成交率

minMerchantId

string

返回结果中的最小merchantId

商家查询自己信息

GET

https://api.bitget.com

/api/v2/p2p/merchantInfo

限速规则 10次/1s (UID)

商家查询自己信息

商家查询自己信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

registerTime

string

注册时间

nickName

string

昵称

merchantId

string

商家ID

kycStatus

string

是否KYC

yes

emailBindStatus

string

是否绑定email

yes

mobileBindStatus

string

是否绑定手机号

yes

email

string

邮箱

mobile

string

手机号

avgPaymentTime

string

平均支付时间, 单位为分钟

avgReleaseTime

string

平均放币时间, 单位为分钟

totalTrades

string

总交易订单数

totalBuy

string

总买单数

totalSell

string

总卖单数

totalCompletionRate

string

总成交率

trades30d

string

30日总成交数

sell30d

string

30日卖单数

buy30d

string

30日买单数

completionRate30d

string

30日成交率

获取p2p商家广告单列表

GET

https://api.bitget.com

/api/v2/p2p/advList

限速规则 10次/1s (UID)

获取p2p商家广告单列表

获取p2p商家广告单列表 › Request Parameters

startTime

string · required

查询开始时间 (仅限查询90天内数据)

status

string · required

广告单状态

online 上架

offline 下架

completed 完成

editing 编辑中

side

string · required

buy/sell

coin

string · required

币种，如USDT

fiat

string · required

法币

endTime

string

查询结束时间

idLessThan

string

上一次查询返回的minMerchantId，

返回ID小于该入参的数据

limit

string

查询条数

默认值为20 ，最大值为20

advNo

string

广告单号

language

string

zh-CN/en-US

orderBy

string

排序字段(desc)：createTime/price 默认createTime

payMethodId

string

支付方式id

sourceType

string

查询范围

owner:查询自己的广告单(默认)

competitior:查询其他商家的广告单

ownerAndCompetitior:查询所有广告单

获取p2p商家广告单列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

查询响应array

advId

string

advNo

string

广告单号

side

string

买/卖类型：sell/buy

advSize

string

广告单总数量

size

string

已成交数量

coin

string

币(BGB,USDT,BTC,ETH)

price

string

价格(USD, JPY, CNY)

coinPrecision

string

币的小数位

fiat

string

法币名称

fiatPrecision

string

法币小数位

fiatSymbol

string

法币符号

status

string

广告单状态

online 上架

offline 下架

completed 完成

editing 编辑中

hide

string

广告单是否隐藏: yes/no

maxTradeAmount

string

最大下单数量

minTradeAmount

string

最小下单数量

payDuration

string

下单后支付时间期限, min

turnoverNum

string

商户成单总数

turnoverRate

string

成交率

label

string

备注

ctime

string

创建时间, ms

utime

string

最新修改时间, ms

object

广告单限制：以下规则用户禁止下单

minCompleteNum

string

用户完成下单最小数量

maxCompleteNum

string

用户完成下单最大数量

placeOrderNum

string

用户在此广告单下最多可以下多少单

allowMerchantPlace

string

是否允许商家下单

completeRate30d

string

30日成交率

country

string

适用国家

object[]

支付方式列表

paymentMethod

string

支付名称

paymentId

string

支付ID

object[]

支付方式详情信息

required

boolean

是否必须: true/false

name

string

支付详细说明

type

string

支付方式详情信息类型

object[]

商家认证

imageUrl

string

金牌商家认证图片

desc

string

金牌商家认证描述

minAdvId

string

返回结果的最小advId

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

商家获取P2P订单

GET

https://api.bitget.com

/api/v2/p2p/orderList

限速规则 10次/1s (UID)

商家获取P2P订单

商家获取P2P订单 › Request Parameters

startTime

string

查询开始时间 (仅限查询90天内数据)

endTime

string

查询结束时间

idLessThan

string

上一次查询返回的minMerchantId，

返回ID小于该入参的数据

limit

string

查询条数

默认值为100

status

string

广告单状态

待付款:pending_pay

已付款待放币:paid

申诉中:appeal

已完成:completed

已取消:cancelled

advNo

string

广告单号

side

string

buy/sell

coin

string

币种，如USDT

language

string

zh-CN/en-US

fiat

string

法币

orderNo

string

订单号

商家获取P2P订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

查询响应array

orderId

string

orderNo

string

订单号

advNo

string

广告单号

side

string

买/卖类型：buy/sell

count

string

下单数量

coin

string

币

price

string

价格

fiat

string

法币名称

withdrawTime

string

本条订单资金提现时间

representTime

string

申诉时间

releaseTime

string

放币时间

paymentTime

string

付款时间

amount

string

下单金额

status

string

广告单状态

待付款:pending_pay

已付款待放币:paid

申诉中:appeal

已完成:completed

已取消:cancelled

buyerRealName

string

买家姓名

sellerRealName

string

卖家姓名

ctime

string

创建时间

utime

string

获取p2p商家列表 › Request Parameters

online

string

是否在线

yes在线

no不在线

idLessThan

string

上一次查询返回的minMerchantId，

返回ID小于该入参的数据

limit

string

查询条数

默认值为100

获取p2p商家列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

merchantList

string[]

商家列表

registerTime

string

注册时间

nickName

string

昵称

isOnline

string

是否在线

avgPaymentTime

string

平均支付时间

单位为分钟

avgReleaseTime

string

平均放币时间

单位为分钟

totalTrades

string

总交易订单数

totalBuy

string

总买单数

totalSell

string

总卖单数

totalCompletionRate

string

总成交率

trades30d

string

30日总成交数

sell30d

string

30日卖单数

buy30d

string

30日买单数

completionRate30d

string

30日成交率

minMerchantId

string

返回结果中的最小merchantId

商家查询自己信息

GET

https://api.bitget.com

/api/v2/p2p/merchantInfo

限速规则 10次/1s (UID)

商家查询自己信息

商家查询自己信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

registerTime

string

注册时间

nickName

string

昵称

merchantId

string

商家ID

kycStatus

string

是否KYC

yes

emailBindStatus

string

是否绑定email

yes

mobileBindStatus

string

是否绑定手机号

yes

email

string

邮箱

mobile

string

手机号

avgPaymentTime

string

平均支付时间, 单位为分钟

avgReleaseTime

string

平均放币时间, 单位为分钟

totalTrades

string

总交易订单数

totalBuy

string

总买单数

totalSell

string

总卖单数

totalCompletionRate

string

总成交率

trades30d

string

30日总成交数

sell30d

string

30日卖单数

buy30d

string

30日买单数

completionRate30d

string

30日成交率

获取p2p商家广告单列表

GET

https://api.bitget.com

/api/v2/p2p/advList

限速规则 10次/1s (UID)

获取p2p商家广告单列表

获取p2p商家广告单列表 › Request Parameters

startTime

string · required

查询开始时间 (仅限查询90天内数据)

status

string · required

广告单状态

online 上架

offline 下架

completed 完成

editing 编辑中

side

string · required

buy/sell

coin

string · required

币种，如USDT

fiat

string · required

法币

endTime

string

查询结束时间

idLessThan

string

上一次查询返回的minMerchantId，

返回ID小于该入参的数据

limit

string

查询条数

默认值为20 ，最大值为20

advNo

string

广告单号

language

string

zh-CN/en-US

orderBy

string

排序字段(desc)：createTime/price 默认createTime

payMethodId

string

支付方式id

sourceType

string

查询范围

owner:查询自己的广告单(默认)

competitior:查询其他商家的广告单

ownerAndCompetitior:查询所有广告单

获取p2p商家广告单列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

查询响应array

advId

string

advNo

string

广告单号

side

string

买/卖类型：sell/buy

advSize

string

广告单总数量

size

string

已成交数量

coin

string

币(BGB,USDT,BTC,ETH)

price

string

价格(USD, JPY, CNY)

coinPrecision

string

币的小数位

fiat

string

法币名称

fiatPrecision

string

法币小数位

fiatSymbol

string

法币符号

status

string

广告单状态

online 上架

offline 下架

completed 完成

editing 编辑中

hide

string

广告单是否隐藏: yes/no

maxTradeAmount

string

最大下单数量

minTradeAmount

string

最小下单数量

payDuration

string

下单后支付时间期限, min

turnoverNum

string

商户成单总数

turnoverRate

string

成交率

label

string

备注

ctime

string

创建时间, ms

utime

string

最新修改时间, ms

object

广告单限制：以下规则用户禁止下单

minCompleteNum

string

用户完成下单最小数量

maxCompleteNum

string

用户完成下单最大数量

placeOrderNum

string

用户在此广告单下最多可以下多少单

allowMerchantPlace

string

是否允许商家下单

completeRate30d

string

30日成交率

country

string

适用国家

object[]

支付方式列表

paymentMethod

string

支付名称

paymentId

string

支付ID

object[]

支付方式详情信息

required

boolean

是否必须: true/false

name

string

支付详细说明

type

string

支付方式详情信息类型

object[]

商家认证

imageUrl

string

金牌商家认证图片

desc

string

金牌商家认证描述

minAdvId

string

返回结果的最小advId

商家获取P2P订单

GET

https://api.bitget.com

/api/v2/p2p/orderList

限速规则 10次/1s (UID)

商家获取P2P订单

商家获取P2P订单 › Request Parameters

startTime

string

查询开始时间 (仅限查询90天内数据)

endTime

string

查询结束时间

idLessThan

string

上一次查询返回的minMerchantId，

返回ID小于该入参的数据

limit

string

查询条数

默认值为100

status

string

广告单状态

待付款:pending_pay

已付款待放币:paid

申诉中:appeal

已完成:completed

已取消:cancelled

advNo

string

广告单号

side

string

buy/sell

coin

string

币种，如USDT

language

string

zh-CN/en-US

fiat

string

法币

orderNo

string

订单号

商家获取P2P订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

查询响应array

orderId

string

orderNo

string

订单号

advNo

string

广告单号

side

string

买/卖类型：buy/sell

count

string

下单数量

coin

string

币

price

string

价格

fiat

string

法币名称

withdrawTime

string

本条订单资金提现时间

representTime

string

申诉时间

releaseTime

string

放币时间

paymentTime

string

付款时间

amount

string

下单金额

status

string

广告单状态

待付款:pending_pay

已付款待放币:paid

申诉中:appeal

已完成:completed

已取消:cancelled

buyerRealName

string

买家姓名

sellerRealName

string

卖家姓名

ctime

string

创建时间

utime

string