API Bitstamp
Bitstamp
Bitstamp è un exchange bitcoin con sede in Lussemburgo. Consente il trading tra la valuta USD e la criptovaluta bitcoin. Permette depositi e prelievi in USD, EUR, bitcoin, litecoin, ethereum, ripple o bitcoin cash.
- Supporta la più recente WebSocket API V2.
- Supporta i seguenti endpoint REST API: Account Balance, User Transactions, Fees, Orders, Withdrawal, Deposit Addresses, Sub-Account Transfers, Earn/Staking, Travel Rule e Markets.
Configurazione
L'API privata richiede la creazione di una API key dal Suo account Bitstamp. Una volta ottenute le Sue API key, configuri queste chiavi nelle seguenti proprietà:
- Bitstamp.ApiKey
- Bitstamp.ApiSecret
WebSocket Public Methods
SubscribeLiveTicker: ottieni le negoziazioni in tempo reale dalla valuta selezionata. Dati JSON:
| Proprietà |
Descrizione |
| id |
ID univoco del trade. |
| amount |
Importo della transazione. |
| amount_str |
Importo dell'operazione rappresentato in formato stringa. |
| price |
Prezzo di scambio. |
| price_str |
Prezzo di negoziazione rappresentato in formato stringa. |
| type |
Tipo di operazione (0 - acquisto; 1 - vendita). |
| timestamp |
Timestamp dell'operazione. |
| microtimestamp |
Microtimestamp della negoziazione. |
| buy_order_id |
ID ordine di acquisto del trade. |
| sell_order_id |
ID dell'ordine di vendita. |
SubscribeLiveOrders: ottieni gli ordini in tempo reale dalla valuta selezionata. Dati JSON:
| Proprietà |
Descrizione |
| id |
ID ordine. |
| amount |
Importo dell'ordine. |
| amount_str |
Importo dell'ordine rappresentato in formato stringa. |
| price |
Prezzo dell'ordine. |
| price_str |
Prezzo dell'ordine rappresentato in formato stringa. |
| order_type |
Tipo di ordine (0 - acquisto; 1 - vendita). |
| datetime |
Data e ora dell'ordine. |
| microtimestamp |
Timestamp dell'azione dell'ordine espresso in microsecondi. |
SubscribeLiveOrderBook: ottiene l'order book in tempo reale dalla valuta selezionata. Dati JSON:
| Proprietà |
Descrizione |
| bids |
Elenco delle prime 100 offerte di acquisto. |
| asks |
Elenco dei primi 100 ordini ask. |
| timestamp |
Timestamp del book degli ordini. |
| microtimestamp |
Microtimestamp del libro degli ordini. |
SubscribeLiveDetailOrderBook: ottieni il libro ordini dettagliato in tempo reale dalla valuta selezionata. Dati JSON:
| Proprietà |
Descrizione |
| bids |
Elenco dei primi 100 ordini di acquisto [prezzo, quantità, ID ordine]. |
| asks |
Elenco delle prime 100 offerte di vendita [prezzo, quantità, id ordine]. |
| timestamp |
Timestamp del book degli ordini. |
| microtimestamp |
Microtimestamp del libro degli ordini. |
SubscribeLiveFullOrderBook: ottieni il book degli ordini completo in tempo reale dalla valuta selezionata. Dati JSON:
| Proprietà |
Descrizione |
| bids |
Elenco delle offerte modificate dall'ultima trasmissione. |
| asks |
Elenco delle richieste di vendita modificate dall'ultima trasmissione. |
| timestamp |
Timestamp del book degli ordini. |
| microtimestamp |
Microtimestamp del libro degli ordini. |
Metodi privati WebSocket
SubscribeMyOrders: ricevi aggiornamenti sugli ordini inviati. Dati JSON:
| Proprietà |
Descrizione |
| id |
ID ordine. |
| id_str |
ID ordine rappresentato in formato stringa. |
| client_order_id |
ID ordine client (se utilizzato al momento del piazzamento dell'ordine). |
| amount |
Importo dell'ordine. |
| amount_str |
Importo dell'ordine rappresentato in formato stringa. |
| price |
Prezzo dell'ordine. |
| price_str |
Prezzo dell'ordine rappresentato in formato stringa. |
| order_type |
Tipo di ordine (0 - acquisto, 1 - vendita). |
| datetime |
Data e ora dell'ordine. |
| microtimestamp |
Timestamp dell'azione dell'ordine espresso in microsecondi. |
SubscribeMyTrades: ottiene aggiornamenti sugli scambi. Dati JSON:
| Proprietà |
Descrizione |
| id |
ID del trade. |
| order_id |
ID ordine associato alla negoziazione. |
| client_order_id |
ID dell'ordine client associato al trade. |
| amount |
Importo della transazione. |
| price |
Prezzo di scambio. |
| fee |
Commissione di negoziazione. |
| side |
Lato operazione (acquisto o vendita). |
| microtimestamp |
Timestamp della transazione rappresentato in microsecondi. |
Metodi pubblici REST API
Tickers
- GetCurrencies: Vista che restituisce l'elenco di tutte le valute con i dati di base.
- GetAllCurrencyPairsTickers: Restituisce i dati ticker per tutte le coppie di valute. Il passaggio di eventuali parametri GET comporterà il rifiuto della richiesta.
- GetCurrencyPairTicker: Restituisce i dati del ticker per la coppia di valute richiesta. Il passaggio di parametri GET comporterà il rifiuto della richiesta.
- GetHourlyTicker: Restituisce i dati del ticker orario per la coppia di valute richiesta. Il passaggio di qualsiasi parametro GET comporterà il rifiuto della richiesta.
Libro degli ordini
- GetOrderBook: Restituisce i dati del book degli ordini.
Transazioni
- GetTransactions: Restituisce i dati delle transazioni per un determinato intervallo di tempo.
Informazioni di mercato
- GetEURUSDConversionRate: Restituisce il tasso di conversione EUR/USD.
- GetOLHCData: Vista che restituisce i dati OHLC (Open High Low Close) su richiesta API.
- GetTradingPairsInfo: Restituisce informazioni sulle coppie di trading.
- GetMarkets: Restituisce l'elenco di tutti i mercati disponibili con i dati di base.
Travel Rule
- GetTravelRuleVASPs: Restituisce l'elenco dei Virtual Asset Service Provider (VASP) per la conformità al Travel Rule.
Metodi Privati REST API
Saldo del conto
- GetAccountBalances: Restituisce i saldi del conto.
- GetAccountBalanceForCurrency: Restituisce i saldi dell'account per valuta.
Ordini
- BuyInstantOrder: Apre un ordine istantaneo di acquisto. Effettuando un ordine istantaneo si riconosce che l'esecuzione dell'ordine dipende dalle condizioni di mercato e che tali condizioni possono essere soggette a cambiamenti improvvisi non prevedibili. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- BuyMarketOrder: Apre un ordine di acquisto al mercato. Inserendo un ordine al mercato l'utente riconosce che l'esecuzione del proprio ordine dipende dalle condizioni di mercato e che tali condizioni possono essere soggette a cambiamenti improvvisi e imprevedibili. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- BuyLimitOrder: Apre un ordine limite di acquisto. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- CancelAllOrders: Annulla tutti gli ordini aperti. Questa chiamata verrà eseguita sull'account (Sub o Main) al quale è associata la chiave API utilizzata.
- CancelAllOrdersForCurrencyPair: Annulla tutti gli ordini aperti per una coppia di valute. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- CancelOrder: Annulla un ordine. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- GetTradingPairs: Restituisce tutte le coppie di trading che possono essere negoziate sull'account selezionato.
- GetAllOpenOrders: Restituisce gli ordini aperti dell'utente. Questa chiamata API viene memorizzata nella cache per 10 secondi. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- GetOpenOrders: Restituisce gli ordini aperti dell'utente per la coppia di valute. Questa chiamata API viene memorizzata nella cache per 10 secondi. La chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- GetOrderStatus: Restituisce lo stato dell'ordine. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata. L'ordine può essere recuperato utilizzando il parametro id o client_order_id. Per gli ordini chiusi, questa chiamata restituisce informazioni solo per gli ultimi 30 giorni. Verrà restituito l'errore 'Order not found' per gli ordini al di fuori di questo intervallo di tempo.
- SellInstantOrder: Apre un ordine di vendita istantaneo. Piazzando un ordine istantaneo si riconosce che l'esecuzione dell'ordine dipende dalle condizioni di mercato e che tali condizioni possono essere soggette a cambiamenti improvvisi che non possono essere previsti. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- SellMarketOrder: Apre un ordine di vendita a mercato. Inserendo un ordine a mercato si riconosce che l'esecuzione dell'ordine dipende dalle condizioni di mercato e che tali condizioni possono essere soggette a cambiamenti improvvisi non prevedibili. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- SellLimitOrder: Apre un ordine limit di vendita. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
Prelievi
- RippleIOUWithdrawal: Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata. Questo endpoint supporta i prelievi di IOU in USD, BTC o EUR sull'XRP Ledger.
- WithdrawalRequests: Restituisce le richieste di prelievo dell'utente. Questa chiamata verrà eseguita sull'account (Sub o Main) a cui è associata la chiave API utilizzata.
- CancelBankOrCryptoWithdrawal: Annulla una richiesta di prelievo bancario o in criptovaluta. Questa chiamata può essere effettuata solo dal suo Main Account.
- OpenBankWithdrawal: Apre una richiesta di prelievo bancario (SEPA o internazionale). Le richieste di prelievo aperte tramite API vengono confermate automaticamente (non verrà inviata alcuna e-mail di conferma), ma vengono elaborate esattamente come i prelievi aperti tramite l'interfaccia della piattaforma. Questa chiamata può essere effettuata solo dal conto principale.
- FiatWithdrawalStatus: Verifica lo stato di una richiesta di prelievo in valuta fiat. Questa chiamata può essere eseguita solo dal conto principale.
- CryptoWithdrawal: Richiede un prelievo di criptovaluta.
Transazioni utente
- GetUserTransactions: Restituisce tutte le transazioni dell'utente. Supporta i parametri limit, offset e sort.
- GetUserTransactionsForCurrencyPair: Restituisce le transazioni dell'utente per una specifica coppia di valute. Supporta i parametri limit, offset e sort.
Commissioni
- GetTradingFees: Restituisce tutte le commissioni di trading.
- GetTradingFeesForCurrencyPair: Restituisce le commissioni di trading per una specifica coppia di valute.
- GetWithdrawalFees: Restituisce le commissioni di prelievo per tutte le valute.
Indirizzi di Deposito
- GetCryptoDepositAddress: Restituisce l'indirizzo di deposito per la criptovaluta specificata.
Trasferimenti tra sub-account
- TransferToMain: Trasferisce fondi da un sotto-account all'account principale.
- TransferFromMain: Trasferisce fondi dall'account principale a un sotto-account.
Guadagni / Staking
- EarnSubscribe: Effettua la sottoscrizione al programma Earn per la valuta e l'importo specificati.
- EarnUnsubscribe: Annulla l'iscrizione al programma Earn per la valuta e l'importo specificati.
- GetEarnSubscriptions: Restituisce le sottoscrizioni Earn correnti.
- GetEarnTransactions: Restituisce la cronologia delle transazioni Earn (premi, sottoscrizioni, disdette).