To the main

Documentation de l'API Coincraddle


Commencer
Toutes les requêtes vers l'API Coincraddle doivent contenir le paramètre key (clé API) disponible après l'inscription au Programme de partenariat.

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

Response type json


GET REQUESTS


/validate-address - Validation d'adresse
Cette requête vérifie la validité de l'adresse saisie.
GET
https://coincraddle.com/v1/api/validate-address?key=3r8wzm4c8uo9ep5tk&currency=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Paramètre

ParamètreTypeExemple
keystring3r8wzm4c8uo9ep5tk
currencystringBTC
addressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Response 200

{
    "result":true
}

/rate - Obtenir le taux de change pour le montant de la transaction
Cette requête obtient le taux de change actuel. Le taux n'inclut pas les frais de transaction (mineur) prélevés sur chaque transaction.
GET
https://coincraddle.com/v1/api/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amount=1&fix=0

Paramètre

ParamètreTypeExemple
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 - taux fixe, false - taux variable

* withdrawalFee: frais de retrait approximatifs. Paramètre variable.


/payment/rate - Obtenir le taux de change pour le montant du paiement
Cette requête permet d'obtenir le taux de change actuel et de calculer le montant des fonds à envoyer pour recevoir le paiement.
GET
https://coincraddle.com/v1/api/payment/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amountTo=1000

Paramètre

ParamètreTypeExemple
keystring3r8wzm4c8uo9ep5tk
fromstringBTC
tostringUSDT
amountTofloat1000

Response 200

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

* rate: montant des fonds à envoyer


/currencies - Liste des devises
Cette requête obtient la liste de toutes les pièces disponibles.
GET
https://coincraddle.com/v1/api/currencies?key=3r8wzm4c8uo9ep5tk

Paramètre

ParamètreTypeExemple
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
  },
  ...
}

Note

Si tagname n'est pas une valeur vide, alors ce tag est obligatoire pour cette devise.


/pairs - Liste de toutes les paires
Cette requête obtient la liste de toutes les paires disponibles pour l'échange.
GET
https://coincraddle.com/v1/api/pairs?key=3r8wzm4c8uo9ep5tk

Paramètre

ParamètreTypeExemple
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 - Création d'un échange
Cette requête crée un échange.
GET
https://coincraddle.com/v1/api/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amount=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh&fix=0

Paramètre

ParamètreTypeExemple
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 - Création d'un paiement
Cette requête crée un paiement.
GET
https://coincraddle.com/v1/api/payment/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amountTo=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Paramètre

ParamètreTypeExemple
keystring3r8wzm4c8uo9ep5tk
destinationAddressstring0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5
destinationTagoptionalstring
refundAddressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
refundTagoptionalstring
fromstringBTC
tostringETH
amountTofloat0.1

Response 200

{
    'id'             : '2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a',
    'depositAddress' : 'bc1qgdjqv0av3q56jvd82tkdjpy7gdp9ut8tlqmgrpmv24sq90ecnvqqjwvw97',
    'depositTag'     : '',
}

/payment/emergency - Choix de l'action pour un paiement en retard
Choix de l'action (continuer l'échange ou remboursement) pour une commande en statut payment_time_expired.
GET
https://coincraddle.com/v1/api/payment/emergency?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a&needExchange=0&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Paramètre

ParamètreTypeExemple
keystring3r8wzm4c8uo9ep5tk
idstring2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a
needExchangeint 0 or 10
refundAddressoptionalstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
refundTagoptionalstring

Response 200

{
    "result": true
}

* needExchange: 1 - Continuer l'échange au taux du marché au moment du choix ou au moment de la correction de la commande. 0 - Remboursement des fonds déduction faite des frais de réseau.

* refundAddress: Obligatoire si le paramètre "needExchange" = 0


/exchange-status - Obtenir le statut de l'échange
Obtenir des informations sur le statut actuel de l'échange
GET
https://coincraddle.com/v1/api/exchange-status?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a

Paramètre

ParamètreTypeExemple
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
}

Note

Liste des statuts utilisés :
new - nouvel échange (en attente du dépôt)
waiting_deposit - confirmation du dépôt
deposit_received - dépôt reçu
exchanging - en cours d'échange
sending - en cours d'envoi
success - échange terminé avec succès
time_expired - délai d'attente des fonds expiré
payment_time_expired - délai d'attente des fonds pour le paiement expiré
failed - échange terminé avec une erreur
sending_failed - tentative d'envoi échouée
reverted - les fonds ont été restitués au client

Liste des statuts pour les commandes suspendues :
EXPIRED - la transaction a été reçue après l'expiration de la commande
LESS - la transaction a été envoyée pour un montant inférieur à celui de la commande


/exchanges-status - Obtenir les statuts de la liste des échanges
Obtenir des informations sur les statuts actuels des échanges
GET
https://coincraddle.com/v1/api/exchanges-status?key=3r8wzm4c8uo9ep5tk

Paramètre

ParamètreTypeExemple
keystring3r8wzm4c8uo9ep5tk

Headers Paramètre

ParamètreTypeExemple
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
}

Note

Liste des statuts utilisés :
new - nouvel échange (en attente du dépôt)
waiting_deposit - confirmation du dépôt
deposit_received - dépôt reçu
exchanging - en cours d'échange
sending - en cours d'envoi
success - échange terminé avec succès
time_expired - délai d'attente des fonds expiré
payment_time_expired - délai d'attente des fonds pour le paiement expiré
failed - échange terminé avec une erreur
sending_failed - tentative d'envoi échouée
reverted - les fonds ont été restitués au client

Liste des statuts pour les commandes suspendues :
EXPIRED - la transaction a été reçue après l'expiration de la commande
LESS - la transaction a été envoyée pour un montant inférieur à celui de la commande


/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

Paramètre

ParamètreTypeExemple
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
}

Note

Liste des statuts utilisés :
new - nouvel échange (en attente du dépôt)
waiting_deposit - confirmation du dépôt
deposit_received - dépôt reçu
exchanging - en cours d'échange
sending - en cours d'envoi
success - échange terminé avec succès
time_expired - délai d'attente des fonds expiré
payment_time_expired - délai d'attente des fonds pour le paiement expiré
failed - échange terminé avec une erreur
sending_failed - tentative d'envoi échouée
reverted - les fonds ont été restitués au client

Liste des statuts pour les commandes suspendues :
EXPIRED - la transaction a été reçue après l'expiration de la commande
LESS - la transaction a été envoyée pour un montant inférieur à celui de la commande


© 2020-2024 coincraddle.com