Documentación de la API de Coincraddle

Inicio
Todas las solicitudes a la API de Coincraddle deben incluir el parámetro `key` (clave de API), que se obtiene después de registrarse en el Programa de socios.

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

Response type json

GET REQUESTS

`/validate-address` - Validación de dirección
Esta solicitud verifica la corrección de la dirección ingresada.

GET

https://coincraddle.com/v1/api/validate-address?key=3r8wzm4c8uo9ep5tk&currency=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`
currency	`string`	`BTC`
address	`string`	`bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh`

Response 200

Successfull response

{
    "result":true
}

`/rate` - Obtener el tipo de cambio para el monto de la transacción
Esta solicitud obtiene el tipo de cambio actual. La tasa no incluye la comisión por transacción (minero) que se aplica a cada transacción.

GET

https://coincraddle.com/v1/api/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amount=1&fix=0

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`
from	`string`	`BTC`
to	`string`	`USDT`
amount	`float`	`1`
fix	`int 0 or 1`	`0`

Response 200

Successfull response

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

* fix: true - tipo de cambio fijo, false - tipo de cambio flotante

* withdrawalFee: tarifa de retiro aproximada. Parámetro flotante.

`/payment/rate` - Obtener el tipo de cambio para el monto del pago
Esta solicitud permite obtener el tipo de cambio actual y calcular la cantidad de fondos que se deben enviar para recibir el pago.

GET

https://coincraddle.com/v1/api/payment/rate?key=3r8wzm4c8uo9ep5tk&from=BTC&to=USDT&amountTo=1000

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`
from	`string`	`BTC`
to	`string`	`USDT`
amountTo	`float`	`1000`

Response 200

Successfull response

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

* rate: cantidad de fondos que se deben enviar

`/currencies` - Lista de monedas
Esta solicitud obtiene la lista de todas las monedas disponibles.

GET

https://coincraddle.com/v1/api/currencies?key=3r8wzm4c8uo9ep5tk

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`

Response 200

Successfull response

{
  "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
  },
  ...
}

Nota

Si el valor de tagname no está vacío, el tag es obligatorio para esta moneda.

`/pairs` - Lista de todos los pares
Esta solicitud obtiene la lista de todos los pares de intercambio disponibles.

GET

https://coincraddle.com/v1/api/pairs?key=3r8wzm4c8uo9ep5tk

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`

Response 200

Successfull response

{
  "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` - Creación de intercambio
Esta solicitud crea un intercambio.

GET

https://coincraddle.com/v1/api/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amount=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh&fix=0

Parámetro

Parámetro	Tipo	Ejemplo
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

Successfull response

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

`/payment/exchange-create` - Creación de pago
Esta solicitud crea un pago.

GET

https://coincraddle.com/v1/api/payment/exchange-create?key=3r8wzm4c8uo9ep5tk&from=BTC&to=ETH&amountTo=0.1&destinationAddress=0xDAFEA492D9c6733ae3d56b7Ed1ADB60692c98Bc5&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Parámetro

Parámetro	Tipo	Ejemplo
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

Successfull response

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

`/payment/emergency` - Selección de acción para un pago vencido
Seleccione la acción (continuar con el intercambio o reembolso) para un pedido con el estado `payment_time_expired`.

GET

https://coincraddle.com/v1/api/payment/emergency?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a&needExchange=0&refundAddress=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`
id	`string`	`2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a`
needExchange	`int 0 or 1`	`0`
refundAddressoptional	`string`	`bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh`
refundTagoptional	`string`

Response 200

Successfull response

{
    "result": true
}

* needExchange: 1: Continuar con el intercambio al tipo de cambio de mercado en el momento de la selección o en el momento de la corrección del pedido. 0: Reembolso de fondos menos la comisión de la red.

* refundAddress: Obligatorio si el parámetro "needExchange" es igual a 0

`/exchange-status` - Obtener el estado del intercambio
Obtén información sobre el estado actual del intercambio

GET

https://coincraddle.com/v1/api/exchange-status?key=3r8wzm4c8uo9ep5tk&id=2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`
id	`string`	`2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a`

Response 200

Successfull response

{
    '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
}

Nota

Lista de estados utilizados:
nuevo - nuevo intercambio (esperando el depósito)
esperando_deposito - esperando confirmación del depósito
deposito_recibido - depósito recibido
intercambiando - en proceso de intercambio
enviando - en proceso de envío
exito - intercambio completado con éxito
tiempo_expirado - se agotó el tiempo de espera de los fondos
pago_tiempo_expirado - se agotó el tiempo de espera de los fondos para realizar el pago
fallo - intercambio completado con error
envio_fallido - el intento de envío ha fallado
revertido - se devolvieron los fondos al cliente

Lista de estados para pedidos suspendidos:
VENCIDO - la transacción se recibió después de que el pedido venció
MENOR - la transacción se envió por un monto menor al pedido

`/exchanges-status` - Obtener los estados de la lista de intercambios
Obtener información sobre los estados actuales de los intercambios

GET

https://coincraddle.com/v1/api/exchanges-status?key=3r8wzm4c8uo9ep5tk

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`

Headers Parámetro

Parámetro	Tipo	Ejemplo
ids	`array`	`['2a8ce4b6-ed5c-4c43-b4bd-ee2a9347fa7a', '3b5sa1n8-ev7c-4c43-b5ud-aa2a9347fa6k', '16257e7f-f9fc-4dbb-8ac7-63d0004b3064']`

Response 200

Successfull response

{
   "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
}

Nota

Lista de estados para pedidos suspendidos:
VENCIDO - la transacción se recibió después de que el pedido venció
MENOR - la transacción se envió por un monto menor al pedido

`/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

Parámetro

Parámetro	Tipo	Ejemplo
key	`string`	`3r8wzm4c8uo9ep5tk`
page	`int`	`0`
limit	`int`	`100 (max: 100)`

Response 200

Successfull response

{
   "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
}

Nota

Lista de estados para pedidos suspendidos:
VENCIDO - la transacción se recibió después de que el pedido venció
MENOR - la transacción se envió por un monto menor al pedido