CoinEx P2P API接口規則文檔

Customer Specialist Team

發佈於2025-07-10

更新於2025-07-10

為滿足不同使用者的交易需求，CoinEx站內已支援P2P API相關功能，詳見以下說明。

一、CoinEx P2P API 使用說明

1、API支援的客戶

任何完成了P2P商家驗證的站內用戶，若您尚未擁有商家身份，需先前往頁面完成P2P商家申請。

2、執行效率與內容

透過API進行操作的用戶，資訊取得與請求執行效率與頁面內無差別，回傳內容因欄位限製而刪減。

3、API支援目錄

P2P店舖營業狀態管理
P2P廣告管理
P2P用戶廣告列表
P2P市場廣告列表
P2P訂單列表
P2P廣告價格修改
P2P市場深度數據

二、P2P API 介面文檔

使用前，需造訪CoinEx公共API進行認證操作。

1、P2P店舖營業狀態管理

接口信息

URL路徑：/v2/p2p/exchange-status
請求方法：POST
介面描述：設定P2P店舖的營業狀態（開啟或關閉）
權限要求：需要認證

請求參數

請求體

參數名	必填	類型	描述
status	是	String	店鋪狀態，可選值：OPEN（開啟）或CLOSED（關閉）

請求範例

POST /v2/p2p/exchange-status HTTP/1.1
Host: api.coinex.com
Content-Type: application/json
{
  "status": "OPEN"
}

響應參數

參數名	類型	描述
status	String	設定後的店鋪狀態，OPEN或CLOSED

響應範例

{
  "code": 0,
  "message": "OK",
  "data": {
    "status": "OPEN"
  }
}

2、P2P廣告管理

接口信息

URL路徑：/v2/p2p/manage-ads
請求方法：POST
介面描述：大量管理P2P廣告（上線或下線）
權限要求：需要認證

請求參數

請求體

參數名	必填	類型	描述
status	是	String	操作類型，可選值：ONLINE（上线）或OFFLINE（下线）
ad_ids	否	Array[String]	廣告ID列表，不傳則操作所有符合條件的廣告

請求範例

POST /v2/p2p/manage-ads HTTP/1.1
Host: api.coinex.com
Content-Type: application/json
{
  "status": "ONLINE",
  "ad_ids": ["5f7c8b9d1a2b3c4d5e6f7g8h", "5f7c8b9d1a2b3c4d5e6f7g9i"]
}

響應參數

參數名	類型	描述
affected_ad_ids	Array[String]	成功操作的廣告ID列表

響應範例

{
  "code": 0,
  "message": "OK",
  "data": {
    "affected_ad_ids": ["5f7c8b9d1a2b3c4d5e6f7g8h", "5f7c8b9d1a2b3c4d5e6f7g9i"]
  }
}

3、P2P用戶廣告列表

接口信息

URL路徑：/v2/p2p/ads
請求方法：GET
介面描述：取得目前使用者的所有廣告列表
權限要求：需要認證

請求參數

無

請求範例

GET /v2/p2p/ads HTTP/1.1
Host: api.coinex.com

響應參數

傳回廣告物件數組，每個廣告物件包含以下欄位：

參數名	類型	描述
ad_id	String	廣告ID
created_at	Number	創建時間（毫秒時間戳記）
updated_at	Number	更新時間（毫秒時間戳記）
ad_number	String	廣告編號
ad_side	String	廣告方向，買（買入）或賣（賣）
base_ccy	String	基礎貨幣
quote_ccy	String	計價貨幣
price	String	價格
available_amount	String	可用數量
quote_min_limit	String	最小交易限額（計價貨幣）
quote_max_limit	String	最大交易限額（計價貨幣）
status	String	廣告狀態，可選值：ONLINE（上線）或OFFLINE（下線）

響應範例

{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
      "created_at": 1618456789000,
      "updated_at": 1618456789000,
      "ad_number": "AD123456789",
      "ad_side": "BUY",
      "base_ccy": "BTC",
      "quote_ccy": "CNY",
      "price": "200000",
      "available_amount": "0.5",
      "quote_min_limit": "500",
      "quote_max_limit": "50000",
      "status": "ONLINE"
    },
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g9i",
      "created_at": 1618456790000,
      "updated_at": 1618456790000,
      "ad_number": "AD123456790",
      "ad_side": "SELL",
      "base_ccy": "ETH",
      "quote_ccy": "CNY",
      "price": "10000",
      "available_amount": "5",
      "quote_min_limit": "200",
      "quote_max_limit": "20000",
      "status": "OFFLINE"
    }
  ]
}

4、P2P市場廣告列表

接口信息

URL路徑：/v2/p2p/market/ads
請求方法：GET
介面描述：取得P2P市場廣告列表
權限要求：不需要認證

請求參數

查詢參數

參數名	必填	類型	描述
base_ccy	是	String	基礎貨幣
quote_ccy	是	String	計價貨幣
order_side	是	String	訂單方向，訂單方向與廣告方向相反，取值為BUY或SELL
target_quote_amount	否	Decimal	目標交易金額（計價貨幣）
sort_by	否	String	排序字段，預設為PRICE，可選 COMPLETION_RATE（完單率）DEAL_COUNT（成交數）ACCEPTANCE_RATE（接單率）
sort_type	否	String	排序方式，ASC（升序）或DESC（降序），預設為ASC
page	否	Integer	頁碼，預設為1
limit	否	Integer	每頁數量，預設為10

請求範例

GET /v2/p2p/market/ads?base_ccy=BTC&quote_ccy=CNY&order_side=BUY&page=1&limit=10 HTTP/1.1
Host: api.coinex.com

響應參數

參數名	類型	描述
data	Array	廣告列表，每個元素結構同用戶廣告列表
pagination	Object	分頁訊息
pagination.total	Integer	總記錄數
pagination.has_next	Boolean	是否有下一頁

響應範例

{
  "code": 0,
  "message": "OK",
  "data": [
        {
            "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
            "created_at": 1618456789000,
            "updated_at": 1618456789000,
            "ad_number": "AD123456789",
            "ad_side": "BUY",
            "base_ccy": "BTC",
            "quote_ccy": "CNY",
            "price": "200000",
            "available_amount": "0.5",
            "quote_min_limit": "500",
            "quote_max_limit": "50000",
            "status": "ONLINE"
        },
    ],
    "pagination": {
      "total": 50,
      "has_next": true
    }
}

5、P2P訂單列表

接口信息

URL路徑：/v2/p2p/order
請求方法：GET
介面描述：取得用戶P2P訂單列表
權限要求：需要認證

請求參數

查詢參數

參數名	必填	類型	描述
start_time	否	Number	開始時間（毫秒時間戳記）
end_time	否	Number	結束時間（毫秒時間戳記）
ad_side	否	String	廣告方向，BUY或SELL
quote_ccy	否	String	計價貨幣
status	否	string	訂單狀態
page	否	Integer	頁碼，預設為1
limit	否	Integer	每頁數量，預設為10

請求範例

GET /v2/p2p/order?start_time=1618456789000&end_time=1618556789000&status=CREATED&page=1&limit=10 HTTP/1.1
Host: api.coinex.com

響應參數

參數名	類型	描述
data	Array	訂單列表
pagination	Object	分頁訊息
pagination.total	Integer	總記錄數
pagination.has_next	Boolean	是否有下一頁

訂單對象包含以下字段：

參數名	類型	描述
order_id	Integer	訂單ID
order_num	String	訂單編號
ad_id	String	廣告ID
status	String	訂單狀態，可選值：CREATED（待接單）、CONFIRMED（待付款）、PAID（已付款）、FINISHED（已完成）、CANCELED（已取消）
created_at	Number	創建時間（毫秒時間戳記）
finished_at	Number	完成時間（毫秒時間戳記）
confirm_due_at	Number	確認截止時間（毫秒時間戳記）
payment_due_at	Number	付款截止時間（毫秒時間戳記）
order_side	String	訂單方向，BUY或SELL
price	String	價格
base_ccy	String	基礎貨幣
base_ccy_amount	String	基礎貨幣數量
quote_ccy	String	計價貨幣
quote_ccy_amount	String	計價貨幣數量
cancel_type	String	取消類型，選用值：CONFIRM_TIMEOUT（商家逾時未確認）、MERCHANT_CREATED_CANCEL（商家拒絕接單）、CUSTOMER_CREATED_CANCEL（用戶接單前取消）、PAY_TIMEOUT（買方逾時未付款）、BUYER_CANCEL（買方取消）、SERVICE_CANCEL（客服手動取消）、SYSTEM_CANCEL（系統取消）

響應範例

{
  "code": 0,
  "message": "OK",
  "data": [
      {
        "order_id": 12345,
        "order_num": "P2P123456789",
        "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
        "status": "FINISHED",
        "created_at": 1618456789000,
        "finished_at": 1618466789000,
        "confirm_due_at": 1618476789000,
        "payment_due_at": 1618486789000,
        "order_side": "BUY",
        "price": "200000",
        "base_ccy": "BTC",
        "base_ccy_amount": "0.1",
        "quote_ccy": "CNY",
        "quote_ccy_amount": "20000",
        "cancel_type": ""
      },
    ],
    "pagination": {
      "total": 25,
      "has_next": true
    }
}

6、P2P廣告價格修改

接口信息

URL路徑：/v2/p2p/modify-ads
請求方法：POST
介面描述：大量修改P2P廣告價格
權限要求：需要認證

請求參數

請求體

參數名	必填	類型	描述
ads	是	Array	廣告修改訊息數組

ads數組中的每個元素包含以下欄位：

參數名	必填	類型	描述
ad_id	是	String	廣告ID
price	是	Decimal	新價格

請求範例

POST /v2/p2p/modify-ads HTTP/1.1
Host: api.coinex.com
Content-Type: application/json
{
  "ads": [
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
      "price": "210000"
    },
    {
      "ad_id": "5f7c8b9d1a2b3c4d5e6f7g9i",
      "price": "11000"
    }
  ]
}

響應參數

傳回每個廣告修改的結果數組，每個元素包含以下欄位：

參數名	類型	描述
code	Integer	結果代碼，0表示成功
message	String	結果訊息
data	Object	成功時回傳更新後的廣告訊息，失敗時為null

響應範例

{
  "code": 0,
  "message": "OK",
  "data": [
    {
      "code": 0,
      "message": "OK",
      "data": {
        "ad_id": "5f7c8b9d1a2b3c4d5e6f7g8h",
        "created_at": 1618456789000,
        "updated_at": 1618556789000,
        "ad_number": "AD123456789",
        "ad_side": "BUY",
        "base_ccy": "BTC",
        "quote_ccy": "CNY",
        "price": "210000",
        "available_amount": "0.5",
        "quote_min_limit": "500",
        "quote_max_limit": "50000",
        "status": "ONLINE"
      }
    },
    {
      "code": 11002,
      "message": "adv not exists",
      "data": null
    }
  ]
}

7、P2P市場深度數據

接口信息

URL路徑：/v2/p2p/market/depth
請求方法：GET
介面描述：取得P2P市場深度數據
權限要求：不需要認證

請求參數

查詢參數

參數名	必填	類型	描述
base_ccy	是	String	基礎貨幣
quote_ccy	是	String	計價貨幣

請求範例

GET /v2/p2p/market/depth?base_ccy=BTC&quote_ccy=CNY HTTP/1.1
Host: api.coinex.com

響應參數

參數名	類型	描述
base_ccy	String	基礎貨幣
quote_ccy	String	計價貨幣
index_price	String	指數價格
depth	Object	深度數據
depth.bids	Array	買單深度
depth.asks	Array	賣單深度

深度数组中的每个元素包含以下字段：

參數名	類型	描述
price	String	價格
amount	String	數量

響應範例

{
  "code": 0,
  "message": "OK",
  "data": {
    "base_ccy": "BTC",
    "quote_ccy": "CNY",
    "index_price": "200000",
    "depth": {
      "bids": [
        {
          "price": "199000",
          "amount": "1.5",
        },
        {
          "price": "198000",
          "amount": "2.0",
        }
      ],
      "asks": [
        {
          "price": "201000",
          "amount": "1.0",
        },
        {
          "price": "202000",
          "amount": "1.8",
        },
      ]
    }
  }
}

免責聲明：本網站提供的內容僅供參考，不構成投資建議，不能取代專業的財務建議、諮詢或推薦。建議使用者在做出任何投資決策之前，請諮詢合格的財務顧問。本網站的所有者和作者不對因依賴所提供資訊而導致的任何損失或損害承擔任何責任。所有投資均有風險，過去的表現不能作為未來結果的指標。