Documentazione API Bitinka

Cos’è API Bitinka?

L’interfaccia di programmazione dell’applicazione (API) di BitInka fornisce un insiemi di metodi per cui le applicazioni esterne possono essere integrate alla nostra piattaforma.

Cosa posso fare con API Bitinka?

Con API Bitinka puoi consultare il volume della domanda e dell’offerta di Bitcoin, verificare il bilancio, visualizzare la cronologia di commercio (Trade History), creare o annullare gli ordini di acquisto e vendita in tutti i mercati e più.

L’API ha metodi pubblici e privati che ricevono dati in formato JSON e forniscono risposte in formato XML nella versione 1.0 con la codifica utf-8 o JSON.

Come inizio?

Registrati e crea le password che servono come credenziali per l’uso dell’API.

Per crearle, vai a "Portafoglio" > “Password API”. Devi fornire un identificativo per ogni password con il quale si genererà una password con un codice segreto unico che ti permetterà di accedere ad un insieme di funzioni privati.

Esempio:
{
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x"

}

FUNZIONI DI DATI PUBBLICI

MERCATI

Permette di visualizzare i mercati disponibili per l´exchange.

Richiesta
GET https://www.bitinka.com/api/apinka/markets
Ritorna i mercati disponibili in formato XML.
GET https://www.bitinka.com/api/apinka/markets?format=json
Ritorna i mercati disponibili in formato JSON.
Risposta (JSON)
pair Le coppie di valute disponibili sul mercato
Esempio:BTC_ARS, BTC_BOB, BTC_BRL, BTC_CLP, BTC_CNY, BTC_COP, BTC_EUR, BTC_PEN, LTC_BTC, XRP_BTC, DASH_BTC, ACT_BTC, VEX_BTC, NEO_BTC, GAS_BTC, SSP_BTC, SSC_BTC, BTG_BTC, BCH_BTC, NANO_BTC, ETH_BTC, ETH_ARS, ETH_BOB, ETH_BRL, ETH_CLP, ETH_CNY, ETH_COP, ETH_EUR, ETH_PEN, LTC_ETH, DASH_ETH, ACT_ETH, VEX_ETH, NEO_ETH, GAS_ETH, SSP_ETH, SSC_ETH, BTG_ETH, BCH_ETH, NANO_ETH, XRP_ETH, BTC_USD, ETH_USD, DASH_USD, LTC_USD, XRP_USD, ACT_USD, VEX_USD, NEO_USD, GAS_USD, SSP_USD, SSC_USD, BTG_USD, BCH_USD, NANO_USD.

TICKER

Mostra i valori di mercato nelle ultime ore, il volume nelle ultime 24 ore di ogni mercato, l'ultima offerta el'ultima domanda.

Richiesta
GET https://www.bitinka.com/api/apinka/ticker
Mostra i valori di tutti i mercati in formato XML..
GET https://www.bitinka.com/api/apinka/ticker?format=json
Mostra i valori di tutti i mercati in formato JSON.
Risposta (JSON)
volumen24hour Volume per mercato nelle ultime 24 ore
Ask Ordine di vendita più bassa
Bid Ordine di acquisto più alta
lastPrice Ultimo prezzo di ogni mercato

TICKER BROKER

Mostra i valori di mercato nelle ultime ore, il volume nelle ultime 24 ore di ogni mercato, l'ultima offerta el'ultima domanda.

TICKER PER COPPIA DI VALUTE

Mostra i valori di una specifica coppia di valute nelle ultime ore, il volume di mercato nelle ultime 24 ore, l'ultima offerta e l'ultima domanda.

Richiesta
GET https://www.bitinka.com/api/apinka/ticker/{currency_pair}
Mostra i valori di tutti i mercati in formato XML..
GET https://www.bitinka.com/api/apinka/ticker/{currency_pair}?format=json
Mostra i valori del mercato scelto in formato JSON
Valori supportati per coppie di valuteEsempio: BTC_ARS, BTC_BOB, BTC_BRL, BTC_CLP, BTC_CNY, BTC_COP, BTC_EUR, BTC_PEN, LTC_BTC, XRP_BTC, DASH_BTC, ACT_BTC, VEX_BTC, NEO_BTC, GAS_BTC, SSP_BTC, SSC_BTC, BTG_BTC, BCH_BTC, NANO_BTC, ETH_BTC, ETH_ARS, ETH_BOB, ETH_BRL, ETH_CLP, ETH_CNY, ETH_COP, ETH_EUR, ETH_PEN, LTC_ETH, DASH_ETH, ACT_ETH, VEX_ETH, NEO_ETH, GAS_ETH, SSP_ETH, SSC_ETH, BTG_ETH, BCH_ETH, NANO_ETH, XRP_ETH, BTC_USD, ETH_USD, DASH_USD, LTC_USD, XRP_USD, ACT_USD, VEX_USD, NEO_USD, GAS_USD, SSP_USD, SSC_USD, BTG_USD, BCH_USD, NANO_USD.
Risposta (JSON)
volumen24hour Volume per mercato nelle ultime 24 ore
Ask Ordine di vendita più bassa
Bid Ordine di acquisto più alta
lastPrice Ultimo prezzo di ogni mercato

TICKER PER COPPIA DI BROKER

Mostra i valori di una specifica coppia di valute nelle ultime ore, il volume di mercato nelle ultime 24 ore, l'ultima offerta e l'ultima domanda.

PORTAFOGLIO ORDINI

Ottiene tutte le offerte di acquisto e di vendita che sono attive sul mercato

Richiesta
GET https://www.bitinka.com/api/apinka/order_book/{currency_pair}
Mostra gli ordini di acquisto e di vendita nel mercato scelto in formato XML
GET https://www.bitinka.com/api/apinka/order_book/{currency_pair}?format=json
Mostra gli ordini di acquisto e di vendita nel mercato scelto in formato JSON
Valori supportati per coppie di valute : BTC_ARS, BTC_BOB, BTC_BRL, BTC_CLP, BTC_CNY, BTC_COP, BTC_EUR, BTC_PEN, LTC_BTC, XRP_BTC, DASH_BTC, ACT_BTC, VEX_BTC, NEO_BTC, GAS_BTC, SSP_BTC, SSC_BTC, BTG_BTC, BCH_BTC, NANO_BTC, ETH_BTC, ETH_ARS, ETH_BOB, ETH_BRL, ETH_CLP, ETH_CNY, ETH_COP, ETH_EUR, ETH_PEN, LTC_ETH, DASH_ETH, ACT_ETH, VEX_ETH, NEO_ETH, GAS_ETH, SSP_ETH, SSC_ETH, BTG_ETH, BCH_ETH, NANO_ETH, XRP_ETH, BTC_USD, ETH_USD, DASH_USD, LTC_USD, XRP_USD, ACT_USD, VEX_USD, NEO_USD, GAS_USD, SSP_USD, SSC_USD, BTG_USD, BCH_USD, NANO_USD.
Risposta (JSON)
Ritorna un dizionario JSON con ’’Denaro’’ e ’’Lettera’’ Ognuno è una lista di ordini aperti e ogni ordine è rappresentata come una lista che contiene il prezzo e l'importo.

Order History

History of completed transactions. You can view the current and previous orders.

Richiesta
GET https://www.bitinka.com/api/apinka/order_history/{currency_pair}
Returns history of completed orders, response in XML format.
GET https://www.bitinka.com/api/apinka/order_history/{currency_pair}?format=json
Returns history of completed orders, response in JSON format.
Valori supportati per coppie di valute : BTC_ARS, BTC_BOB, BTC_BRL, BTC_CLP, BTC_CNY, BTC_COP, BTC_EUR, BTC_PEN, LTC_BTC, XRP_BTC, DASH_BTC, ACT_BTC, VEX_BTC, NEO_BTC, GAS_BTC, SSP_BTC, SSC_BTC, BTG_BTC, BCH_BTC, NANO_BTC, ETH_BTC, ETH_ARS, ETH_BOB, ETH_BRL, ETH_CLP, ETH_CNY, ETH_COP, ETH_EUR, ETH_PEN, LTC_ETH, DASH_ETH, ACT_ETH, VEX_ETH, NEO_ETH, GAS_ETH, SSP_ETH, SSC_ETH, BTG_ETH, BCH_ETH, NANO_ETH, XRP_ETH, BTC_USD, ETH_USD, DASH_USD, LTC_USD, XRP_USD, ACT_USD, VEX_USD, NEO_USD, GAS_USD, SSP_USD, SSC_USD, BTG_USD, BCH_USD, NANO_USD.
Risposta (JSON)
Amount Importo
Price Prezzo
Type Tipo di ordine COMPRARE o VENDERE
Fee Importo della commissione
Total Monto totale = Prezzo* Monto
datetime Data e ora di creazione

FUNZIONI PRIVATE

OTTENERE SALDO TRADE

Ottiene il saldo del Bitinka Wallet di tutte le valute

Richiesta
POST https://www.bitinka.com/api/apinka/get_balance
Mostra il saldo disponibile del Bitinka Wallet in ogni valuta in formato XML
POST https://www.bitinka.com/api/apinka/get_balance/format/json
Mostra il saldo disponibile del Bitinka Wallet in ogni valuta in formato JSON
Richiedere parametri
Key API Key.
secret Segreto
Example {
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x"

}
Risposta (JSON)
coin Valuta
balance Saldo disponibile del Bitinka Wallet

OTTENERE SALDO

Ottiene il saldo del Bitinka Wallet di tutte le valute

Richiesta
POST https://www.bitinka.com/api/apinka/get_wallet_balance
Mostra il saldo disponibile del TOP-UP Wallet in ogni valuta in formato XML
POST https://www.bitinka.com/api/apinka/get_wallet_balance/format/json
Mostra il saldo disponibile del TOP-UP Wallet in ogni valuta in formato JSON
Richiedere parametri
Key API Key.
secret Segreto
Example {
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x"

}
Risposta (JSON)
coin Valuta
balance Saldo disponibile del TOP-UP Wallet

CREARE ORDINE

Creare una offerta di acquisto o di vendita in un mercato specifico.

Richiesta
POST https://www.bitinka.com/api/apinka/create_order
Creare una offerta di acquisto o di vendita in base al tipo di trade, risposta in formato XML
POST https://www.bitinka.com/api/apinka/create_order/format/json
Creare una offerta di acquisto o di vendita in base al tipo di trade, risposta in formato XML
Richiedere parametri
Key API Key.
secret Segreto
typeOrder "comprare" o "vendere"
price Prezzo
investement Importo
firstCurrency Prima valuta della coppia
secondCurrency Seconda valuta della coppia
trade Tipo di trade per l'ordine
I tipi di ordine sono (1) Limit, (2) Market, (5) Fill or kill
Example {
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x",
"new" :
{
"typeOrder" : "sell",
"price" : "7000",
"investement" : "0.00670987",
"firstCurrency" : "BTC",
"secondCurrency" : "USD",
"trade" : 1
}

}
Risposta (JSON)
amount Importo
balanceUser Saldo disponibile per fare trading
date Data
error Vero o falso, per errori
firstCurrency Prima valuta della coppia
idOrder ID di ordine
method Metodo di creazione
price Prezzo
priceMarket Prezzo attuale del mercato
secondCurrency Seconda valuta della coppia
status Stato ordine
total Monto totale = Prezzo* Monto
typeOrder Tipo di ordine COMPRARE o VENDERE
typeTrading Tipo di trade
username Nome utente dell'utente nel sistema.

CREATE ORDER STOP

Creare una offerta di acquisto o di vendita in un mercato specifico.

Richiesta
POST https://www.bitinka.com/api/apinka/create_order/stop
Creare una offerta di acquisto o di vendita in base al tipo di trade, risposta in formato XML
POST https://www.bitinka.com/api/apinka/create_order/stop/format/json
Creare una offerta di acquisto o di vendita in base al tipo di trade, risposta in formato XML
Richiedere parametri
Key API Key.
secret Segreto
typeOrder "comprare" o "vendere"
priceLimit Precio en el que se creará la orden
priceStop Precio en el que se dispara la orden
investement Importo
firstCurrency Prima valuta della coppia
secondCurrency Seconda valuta della coppia
trade Tipo di trade per l'ordine
percentage Porcentaje
Tipo di trade (3) Stop Unitario, (4) Stop Porcentual (%)
Example {
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x",
"new" :
{
"typeOrder" : "sell",
"priceLimit" : "6500",
"priceStop" : "6400",
"investement" : "0.00670987",
"firstCurrency" : "BTC",
"secondCurrency" : "USD",
"trade" : 4,
"percentage" : 10
}

}
Risposta (JSON)
amount Importo
balanceUser Saldo disponibile per fare trading
date Data
error Vero o falso, per errori
firstCurrency Prima valuta della coppia
idOrder ID di ordine
method Metodo di creazione
price Prezzo
priceMarket Prezzo attuale del mercato
secondCurrency Seconda valuta della coppia
status Stato ordine
total Monto totale = Prezzo* Monto
typeOrder Tipo di ordine COMPRARE o VENDERE
typeTrading Tipo di trade
username Nome utente dell'utente nel sistema.

AGGIUNGERE BROCCATORE D'ORDINE

Effettuare un acquisto o una vendita in un mercato specifico, istantaneamente.

CANCEL ORDER

Cancellare una offerta di acquisto o di vendita in un mercato specifico o per identificazione

Richiesta
POST https://www.bitinka.com/api/apinka/cancel_order
Cancella una o più ordini e restituisce il saldo, risposta in formato XML
POST https://www.bitinka.com/api/apinka/cancel_order/format/json
Cancella una o più ordini e restituisce il saldo, risposta in formato JSON
Richiedere parametri
Key API Key.
secret Segreto
pair Cancella tutti gli ordini della coppia
Richiedere parametri v2
Key API Key.
secret Segreto
id Cancella tutti gli ordini per identificazione
Example {
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x"
"pair": "BTC_USD"

}


o

{
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x",
"id": ["864459:1"]

}
Risposta (JSON)
balance Saldo aggiornato
cancellationDate Data di cancellazione
coin Valuta
creationDate Data di creazione
error Vero o falso, per errori
idOrder ID di ordine
investement Importo
status Estatus
typeOrder Tipo di ordine COMPRARE o VENDERE
username Username del usuario

ORDINI

Cronologia degli ordini di acquisto o di vendita attivi per tipo di trade.

Richiesta
POST https://www.bitinka.com/api/apinka/orders_user
Mostra la cronologia di ordini attivi, risposta in formato XML
POST https://www.bitinka.com/api/apinka/orders_user/format/json
Mostra la cronologia di ordini attivi, risposta in formato JSON
Richiedere parametri
Key API Key.
secret Segreto
firstCurrency Prima valuta della coppia
secondCurrency Seconda valuta della coppia
trade Tipo di trade
I tipi di ordine sono (1) Limit,(3) Stop Unitario, (4) Stop Porcentual (%)
Example {
"key": "KMHTBHNQ-DM2BZQ9O-8PZAXMD3-6VQLYGAI-3RBE8Y5L",
"secret": "l8xky697w8itvvw1rnnp3x86pkkyiqj4yhpxoy4k7nd2ia39xrz0p76errcaiweg",
"firstCurrency" : "BTC",
"secondCurrency" : "USD",
"trade": 1

}
Risposta (JSON)
order_id ID di ordine
fromCurrency Prima valuta della coppia
toCurrency Seconda valuta della coppia
Type Tipo di ordine COMPRARE o VENDERE
Price Prezzo
Amount Importo
Total Monto totale = Prezzo* Monto
datetime Data di creazione
status Stato ordine

TRADE HISTORY

Cronologia delle transazioni completate dell’utente. Mostra gli ordini correnti e precedenti

Richiesta
POST https://www.bitinka.com/api/apinka/trade_history
Mostra la cronologia di ordini completati, risposta in formato XML
POST https://www.bitinka.com/api/apinka/trade_history/format/json
Mostra la cronologia di ordini completati, risposta in formato JSON
Richiedere parametri
Key API Key.
secret Segreto
firstCurrency Prima valuta della coppia
secondCurrency Seconda valuta della coppia
Example {
"key": "KMHTBHNQ-DM2BZQ9O-8PZAXMD3-6VQLYGAI-3RBE8Y5L",
"secret": "l8xky697w8itvvw1rnnp3x86pkkyiqj4yhpxoy4k7nd2ia39xrz0p76errcaiweg",
"firstCurrency": "BTC",
"secondCurrency": "USD"

}
Risposta (JSON)
trade_id ID di ordine
fromCurrency Prima valuta della coppia
toCurrency Seconda valuta della coppia
Amount Importo
Price Prezzo
Type Tipo di ordine COMPRARE o VENDERE
Fee Importo della commissione
Total Monto totale = Prezzo* Monto
datetime Data e ora di creazione
status Stato ordine

ORDINI CANCELLATI

Cronologia delle transazioni completate dell’utente. Mostra gli ordini correnti e precedenti

Richiesta
POST https://www.bitinka.com/api/apinka/orders_cancelled
Mostra la cronologia di ordini cancellati, risposta in formato XML
POST https://www.bitinka.com/api/apinka/orders_cancelled/format/json
Mostra la cronologia di ordini cancellati, risposta in formato JSON
Richiedere parametri
Key API Key.
secret Segreto
trade Tipo di trade
Example {
"key": "KMHTBHNQ-DM2BZQ9O-8PZAXMD3-6VQLYGAI-3RBE8Y5L",
"secret": "l8xky697w8itvvw1rnnp3x86pkkyiqj4yhpxoy4k7nd2ia39xrz0p76errcaiweg",
"trade": 1
}
Risposta (JSON)
order_id ID di ordine
fromCurrency Prima valuta della coppia
toCurrency Seconda valuta della coppia
Type Tipo di ordine COMPRARE o VENDERE
Price Prezzo
Amount Importo
Total Monto totale = Prezzo* Monto
status Stato ordine

CREATE ORDER BROKER

Create a instant purchase or sale in the broker.

Richiesta
POST https://www.bitinka.com/api/v1/addOrderbroker
Create a instant purchase or sale in the broker, response in XML format.
POST https://www.bitinka.com/api/v1/addOrderbroker/format/json
Create a instant purchase or sale in the broker, response in JSON format.
Richiedere parametri
Key API Key.
secret Segreto
firstCurrency Prima valuta della coppia
secondCurrency Seconda valuta della coppia
amount Importo
type "comprare" o "vendere"
Example {
"key": "JU5DC6KD-7QSP8KYQ-BM0TKL3D-LZTRVFSE-9YSM5DZC",
"secret": "3r1cc02nm3h7pkkaje2ftvu2tnpy0pb3hdgtdjh0my7birm25ohzjc2czrbzgn3x",
"new" :
{
"firstCurrency" : "btc",
"secondCurrency" : "usd",
"amount" : "0.0025",
"type" : "buy",
}

}
Risposta (JSON)
order_id ID di ordine
Price Prezzo
Total Monto totale = Prezzo* Monto