IncoreX API

Per motivi di sicurezza, l'attivazione dell'API blocca il prelievo dei fondi per 48 ore.

Il numero di chiamate ai metodi API è limitato a 180 richieste al minuto da un indirizzo IP o da un utente.

PUBLIC API

API è accessibile senza autorizzazione HTTP utilizzando i metodi GET o POST.

Un'API pubblica non richiede autorizzazione ed è disponibile tramite i metodi HTTP GET o POST.
La vista generale dell'URL per accedere all'API è la seguente https://api.incorex.com/v1/{api-name}?{api-params} https://api.incorex.com/v1/{api-name}?{api-params}
dove api-name - è il nome del metodo API che viene richiesto
api-params - parametri di richieste in entrata (se presenti)

Descrizione dei metodi:

Elenco delle transazioni per una coppia di valute
Nome del metodo:: trades
MetodoHTTP della richiesta:: POST / GET
Parametri in entrata:: pair - una o più coppie di valute separate da una virgola (esempio BTC_USD, BTC_EUR)
Esempio di utilizzo:: https://api.incorex.com/v1/trades?pair=BTC_USD
Risposta restituita: { "BTC_USD": [ { "trade_id": 7569368, "type": 1, "quantity": "1", "price": "100", "amount": "100", "date": 1528129170 } ] }
Descrizione dei campi: trade_id - Elenco di ordini per una coppia di valute
type - una o più coppie di valute, separate da una virgola (esempio BTC_USD,BTC_EUR)
quantity - volume di tutti gli ordini in acquisto
price - prezzo di transazione
amount - importo di tutti gli ordini in acquisto
date - data e ora della transazione nel formato
ask - lista di ordini in vendita, dove ogni riga è il prezzo, la quantità e l'importo.
Nome del metodo:: order_book
MetodoHTTP della richiesta:: POST / GET
Parametri in entrata:: pair - una o più coppie di valute separate da una virgola (esempio BTC_USD, BTC_EUR)
limit – numero di elementi visualizzati (predefinito 100, massimo 1000)
Esempio di utilizzo:: https://api.incorex.com/v1/order_book?pair=BTC_USD
Risposta restituita: { "BTC_USD": { "ask": [["100","1","100"],["200","2","400"]], "bid": [["99","1","99"]], "ask_quantity": "3", "ask_amount": "500", "ask_top": "100", "bid_quantity": "1", "bid_amount": "99", "bid_top": "99" } }
Descrizione dei campi: ask - lista di ordini peracquisto, dove ogni riga è il prezzo, la quantità e l'importo
bid - lista di ordini peracquisto, dove ogni riga è il prezzo, la quantità e l'importo
ask_quantity - volume di tutti gli ordini in vendita
ask_amount - importo di tutti gli ordini in vendita
ask_top - prezzo minimo di vendita
bid_quantity - volume di tutti gli ordini in acquisto
bid_amount - importo di tutti gli ordini in acquisto
bid_top - bid_top–prezzo massimo di acquisto
Statistiche sui prezzi e valore trading delle coppie di valute
Nome del metodo:: ticker
MetodoHTTP della richiesta:: POST / GET
Parametri in entrata:: No
Esempio di utilizzo:: https://api.incorex.com/v1/ticker
Risposta restituita: { "BTC_USD": [ "BTC/USD", "7560.2", "7560.3", "52.02", "0.0069", "14235.04859805", "7599.7", "7372", 1528216450 ] }
Descrizione dei campi: Una serie di dati, tra cui::
  1. 1. nome di una coppia di valute
  2. current bid price
  3. current ask price
  4. 4.importo di quale l’ultimo prezzo è cambiato in 24 ore
  5. 5.importo di quale il prezzo è cambiato espresso in percentuale per 24 ore
  6. last price
  7. volume for 24 hours
  8. high price for 24 hours
  9. low price for 24 hours
  10. 10.data e ora dell'aggiornamento dei dati in formato Unix
Impostazioni della coppia di valute
Nome del metodo:: pair_settings
MetodoHTTP della richiesta:: POST / GET
Parametri in entrata:: No
Esempio di utilizzo:: https://api.incorex.com/v1/pair_settings
Risposta restituita: { "BTC_USD": { "min_quantity":"0.002", "max_quantity":"100", "min_price":"0.01", "max_price":"100", "min_amount":"0.01", "max_amount":"300" } }
Descrizione dei campi: min_quantity - quantità minima in base all’ordine
max_quantity - quantità massima in base all’ordine
min_price - prezzo minimo in base all’ordine
max_price - prezzo massimo in base all’ordine
min_amount - importo minimo in base all’ordine
max_amount - importo massimo in base all’ordine
Elenco delle valute di scambio
Nome del metodo:: currency
MetodoHTTP della richiesta:: POST / GET
Parametri in entrata:: No
Esempio di utilizzo:: https://api.incorex.com/v1/currency
Risposta restituita: ["EUR","USD","PLN","RUB","BTC","BCH","DASH","ETH","ETC","LTC","XMR"]
AUTHENTICATED API

Le richieste API sono accessibili solo tramite HTTP utilizzando il metodo POST utilizzando l'autorizzazione.

Tutti i metodi API sono accessibili solo tramite HTTP POST.

La vista generale dell'URL per accedere all'API è la seguente https://api.incorex.com/v1/{api-name}?{api-params} https://api.incorex.com/v1/{api-name}
dove api-name - è il nome del metodo API che viene richiesto

L'autorizzazione di tutte le richieste viene effettuata tramite l’invio deiheaders/intestazioni HTTP al server::

Key — Chiave API disponibile nelle impostazioni del profilo utente
(esempio: : d876ff8da67c3731ae25d8335a4168b4)

Sign — Hash dei dati POST (param=val&param1=val1), firmato dalla chiave segreta usando il metodo HMAC-SHA512. Chiave segreta (segreto dell'API) disponibile nelle impostazioni del profilo utente
(esempio: : hash_hmac('sha512', 'param=val&param1=val1', '1ddec0f92f297e937bdf409977df0c02'))

Tutte le richieste devono avere un parametro nonce POST obbligatorio con un valore numerico incrementale (>0). nonce con un valore numerico incrementale (>0). Questo valore non deve essere ripetuto o diminuito.

Gli esempi pratici di utilizzo dell'API in diversi linguaggi di programmazione:
PHP github.com/incorex-dev/incorex-api-lib/tree/master/php
JavaScript github.com/incorex-dev/incorex-api-lib/tree/master/js
Node.js github.com/incorex-dev/incorex-api-lib/tree/master/nodejs
C# github.com/incorex-dev/incorex-api-lib/tree/master/c#
C++ github.com/incorex-dev/incorex-api-lib/tree/master/c++
Python github.com/incorex-dev/incorex-api-lib/tree/master/python
Java github.com/incorex-dev/incorex-api-lib/tree/master/java
Ruby github.com/incorex-dev/incorex-api-lib/tree/master/ruby
Golang github.com/incorex-dev/incorex-api-lib/tree/master/golang

Descrizione dei metodi:

Informazioni sull'account dell'utente
Nome del metodo:: user_info
MetodoHTTP della richiesta:: POST
Parametri in entrata:: No
uid - ID dell’utente: api_query("user_info", Array());
Risposta restituita: { "uid": 10542, "server_time": 1435518576, "balances": { "BTC": "970.994", "USD": "949.47" }, "reserved": { "BTC": "3", "USD": "0.5" } }
Descrizione dei campi: uid - iD dell’utente
server_time - server_time - data e ora del server in formato Unix
balances - saldo disponibile dell'utente
reserved - saldo dell'utente negli ordini
Creazione di un ordine
Nome del metodo:: order_create
MetodoHTTP della richiesta:: POST
Parametri in entrata:: pair - coppia di valute
quantity – quantità in base all'ordine
price – prezzoin base all'ordine
position – la posizione dell'ordine può assumere i seguenti valori:
  • buy - ordine di acquisto
  • sell - ordine di vendita
type – il tipo dell'ordine può assumere i seguenti valori:
  • limit - ordine in sospeso, che verrà eseguito al raggiungimento del prezzo
  • market - ordine corrente
  • stoplimit - ordine in sospeso, che verrà eseguito quando il prezzo di acquisto più alto o il prezzo di vendita più basso raggiungono un determinato valore limite distoplimit/price stoplimit/price
limitprice – massimo / minimo (a seconda del valore position: buy/sell) massimo / minimo (a seconda del valore della position: buy/sell) prezzo dell'ordine, (parametro obbligatorio pertype: stoplimit) type: stoplimit)
uid - ID dell’utente: api_query("order_create", Array( "pair" => "BTC_USD", "quantity" => 1, "price" => 100, "position" => "buy", "type" => "market" ));
Risposta restituita: { "name": "order_create", "status": "ok", "id": 0, "msg": "Ok", "order_id": 123456 }
Descrizione dei campi: name - nome del metodo API
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene l’identificatore dell’errore
msg - contiene il testo dell'errore
order_id - l’identificatore dell’ordine
l’identificatore della transazione
Nome del metodo:: order_cancel
MetodoHTTP della richiesta:: POST
Parametri in entrata:: order_id - l’identificatore dell’ordine
uid - ID dell’utente: api_query("order_cancel", Array( "order_id" => 123456 ));
Risposta restituita: { "name": "order_cancel", "status": "ok", "id": 0, "msg": "Ok" }
Descrizione dei campi: name - nome del metodo API
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene un identificatore di errore
msg - contiene il testo dell'errore
Elenco di ordini aperti dell'utente
Nome del metodo:: user_open_orders
MetodoHTTP della richiesta:: POST
Parametri in entrata:: No
uid - ID dell’utente: api_query("user_open_orders", Array());
Risposta restituita: { "BTC_USD": [ { "date": 1528117470, "order_id": 123456, "pair": "BTC_USD", "position": 0, "type": "market", "quantity": "1", "price": "100", "amount": "100" } ] }
Descrizione dei campi: date - data e ora della transazione in formato Unix
order_id - l’identificatore dell’ordine
pair - coppia di valute
position - tipo della transazione, dove 0 - vendita, 1 - acquisto
type - tipo di ordine(limit/market/stoplimit),
limitprice - for stoplimit order type,
quantity - quantità in base all'ordine
price - prezzoin base all'ordine
amount - importo sotto mandato
Elenco delle transazioni dell'utente
Nome del metodo:: user_trades
MetodoHTTP della richiesta:: POST
Parametri in entrata:: pair - una o più coppie di valute separate da una virgola (esempio BTC_USD, BTC_EUR)
offset - offset dall'ultima transazione (default 0)
limit - numero di transazioni restituite (valore predefinito 100, massimo 10.000)
uid - ID dell’utente: api_query("user_trades", Array( "pair" => "BTC_USD", "offset" => 0, "limit" => 100 ));
Risposta restituita: { "BTC_USD": [ { "trade_id": 123456, "date": 1435488248, "type": 1, "pair": "BTC_USD", "order_id": 123456, "quantity": 1, "price": 100, "amount": 100 } ] }
Descrizione dei campi: trade_id - Elenco di ordini per una coppia di valute
date - data e ora della transazione in formato Unix
type - una o più coppie di valute, separate da una virgola (esempio BTC_USD,BTC_EUR)
pair - coppia di valute
order_id - l’identificatore dell’ordine dell’utente
quantity - quantità in base alla transazione
price - prezzo dell’affare
amount - importo dell'affare
Elenco degli ordini annullati dell’utente
Nome del metodo:: user_cancelled_orders
MetodoHTTP della richiesta:: POST
Parametri in entrata:: offset - offset dall'ultima transazione (default 0)
limit – numero di transazioni restituite (valore predefinito 100, massimo 10.000)
uid - ID dell’utente: api_query("user_cancelled_orders", Array( "offset" => 0, "limit" => 100 ));
Risposta restituita: [ { "date": 1435519742, "order_id": 123456, "pair": "BTC_USD", "position": 1, "type": "market", "quantity": 3, "price": 100, "amount": 300 } ]
Descrizione dei campi: date - data e ora di cancellazione dell'ordine in formato Unix
order_id - l’identificatore dell’ordine
pair - coppia di valute
position - la posizione dell'ordine, dove 0 è la vendita, 1 è l'acquisto
type - tipo di ordine, dove
  • limit - ordine in sospeso, che verrà eseguito al raggiungimento del prezzo
  • market - ordine corrente
  • stoplimit - ordine in sospeso, che verrà eseguito quando il prezzo di acquisto più alto o il prezzo di vendita più basso raggiungono un determinato valore limite distoplimit/price stoplimit/price
quantity - quantità in base all'ordine
price - prezzoin base all'ordine
amount - importo sotto mandato
La cronologia delle transazioni in base all'ordine
Nome del metodo:: order_trades
MetodoHTTP della richiesta:: POST
Parametri in entrata:: order_id - l’identificatore dell’ordine
uid - ID dell’utente: api_query("order_trades", Array( "order_id" => 123456 ));
Risposta restituita: { "position": 0, "type": "market", "in_currency": "BTC", "in_amount": "1", "out_currency": "USD", "out_amount": "100", "percent_succesfull": 100, "trades": [ { "trade_id": 123456, "date": 1435488248, "type": 0, "pair": "BTC_USD", "order_id": 123456, "quantity": 1, "price": 100, "amount": 100 } ] }
Descrizione dei campi: position - la posizione dell'ordine, dove 0 è la vendita, 1 è l'acquisto
type - tipo di ordine, dove
  • limit - ordine in sospeso, che verrà eseguito al raggiungimento del prezzo
  • market - ordine corrente
  • stoplimit - ordine in sospeso, che verrà eseguito quando il prezzo di acquisto più alto o il prezzo di vendita più basso raggiungono un determinato valore limite distoplimit/price stoplimit/price
in_currency - valuta in entrata
in_amount - importo della valuta in entrata
out_currency - valuta in uscita
out_amount - importo della valuta in uscita
percent_succesfull - percentuale di completamento dell'ordine
trades - una serie di transazioni, dove:
  • trade_id - Elenco di ordini per una coppia di valute
  • date - data della transazione in formato Unix
  • type - tipo di transazione, dove 0 - vendita, 1 - acquisto
  • pair - coppia di valute
  • order_id - l’identificatore dell’ordine
  • quantity - quantità in base alla transazione
  • price - prezzo di transazione
  • amount - importo della transazione
Conta l'ammontare in cui costa acquistare una certa quantità di valuta per una specifica coppia di valute
Nome del metodo:: required_amount
MetodoHTTP della richiesta:: POST
Parametri in entrata:: pair - coppia di valute
quantity – quantità da comprare
uid - ID dell’utente: api_query("required_amount", Array( "pair" => "BTC_USD", "quantity" => "0.5" ));
Risposta restituita: { "quantity": "0.5", "amount": "3500.00", "avg_price": "3.66666666" }
Descrizione dei campi: quantity - importo dell'acquisto
amount - l'importo che spenderete per l'acquisto
avg_price - prezzo medio di acquisto
Elenco degli indirizzi per il deposito di criptovalute
Nome del metodo:: deposit_address
MetodoHTTP della richiesta:: POST
Parametri in entrata:: No
uid - ID dell’utente: api_query("deposit_address", Array());
Risposta restituita: { "BTC": "...", "BCH": "...", "LTC": "...", "ETH": "...." }
Creazione della richiesta di prelievo di criptovalute ATTENZIONE! Questo metodo API è incluso dopo una richiesta al supporto tecnico
Nome del metodo:: withdraw_crypt
MetodoHTTP della richiesta:: POST
Parametri in entrata:: amount - importo della valuta estraibile
currency – denominazione nome della valuta
address – metodo HTTP della richiesta:
uid - ID dell’utente: api_query("withdraw_crypt", Array( "amount" => 0.5, "currency" => "BTC", "address" => "..." ));
Risposta restituita: { "name": "withdraw_crypt", "status": "ok", "id": 0, "msg": "Ok", "task_id": "123456" }
Descrizione dei campi: name - è il nome del metodo API che viene richiesto
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene un identificatore di errore
msg - contiene il testo dell'errore
task_id - identificativo di una richiesta di recesso
Ottenimento dell'ID della transazione con la criptovaluta per il tracciamento nella blockchain
Nome del metodo:: withdraw_get_txid
MetodoHTTP della richiesta:: POST
Parametri in entrata:: task_id - identificativo di una richiesta di recesso
uid - ID dell’utente: api_query("withdraw_get_txid", Array( "task_id" => 123456 ));
Risposta restituita: { "name": "withdraw_get_txid", "status": "ok", "id": 0, "msg": "Ok", "txid": "..." }
Descrizione dei campi: name - nome del metodo API
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene un identificatore di errore
msg - contiene il testo dell'errore
status - "vero" se la richiesta di un output è già stata eseguita
txid - l'identificativo della transazione con il quale può essere trovato nella blockchain. Se contiene un valore vuoto, la richiesta non è ancora stata elaborata
X-VOUCHER API

Le funzioni private sono disponibili solo con autorizzazione. Per attivare questi metodi, è necessario contattare l'assistenza tecnica.

Utilizzando i metodi dell'API di X-VOUCHER, è possibile creare e attivare i voucher X-VOUCHER Questi metodi API sono inclusi per l'utente dopo una richiesta al supporto tecnico
Creazione di un X-VOUCHER
Nome del metodo:: create_xvoucher
MetodoHTTP della richiesta:: POST
Parametri in entrata:: currency - nome valuta del buono
amount – importo del buono
uid - ID dell’utente: api_query("create_xvoucher", Array( "currency" => "BTC", "amount" => 0.5 ));
Risposta restituita: { "name": "create_xvoucher", "status": "ok", "id": 0, "msg": "Ok", "task_id": "123456", "code": "X-VOUCHER-CODE...", "amount": "0.5", "currency": "BTC", "balances": { "BTC": 1, "USD": 1000 } }
Descrizione dei campi: name - nome del metodo API
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene un identificatore di errore
msg - contiene il testo dell'errore
task_id - ID voucher
code - Voucher X-VOUCHER
amount - importo del buono
currency - valuta del buono
balances - saldo dell'utente dopo aver creato un buono
Attivazione di X-VOUCHER
Nome del metodo:: activate_xvoucher
MetodoHTTP della richiesta:: POST
Parametri in entrata:: code - Voucher X-VOUCHER
uid - ID dell’utente: api_query("activate_xvoucher", Array( "code" => "X-VOUCHER-CODE..." ));
Voucher X-VOUCHER: { "name": "activate_xvoucher", "status": "ok", "id": 0, "msg": "Ok", "amount": "0.5", "currency": "BTC" }
Descrizione dei campi: name - nome del metodo API
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene un identificatore di errore
msg - contiene il testo dell'errore
amount - importo del buono
currency - valuta del buono
WALLET API

Le richieste API sono accessibili solo tramite HTTP utilizzando il metodo POST con l'autorizzazione.

Il numero di richieste ai metodi API è limitato a 10 richieste al minuto da un indirizzo IP.
Una serie di operazioni dell’utente (cronologia delle operazioni), dove
Nome del metodo:: wallet_history
MetodoHTTP della richiesta:: POST
Parametri in entrata:: date - data in formato Unix (timestamp) per cui è necessario ottenere la cronologia delle transazioni (se non è indicata, bisogna considerare il giorno successivo) name–nome del metodo API
uid - ID dell’utente: api_query("wallet_history", Array( "date" => 1528239599 ));
Risposta restituita: { "name": "wallet_history", "status": "ok", "id": 0, "msg": "Ok", "begin": "1528239600", "end": "1528325999", "history": [ { "date": 1528239600, "currency": "USD", "type": "deposit", "amount": "100", "fee": "1", "paysystem": "Perfect money", "account": "", "txid": "", "status": "processing" }, { "date": 1528239600, "currency": "XMR", "type": "withdrawal", "amount": "0.15000000", "fee": "0.05000000", "paysystem": "Monero", "account": "...", "txid": "...", "status": "processing" } ] }
Descrizione dei campi: name - nome del metodo API
status - ok in caso della creazione di successo ederrorin caso di errore
id - contiene un identificatore di errore
msg - contiene il testo dell'errore
begin - inizio del periodo in formato Unix
end - fine del periodo in formato Unix
history - una serie di operazioni utente (cronologia transazioni), dove
  • date - data dell’operazione in formato Unix
  • currency - valuta di operazione
  • type - tipo di operazione
  • amount - importo di tutti gli ordini in acquisto
  • fee - commissione
  • paysystem - fornitore
  • account - conti
  • txid - asset trading digitale basato su tecnologie di blockchain
  • status - stato
Continuando a visualizzare, confermi di aver letto Accordo per gli utenti, e d'accordo con INFORMATIVA SULLA PRIVACY.