CoinEx P2P API 문서

사용자의 다양한 거래 요구를 충족하기 위해 CoinEx는 이제 P2P API 관련 기능을 지원합니다. 세부 내용은 다음과 같습니다:

CoinEx P2P API 사용 가이드

1. 대상 사용자

CoinEx에서 P2P 판매자 ID 인증을 완료한 모든 사용자. 아직 인증된 판매자가 아닌 경우, API 서비스를 사용하기 전에 P2P 페이지에서 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",
        },
      ]
    }
  }
}