CoinEx P2P API ドキュメント

ユーザーの多様な取引ニーズを満たすため、CoinExはP2P API関連機能をサポートしています。詳細は以下の通りです：

CoinEx P2P API 利用ガイド

1. 対象ユーザー

CoinExでP2P商人ID認証を完了したユーザー。まだ認証された商人でない場合は、API サービスを利用する前にP2Pページで商人ステータスを申請する必要があります。

2. 実行効率と内容

APIサービスを通じて操作するユーザーの情報取得やリクエスト実行の効率は、CoinExインターフェース内での操作と同じです。ただし、フィールド制限により返される内容が省略される場合があります。

3. サポートされるモジュール

• P2Pショップステータス管理
• P2P広告管理
• P2Pユーザー広告リスト
• P2Pマーケット広告リスト
• P2P注文リスト
• P2P広告価格変更
• P2Pマーケットデプスチャートデータ

P2P API エンドポイントドキュメント

以下のエンドポイントを使用する前に、CoinEx公開APIドキュメントで認証を行ってください。

1. P2Pショップステータス管理

エンドポイント情報

• URLパス: /v2/p2p/exchange-status
• リクエストメソッド: POST
• 説明: P2Pショップの営業ステータス（オープンまたはクローズ）を設定
• 権限: 認証が必要

リクエストパラメータ

リクエストボディ

リクエスト例

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

 

レスポンスパラメータ

レスポンス例

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

 

2. P2P広告管理

エンドポイント情報

• URLパス: /v2/p2p/manage-ads
• リクエストメソッド: POST
• 説明: P2P広告の一括管理（オンラインまたはオフライン）
• 権限: 認証が必要

リクエストパラメータ

リクエストボディ

リクエスト例

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

 

レスポンスパラメータ

レスポンス例

{
  "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

レスポンスパラメータ

広告オブジェクトの配列を返します。各広告オブジェクトには以下のフィールドが含まれます：

レスポンス例

{
  "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マーケット広告リストを取得
• 権限: 認証不要

リクエストパラメータ

クエリパラメータ

リクエスト例

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

レスポンスパラメータ

レスポンス例

{
  "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注文リストを取得
• 権限: 認証が必要

リクエストパラメータ

クエリパラメータ

リクエスト例

GET /v2/p2p/order?start_time=1618456789000&end_time=1618556789000&status=CREATED&page=1&limit=10 HTTP/1.1

Host: api.coinex.com

レスポンスパラメータ

各注文オブジェクトには以下のフィールドが含まれます：

レスポンス例

{
  "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配列の各要素には以下のフィールドが含まれます：

リクエスト例

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": 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マーケットデプスチャートデータを取得
• 権限: 認証不要

リクエストパラメータ

クエリパラメータ

リクエスト例

GET /v2/p2p/market/depth?base_ccy=BTC&quote_ccy=CNY HTTP/1.1

Host: api.coinex.com

レスポンスパラメータ

デプスチャート配列の各要素には以下のフィールドが含まれます：

レスポンス例

{
  "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",
        },
      ]
    }
  }
}