Aggiornamento API Bitstamp per sgcWebSockets

· Funzionalità

La libreria sgcWebSockets è stata aggiornata con miglioramenti significativi al componente API REST di Bitstamp. Questo aggiornamento aggiunge il supporto a diverse nuove categorie di endpoint che prima mancavano, rendendo l'integrazione più completa e allineata con le ultime offerte dell'API Bitstamp v2.

Novità

Le seguenti nuove categorie di endpoint REST API sono state aggiunte al componente TsgcHTTP_API_Bitstamp_Rest:

Indice

  1. User Transactions
  2. Fees
  3. Deposit Addresses
  4. Sub-Account Transfers
  5. Earn / Staking
  6. Travel Rule e Markets
  7. API WebSocket
  8. Configurazione

1. User Transactions

Due nuovi metodi ti permettono di recuperare la cronologia delle transazioni:

Metodo Descrizione
GetUserTransactions Restituisce tutte le transazioni utente con supporto per paginazione (limit, offset) e ordinamento.
GetUserTransactionsForCurrencyPair Restituisce le transazioni utente filtrate per una specifica coppia di valute.

Esempio

// Recupera le ultime 50 transazioni utente, in ordine decrescente
vJSON := Bitstamp1.REST_API.GetUserTransactions(50, 0, 'desc');
// Recupera le transazioni utente per la coppia BTC/USD
vJSON := Bitstamp1.REST_API.GetUserTransactionsForCurrencyPair('btcusd');

2. Fees

Tre nuovi metodi forniscono accesso alle informazioni sulle commissioni:

Metodo Descrizione
GetTradingFees Restituisce le commissioni di trading per tutte le coppie di valute.
GetTradingFeesForCurrencyPair Restituisce la commissione di trading per una specifica coppia di valute.
GetWithdrawalFees Restituisce le commissioni di prelievo per tutte le valute supportate.

Esempio

// Recupera tutte le commissioni di trading
vJSON := Bitstamp1.REST_API.GetTradingFees;
// Recupera la commissione di trading per ETH/USD
vJSON := Bitstamp1.REST_API.GetTradingFeesForCurrencyPair('ethusd');
// Recupera le commissioni di prelievo
vJSON := Bitstamp1.REST_API.GetWithdrawalFees;

3. Deposit Addresses

Un nuovo metodo ti permette di recuperare l'indirizzo di deposito per qualsiasi criptovaluta supportata:

Metodo Descrizione
GetCryptoDepositAddress Restituisce l'indirizzo di deposito per la valuta specificata.

Esempio

// Recupera l'indirizzo di deposito Bitcoin
vJSON := Bitstamp1.REST_API.GetCryptoDepositAddress('btc');
// Recupera l'indirizzo di deposito Ethereum
vJSON := Bitstamp1.REST_API.GetCryptoDepositAddress('eth');

4. Sub-Account Transfers

Due nuovi metodi abilitano i trasferimenti di fondi tra account principale e sub-account:

Metodo Descrizione
TransferToMain Trasferisce fondi da un sub-account all'account principale.
TransferFromMain Trasferisce fondi dall'account principale a un sub-account.

Esempio

// Trasferisce 0.5 BTC dal sub-account a quello principale
vJSON := Bitstamp1.REST_API.TransferToMain('btc', '0.5');
// Trasferisce 100 USD dall'account principale a uno specifico sub-account
vJSON := Bitstamp1.REST_API.TransferFromMain('usd', '100', 'sub_account_id');

5. Earn / Staking

Quattro nuovi metodi forniscono pieno accesso al programma di staking Bitstamp Earn:

Metodo Descrizione
EarnSubscribe Sottoscrivi per guadagnare rewards per la valuta e l'importo specificati.
EarnUnsubscribe Annulla la sottoscrizione dal programma earn.
GetEarnSubscriptions Restituisce l'elenco delle sottoscrizioni earn correnti.
GetEarnTransactions Restituisce la cronologia delle transazioni earn incluse le rewards.

Esempio

// Sottoscrive 1 ETH al programma Earn
vJSON := Bitstamp1.REST_API.EarnSubscribe('eth', '1.0');
// Controlla le sottoscrizioni correnti
vJSON := Bitstamp1.REST_API.GetEarnSubscriptions;
// Recupera la cronologia delle transazioni earn (rewards, ecc.)
vJSON := Bitstamp1.REST_API.GetEarnTransactions;
// Annulla la sottoscrizione di 0.5 ETH da Earn
vJSON := Bitstamp1.REST_API.EarnUnsubscribe('eth', '0.5');

6. Travel Rule e Markets

Sono stati aggiunti due ulteriori endpoint pubblici:

Metodo Descrizione
GetTravelRuleVASPs Restituisce l'elenco dei Virtual Asset Service Providers (VASP) per la conformità EU Travel Rule. Utile quando effettui prelievi cripto che richiedono informazioni sul VASP del beneficiario.
GetMarkets Restituisce l'elenco di tutti i mercati disponibili con dati di base, completando il metodo esistente GetTradingPairsInfo.

Esempio

// Recupera l'elenco dei VASP Travel Rule
vJSON := Bitstamp1.REST_API.GetTravelRuleVASPs;
// Recupera tutti i mercati disponibili
vJSON := Bitstamp1.REST_API.GetMarkets;

7. API WebSocket

L'API WebSocket V2 rimane completamente aggiornata. Tutti i canali pubblici (Live Ticker, Live Orders, Order Book, Detail Order Book, Full Order Book) e i canali privati (My Orders, My Trades) continuano a funzionare con l'endpoint wss://ws.bitstamp.net.


8. Configurazione

Per usare gli endpoint REST API privati, devi configurare le tue credenziali API Bitstamp:

Bitstamp1.Bitstamp.ApiKey := 'your_api_key';
Bitstamp1.Bitstamp.ApiSecret := 'your_api_secret';
Nota: tutti i nuovi endpoint usano la stessa autenticazione basata su header HMAC-SHA256 (header X-Auth) già in uso per gli endpoint privati esistenti. Non è necessaria nessuna configurazione aggiuntiva.