API Description

¿Qué es API Bitinka?

Es la Interfaz de Programación de Aplicaciones (API) que ofrece Bitinka para brindar una suite de métodos por las cuales aplicaciones externas pueden integrarse a nuestra plataforma.

¿Qué puedo hacer con la API Bitinka?

Con la API Bitinka podrás consultar el volumen de la oferta y demanda del Bitcoin, ver el historial de comercio (Trade History), crear ó cancelar órdenes de compra y venta de Bitcoin y más.

La API cuenta con métodos públicos y privados, los cuales reciben datos en formato JSON y por defecto sirven respuestas en formato XML en su versión 1.0, con codificación utf-8. Pudiendo responder en formato JSON añadiendo ?format=json al final de cada URL.

¿Cómo empiezo?

Cada usuario registrado tiene que crear las llaves que sirven como credenciales para el uso de la API.

Para crearlas, tiene que dirigirse a Perfil > Claves API. Debe proporcionas un identificador para cada llave con el cual se le generara una key con su codigo secret unico; que le permitiran acceder a un conjunto de funciones privadas.

Ejemplo:
  • Key: ZUMAXOZR-R78S017Q-CAS8H8TW-T52RMFSL....
  • Secret:26n28utk4lsmumjnrlfe070bmwiprgjun7xv1q...

Funciones Publicas

volumen24:

trae todo el volumen de movimientos de las ultimas 24 horas.

GET https://www.bitinka.pe/api/apinka/volumen24

GET https://www.bitinka.pe/api/apinka/volumen24?format=json

Ejemplo de respuesta en formato XML:
Ejemplo de respuesta en formato JSon:
order_book:

trae todas las ordenes de ofertas de compra y venta de cada moneda.

GET https://www.bitinka.pe/api/apinka/order_book

GET https://www.bitinka.pe/api/apinka/order_book?format=json

Ejemplo de respuesta en formato XML:
Ejemplo de respuesta en formato JSon:

ticker:

trae los valores de las ultimas horas, como el volumen de cada monena la ultima oferta y la ultima demanda

GET https://www.bitinka.pe/api/apinka/ticker

GET https://www.bitinka.pe/api/apinka/ticker?format=json

Ejemplo de respuesta en formato XML:
Ejemplo de respuesta en formato JSon:

Funciones Privadas

trade_history:

retorna el historial de las transacciones completadas del usuario.

POST https://www.bitinka.pe/api/apinka/trade_history

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw"
}
Ejemplo de respuesta en formato XML:
Ejemplo de respuesta en formato JSon:
trans_history:

retorna el historial de las transacciones del usuario.

Los campos que se muestran en la respuesta son: userId, orderId, type, fromCurrency, toCurrency, amount, askamount, price, total, comment, CONCAT(date,' ',time)

POST https://www.bitinka.pe/api/apinka/trans_history

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw"
}
Ejemplo de respuesta en formato XML:
orders_user:

retorna todas las ordenes del usuario.

POST https://www.bitinka.pe/api/apinka/orders_user

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw"
}
Ejemplo de respuesta en formato XML:
Ejemplo de respuesta en formato JSon:
orders_cancelled:

retorna todas las ordenes canceladas del usuario.

Los campos de las óredenes que se muestran en la respuesta son los siguientes: fromCurrency, toCurrency, Amount, Price, Type, Fee, Total, datetime, status

POST https://www.bitinka.pe/api/apinka/orders_cancelled

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw"
}
create_order:

para crear una nueva orden de compra o venta.

POST https://www.bitinka.pe/api/apinka/create_order

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw",
  • "new":{
    • "type":"sell",//sell or buy
    • "price":"220",
    • "amount":"0.011",
    • "currency":"USD"//USB | BFS | PEN etc
    }
}
cancel_order:

para cancelar una orden por el numero de ids..

POST https://www.bitinka.pe/api/apinka/cancel_order

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw",
  • "id":4848
}
cancel_orders:

Para cancelar ordenes ya sea por venta o compra y el tipo de moneda..

POST https://www.bitinka.pe/api/apinka/cancel_orders

Parametros en formato JSON: {
  • "key":"ZUXOZRASDADAS17Q-CAS8H8TW-T52RMFSL-AEW72VYU",
  • "secret":"26n2k4lsm33232323fgfgsfmwiprgjun7xv1qf6c8t6ucumxa1yh194xstp8dkw",
  • "type":"Buy" o "type":"Sell",
  • "Currency":"USD"
}
© 2017 Bitinka.com. All Rights Reserved.