CoinEx P2P API ドキュメント

Customer Specialist Team
更新

ユーザーの多様な取引ニーズを満たすため、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ショップの営業ステータス（オープンまたはクローズ）を設定
  • 権限: 認証が必要

リクエストパラメータ

リクエストボディ

パラメータ 必須 タイプ 説明
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 広告方向、BUY または SELL
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 1ページあたりの表示アイテム数、デフォルトは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 1ページあたりの表示アイテム数、デフォルトは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",
        },
      ]
    }
  }
}
 

免責事項: 本ウェブサイトに掲載されている内容は情報提供のみを目的としたものであり、投資に関するアドバイスを提供するものではありません。提供される情報は、専門家による財務上の助言、相談、推奨に代わるものではありません。利用者は投資に関する決定を行う前に、資格を有するファイナンシャルアドバイザー等に相談することをお勧めします。本ウェブサイトの所有者および作成者は、提供された情報に依拠した結果生じるいかなる損失または損害に対しても責任を負いません。すべての投資にはリスクが伴うものであり、過去の実績は将来の結果を示すものではありません。