VIP 고객

코인크래들 API 문서

시작
모든 코인크래들 API 요청은 키 매개변수(API 키)를 포함해야하며, 파트너 프로그램에 등록한 후에 사용할 수 있습니다.

API URI https://coincraddle.com/v1/api

Response type json

GET REQUESTS

/validate-address - 주소 유효성 검사
이 요청은 입력한 주소의 정확성을 확인합니다.
GET
https://coincraddle.com/v1/api/validate-address?key=3r8wzm4c8uo9ep5tk&currency=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
currencystringBTC
addressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Response 200

{
    "result":true
}
/rate - 거래 금액에 대한 환율 가져오기
이 요청은 현재 환율을 가져옵니다. 이 환율에는 각 거래에서 부과되는 (마이너) 거래 수수료가 포함되어 있지 않습니다.
GET
https://coincraddle.com/v1/api/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amount=1&fix=0

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
fromstringBTC
tostringUSDT
amountfloat1
fixint 0 or 10

Response 200

{
  "fix": false,
  "minamount": 0.02,
  "maxamount": 120,
  "rate": 16776.052484164,
  "withdrawalFee": 3.96626 USDT,
  "result": true
}

* fix: true - 고정 환율, false - 가변 환율

* withdrawalFee: 인출 수수료에 대한 예상 금액. 가변 매개변수.

/payment/rate - 거래 금액에 대한 지불 환율 가져오기
이 요청을 사용하면 현재 환율을 가져오고 결제 금액을 얻을 수 있으며, 이를 통해 지불을 받을 수 있는 금액을 계산할 수 있습니다.
GET
https://coincraddle.com/v1/api/payment/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amountTo=1000

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
fromstringBTC
tostringUSDT
amountTofloat1000

Response 200

{
  "minamount": 0.02,
  "maxamount": 120,
  "rate": 0.04281856,
  "result": true
}

* rate: 결제 받을 금액

/currencies - 통화 목록
이 요청을 사용하면 사용 가능한 모든 코인의 목록을 가져옵니다.
GET
https://coincraddle.com/v1/api/currencies?key=3r8wzm4c8uo9ep5tk

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk

Response 200

{
  "BTC": {
    "coinName": "Bitcoin",
    "minamount": 0.1,
    "maxamount": 120,
    "tagname": "",
    "network":"",
    "available": true
  },
  "USDT": {
    "coinName": "Tether",
    "minamount": 1678.66,
    "maxamount": 2757528,
    "tagname": "",
    "network":"erc20",
    "available": true
  },
 "ETC": {
    "coinName": "Ethereum Classic",
    "minamount": 102.51,
    "maxamount": 1021451,
    "tagname": "",
    "network":"",
    "available": true
  },
  "HBAR": {
    "coinName": "Hedera",
    "minamount": 34045.98,
    "maxamount": 39867109,
    "tagname": "MEMO",
    "network": "",
    "available": true
  },
  ...
}

참고

만약 tagname이 비어있지 않으면 해당 통화에 대한 태그가 필수입니다.

/pairs - 모든 거래 쌍 목록
이 요청을 사용하면 거래 가능한 모든 쌍 목록을 가져옵니다.
GET
https://coincraddle.com/v1/api/pairs?key=3r8wzm4c8uo9ep5tk

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk

Response 200

{
  "BTC": [
    "ZEC",
    "DAI",
    "USDT",
    "ETC",
    "BNB",
    "XRP"
  ],
  "XMR": [
    "USDC",
    "BTC",
    "USDT",
    "TUSD"
  ],
  "DASH": [
    "BTC",
    "USDT",
    "УЕР"
  ],
  "USDC": [
    "USDT",
    "ZEC"
  ],
  "LOOM": [
    "ETH",
    "PERL"
  ],
  "XRP": [
    "TRX"
  ],
  "ADA": [
    "USDT"
  ],
  "QTUM": [
    "BTC"
  ],
  ...
}
/exchange-create - 거래 생성
이 요청은 거래를 생성합니다.
GET
https://coincraddle.com/v1/api/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amount=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh&fix=0

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
destinationAddressstring0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5
destinationTagoptionalstring
refundAddressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
refundTagoptionalstring
fromstringBTC
tostringETH
amountfloat0.1
fixint 0 or 10

Response 200

{
    'id'             : '2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a',
    'depositAddress' : 'bc1qgdjqv0av3q56jvd82tkdjpy7gdp9ut8tlqmgrpmv24sq90ecnvqqjwvw97',
    'depositTag'     : '',
}
/payment/exchange-create - 결제 생성
이 요청은 결제를 생성합니다.
GET
https://coincraddle.com/v1/api/payment/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amountTo=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
destinationAddressstring0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5
destinationTagoptionalstring
refundAddressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
refundTagoptionalstring
fromstringBTC
tostringETH
amountTofloat0.1

Response 200

{
    'id'             : '2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a',
    'depositAddress' : 'bc1qgdjqv0av3q56jvd82tkdjpy7gdp9ut8tlqmgrpmv24sq90ecnvqqjwvw97',
    'depositTag'     : '',
}
/payment/emergency - 만료된 결제에 대한 작업 선택
상태가 payment_time_expired인 주문에 대한 작업(거래 계속 또는 환불)을 선택합니다.
GET
https://coincraddle.com/v1/api/payment/emergency?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a&needExchange=0&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
idstring2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a
needExchangeint 0 or 10
refundAddressoptionalstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
refundTagoptionalstring

Response 200

{
    "result": true
}

* needExchange: 1 - 선택 또는 주문 수정 시 시장 환율 또는 네트워크 수수료를 고려하여 계속 거래합니다. 0 - 네트워크 수수료 차감으로 자금 환불합니다.

* refundAddress: 매개변수 "needExchange"가 0인 경우 필수입니다.

/exchange-status - 거래 상태 가져오기
현재 거래 상태 정보를 가져옵니다.
GET
https://coincraddle.com/v1/api/exchange-status?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
idstring2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a

Response 200

{
    'status'             : 'deposit_received',
    'from'               : 'BTC',
    'to'                 : 'USDT',
    'depositAddress'     : '1F1tAaz5x1HUXrCNLbtMDqcw6o5GNn4xqX',
    'depositTag'         : '',
    'destinationAddress' : '0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5',
    'destinationTag'     : '',
    'refundAddress'      : 'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh',
    'refundTag'          : '',
    'expectedAmountFrom' : '0.1',
    "expectedAmountTo"   : '5443.75908463',
    "amountFrom"         : '0.1',
    "date"               : '01.05.2021 10:24:30',
    "txId"               : null,
    "amountTo"           : null,
    "emergency"          : {
        "status"         : 'EXPIRED'
    }
    "result"             : true
}

참고

사용되는 상태 목록:
new - 새로운 거래 (입금 대기 중)
waiting_deposit - 입금 확인 대기 중
deposit_received - 입금 완료
exchanging - 거래 진행 중
sending - 전송 진행 중
success - 거래 성공
time_expired - 자금 대기 시간 초과
payment_time_expired - 결제 대기 시간 초과
failed - 거래 오류 종료
sending_failed - 전송 오류 종료
reverted - 고객에게 자금이 반환됨

일시 중지된 주문에 대한 상태 목록:
EXPIRED - 주문 만료 후 수령된 거래
LESS - 주문보다 낮은 금액의 거래 전송

/exchanges-status - 거래 목록 상태 가져오기
현재 거래 목록 상태 정보를 가져옵니다.
GET
https://coincraddle.com/v1/api/exchanges-status?key=3r8wzm4c8uo9ep5tk

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk

Headers 매개변수

매개변수유형예제
idsarray['2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a', '3b5sa1n8-ev7c-4c43-b5ud-aa2a9347fa6k', '16257e7f-f9fc-4dbb-8ac7-63d0004b3064']

Response 200

{
   "0":{
      "id":"2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a",
      "status":"time_expired",
      "from":"ICX",
      "to":"BAT",
      "depositAddress":"hxd30cf2e9dd32f987d7858d7e964bf173b7429547",
      "depositTag":"",
      "destinationAddress":"0xc406e35bbcec5dc5c3576f159517bef0edc5ba98",
      "destinationTag":"",
      "refundAddress":"hx12b11f61c756609593040aa265e6bfb982b6f780",
      "refundTag":"",
      "expectedAmountFrom":"479",
      "expectedAmountTo":"440.26791571754",
      "amountFrom":null,
      "date":"19.09.2023 19:20:58",
      "txId":null,
      "amountTo":null
   },
   "1":{
      "id":"3b5sa1n8-ev7c-4c43-b5ud-aa2a9347fa6k",
      "status":"time_expired",
      "from":"TRX",
      "to":"USDTTRC20",
      "depositAddress":"TCQLDLUJ6iXaVx5ZYPUitgbsJietQmwXbu",
      "depositTag":"",
      "destinationAddress":"TLUQNgT28ha3hadx9CEptJeXrG7PeBaTC9",
      "destinationTag":"",
      "refundAddress":"TLUQNgT28ha3hadx9CEptJfXre7PeBaTC9",
      "refundTag":"",
      "expectedAmountFrom":"900",
      "expectedAmountTo":"71.689076",
      "amountFrom":null,
      "date":"12.09.2023 15:12:40",
      "txId":null,
      "amountTo":null
   },
   "2":{
      "id":"16257e7f-f9fc-4dbb-8ac7-63d0004b3064",
      "status":"success",
      "from":"ICX",
      "to":"BAT",
      "depositAddress":"hxfb212d7f1d5dba665c306f26d4bbcd83fdd77cf2",
      "depositTag":"",
      "destinationAddress":"0xc406e35bacec3dc5c3576f159517bef0edc5ba98",
      "destinationTag":"",
      "refundAddress":"hx12b11f61c756609593240aa265e6bfb982b6f780",
      "refundTag":"",
      "expectedAmountFrom":"348.884502",
      "expectedAmountTo":307.0772074462869,
      "amountFrom":"348.86450200",
      "date":"13.09.2023 09:13:25",
      "txId":"0xf7ab1826c2a186ce596abf67a964716f30efa40c8e07c70d92ac297cc4c94b88",
      "amountTo":"306.43493965"
   },
   "result":true
}

참고

사용되는 상태 목록:
new - 새로운 거래 (입금 대기 중)
waiting_deposit - 입금 확인 대기 중
deposit_received - 입금 완료
exchanging - 거래 진행 중
sending - 전송 진행 중
success - 거래 성공
time_expired - 자금 대기 시간 초과
payment_time_expired - 결제 대기 시간 초과
failed - 거래 오류 종료
sending_failed - 전송 오류 종료
reverted - 고객에게 자금이 반환됨

일시 중지된 주문에 대한 상태 목록:
EXPIRED - 주문 만료 후 수령된 거래
LESS - 주문보다 낮은 금액의 거래 전송

/exchange-history - Getting a list of all exchanges
This method allows you to get all information on all exchanges
GET
https://coincraddle.com/v1/api/exchange-history?key=3r8wzm4c8uo9ep5tk

매개변수

매개변수유형예제
keystring3r8wzm4c8uo9ep5tk
pageint0
limitint100 (max: 100)

Response 200

{
   "exchanges":[{
      "id":"2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a",
      "status":"time_expired",
      "from":"ICX",
      "to":"BAT",
      "depositAddress":"hxd30cf2e9dd32f987d7858d7e964bf173b7429547",
      "depositTag":"",
      "destinationAddress":"0xc406e35bbcec5dc5c3576f159517bef0edc5ba98",
      "destinationTag":"",
      "refundAddress":"hx12b11f61c756609593040aa265e6bfb982b6f780",
      "refundTag":"",
      "expectedAmountFrom":"479",
      "expectedAmountTo":"440.26791571754",
      "amountFrom":null,
      "date":"19.09.2023 19:20:58",
      "txId":null,
      "amountTo":null
   },
   {
      "id":"3b5sa1n8-ev7c-4c43-b5ud-aa2a9347fa6k",
      "status":"time_expired",
      "from":"TRX",
      "to":"USDTTRC20",
      "depositAddress":"TCQLDLUJ6iXaVx5ZYPUitgbsJietQmwXbu",
      "depositTag":"",
      "destinationAddress":"TLUQNgT28ha3hadx9CEptJeXrG7PeBaTC9",
      "destinationTag":"",
      "refundAddress":"TLUQNgT28ha3hadx9CEptJfXre7PeBaTC9",
      "refundTag":"",
      "expectedAmountFrom":"900",
      "expectedAmountTo":"71.689076",
      "amountFrom":null,
      "date":"12.09.2023 15:12:40",
      "txId":null,
      "amountTo":null
   },
   {
      "id":"16257e7f-f9fc-4dbb-8ac7-63d0004b3064",
      "status":"success",
      "from":"ICX",
      "to":"BAT",
      "depositAddress":"hxfb212d7f1d5dba665c306f26d4bbcd83fdd77cf2",
      "depositTag":"",
      "destinationAddress":"0xc406e35bacec3dc5c3576f159517bef0edc5ba98",
      "destinationTag":"",
      "refundAddress":"hx12b11f61c756609593240aa265e6bfb982b6f780",
      "refundTag":"",
      "expectedAmountFrom":"348.884502",
      "expectedAmountTo":307.0772074462869,
      "amountFrom":"348.86450200",
      "date":"13.09.2023 09:13:25",
      "txId":"0xf7ab1826c2a186ce596abf67a964716f30efa40c8e07c70d92ac297cc4c94b88",
      "amountTo":"306.43493965"
   }],
   "limit":100,
   "page":0,
   "result":true
}

참고

사용되는 상태 목록:
new - 새로운 거래 (입금 대기 중)
waiting_deposit - 입금 확인 대기 중
deposit_received - 입금 완료
exchanging - 거래 진행 중
sending - 전송 진행 중
success - 거래 성공
time_expired - 자금 대기 시간 초과
payment_time_expired - 결제 대기 시간 초과
failed - 거래 오류 종료
sending_failed - 전송 오류 종료
reverted - 고객에게 자금이 반환됨

일시 중지된 주문에 대한 상태 목록:
EXPIRED - 주문 만료 후 수령된 거래
LESS - 주문보다 낮은 금액의 거래 전송

© 2020-2024 coincraddle.com

코인크래들 서비스 이용 시 쿠키를 사용하여 사용자 경험을 개선합니다. 코인크래들 서비스를 이용하면서 사이트의 이용 약관 및 개인정보 보호정책에 동의하게 됩니다.
알겠습니다