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 no

emailBindStatus

string

是否绑定email yes no

mobileBindStatus

string

是否绑定手机号 yes no

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

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

minOrderId

string

返回记录的最小orderId

GET/api/v2/p2p/orderList

curl https://api.bitget.com/api/v2/p2p/orderList

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1681201761390,
  "data": {
    "orderList": [
      {
        "orderId": "1",
        "orderNo": "1",
        "advNo": "1",
        "price": "1",
        "count": "11",
        "side": "buy",
        "fiat": "USD",
        "coin": "USDT",
        "withdrawTime": "",
        "representTime": "",
        "paymentTime": "",
        "releaseTime": "",
        "amount": "11",
        "buyerRealName": "",
        "sellerRealName": "兰州",
        "status": "cancelled",
        "paymentInfo": {
          "paymethodName": "paypal",
          "paymethodId": "3",
          "paymethodInfo": [
            {
              "name": "繁体中文",
              "required": "yes",
              "type": "number",
              "value": "11****"
            },
            {
              "name": "繁体中文",
              "required": "yes",
              "type": "file",
              "value": "http://qrc.bitgetapp.com/otc/images/20230116/498ab1b8-3ba6-44bd-9570-b3e5c118233f.jpg"
            }
          ]
        },
        "utime": "1696732368875",
        "ctime": "1681111722251"
      }
    ],
    "minOrderId": "1"
  }
}

json

application/json

获取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 no

emailBindStatus

string

是否绑定email yes no

mobileBindStatus

string

是否绑定手机号 yes no

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

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

minOrderId

string

返回记录的最小orderId