코인크래들 API 문서
시작 |
---|
모든 코인크래들 API 요청은 키 매개변수(API 키)를 포함해야하며, 파트너 프로그램에 등록한 후에 사용할 수 있습니다. |
API URI https://coincraddle.com/v1/api
Response type json
GET REQUESTS
/validate-address - 주소 유효성 검사 |
---|
이 요청은 입력한 주소의 정확성을 확인합니다. |
https://coincraddle.com/v1/api/validate-address?key=3r8wzm4c8uo9ep5tk¤cy=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
currency | string | BTC |
address | string | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
Response 200
{
"result":true
}
/rate - 거래 금액에 대한 환율 가져오기 |
---|
이 요청은 현재 환율을 가져옵니다. 이 환율에는 각 거래에서 부과되는 (마이너) 거래 수수료가 포함되어 있지 않습니다. |
https://coincraddle.com/v1/api/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amount=1&fix=0
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
from | string | BTC |
to | string | USDT |
amount | float | 1 |
fix | int 0 or 1 | 0 |
Response 200
{
"fix": false,
"minamount": 0.02,
"maxamount": 120,
"rate": 16776.052484164,
"withdrawalFee": 3.96626 USDT,
"result": true
}
* fix: true - 고정 환율, false - 가변 환율
* withdrawalFee: 인출 수수료에 대한 예상 금액. 가변 매개변수.
/payment/rate - 거래 금액에 대한 지불 환율 가져오기 |
---|
이 요청을 사용하면 현재 환율을 가져오고 결제 금액을 얻을 수 있으며, 이를 통해 지불을 받을 수 있는 금액을 계산할 수 있습니다. |
https://coincraddle.com/v1/api/payment/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amountTo=1000
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
from | string | BTC |
to | string | USDT |
amountTo | float | 1000 |
Response 200
{
"minamount": 0.02,
"maxamount": 120,
"rate": 0.04281856,
"result": true
}
* rate: 결제 받을 금액
/currencies - 통화 목록 |
---|
이 요청을 사용하면 사용 가능한 모든 코인의 목록을 가져옵니다. |
https://coincraddle.com/v1/api/currencies?key=3r8wzm4c8uo9ep5tk
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
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 - 모든 거래 쌍 목록 |
---|
이 요청을 사용하면 거래 가능한 모든 쌍 목록을 가져옵니다. |
https://coincraddle.com/v1/api/pairs?key=3r8wzm4c8uo9ep5tk
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
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 - 거래 생성 |
---|
이 요청은 거래를 생성합니다. |
https://coincraddle.com/v1/api/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amount=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh&fix=0
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
destinationAddress | string | 0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5 |
destinationTagoptional | string | |
refundAddress | string | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
refundTagoptional | string | |
from | string | BTC |
to | string | ETH |
amount | float | 0.1 |
fix | int 0 or 1 | 0 |
Response 200
{
'id' : '2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a',
'depositAddress' : 'bc1qgdjqv0av3q56jvd82tkdjpy7gdp9ut8tlqmgrpmv24sq90ecnvqqjwvw97',
'depositTag' : '',
}
/payment/exchange-create - 결제 생성 |
---|
이 요청은 결제를 생성합니다. |
https://coincraddle.com/v1/api/payment/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amountTo=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
destinationAddress | string | 0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5 |
destinationTagoptional | string | |
refundAddress | string | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
refundTagoptional | string | |
from | string | BTC |
to | string | ETH |
amountTo | float | 0.1 |
Response 200
{
'id' : '2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a',
'depositAddress' : 'bc1qgdjqv0av3q56jvd82tkdjpy7gdp9ut8tlqmgrpmv24sq90ecnvqqjwvw97',
'depositTag' : '',
}
/payment/emergency - 만료된 결제에 대한 작업 선택 |
---|
상태가 payment_time_expired 인 주문에 대한 작업(거래 계속 또는 환불)을 선택합니다. |
https://coincraddle.com/v1/api/payment/emergency?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a&needExchange=0&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
id | string | 2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a |
needExchange | int 0 or 1 | 0 |
refundAddressoptional | string | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
refundTagoptional | string |
Response 200
{
"result": true
}
* needExchange: 1 - 선택 또는 주문 수정 시 시장 환율 또는 네트워크 수수료를 고려하여 계속 거래합니다. 0 - 네트워크 수수료 차감으로 자금 환불합니다.
* refundAddress: 매개변수 "needExchange"가 0인 경우 필수입니다.
/exchange-status - 거래 상태 가져오기 |
---|
현재 거래 상태 정보를 가져옵니다. |
https://coincraddle.com/v1/api/exchange-status?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
id | string | 2a8ce4b6-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 - 거래 목록 상태 가져오기 |
---|
현재 거래 목록 상태 정보를 가져옵니다. |
https://coincraddle.com/v1/api/exchanges-status?key=3r8wzm4c8uo9ep5tk
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
Headers 매개변수
매개변수 | 유형 | 예제 |
---|---|---|
ids | array | ['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 |
https://coincraddle.com/v1/api/exchange-history?key=3r8wzm4c8uo9ep5tk
매개변수
매개변수 | 유형 | 예제 |
---|---|---|
key | string | 3r8wzm4c8uo9ep5tk |
page | int | 0 |
limit | int | 100 (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