ClawHub

Bitpanda V2

Integrations

Interagisci con l'API Bitpanda per ottenere dati grezzi di portafoglio, trade e prezzi senza aggregazioni, con gestione completa di pagination ed errori.

Install

openclaw skills install @mattialagreca/bitpanda-v2

Bitpanda v2 - Skill per Gestione Portafoglio

Una skill semplice e affidabile per interagire con l'API Bitpanda. Restituisce dati grezzi senza aggregazioni automatiche, garantendo accuratezza e trasparenza.

🎯 Filosofia

Meno "smart", più affidabile. La versione precedente aveva bug di aggregazione che restituivano dati errati. Questa skill:

  • ✅ Restituisce dati grezzi dall'API
  • ✅ Gestione pagination corretta
  • ✅ Error handling chiaro
  • ❌ NO aggregazioni automatiche (l'utente elabora se vuole)

📋 Prerequisiti

Software

  • curl - per chiamate HTTP
  • jq - per parsing JSON
  • PowerShell o bash shell

API Key Bitpanda

  1. Vai su Bitpanda Developer Portal
  2. Accedi con il tuo account Bitpanda
  3. Naviga in "API Keys" o "Settings"
  4. Crea una nuova API key (seleziona le permission necessarie)
  5. Copia la chiave e salvala

Configurazione Variabile d'Ambiente

PowerShell:

$env:BITPANDA_API_KEY = "tua-api-key-qui"
# Per renderla permanente:
[System.Environment]::SetEnvironmentVariable("BITPANDA_API_KEY", "tua-api-key-qui", "User")

Bash (Linux/Mac):

export BITPANDA_API_KEY="tua-api-key-qui"
# Per renderla permanente, aggiungi a ~/.bashrc o ~/.zshrc:
echo 'export BITPANDA_API_KEY="tua-api-key-qui"' >> ~/.bashrc

🛠️ Comandi Disponibili

balances - Wallet Crypto con Saldi > 0

Mostra tutti i wallet crypto/commodity/security con saldo maggiore di zero.

Endpoint: /v1/asset-wallets (filtrato per balance > 0)

Esempio:

bitpanda.sh balances

Output: JSON array con solo gli asset che possiedi in quantità significativa. Include:

  • Cryptocoin (BTC, ETH, LTC, etc.)
  • Commodity/Metals (XAU-Gold, XAG-Silver)
  • Security/Stocks (AMD, ARM, QCOM, etc.)
  • ETF e altri prodotti

data - Portfolio Completo

Ottieni la struttura completa del tuo portfolio con tutti i wallet organizzati per categoria.

Endpoint: /v1/asset-wallets (risposta completa)

Esempio:

bitpanda.sh data

Output: JSON completo con:

  • Tutti i wallet organizzati per tipo (cryptocoin, commodity, security, etc.)
  • last_user_action: timestamp dell'ultima azione
  • Struttura gerarchica completa del portfolio

Nota: Questo comando restituisce TUTTI i wallet (anche quelli con balance = 0), utile per vedere la struttura completa.

trades [--limit N] - Storico Trade

Recupera lo storico dei tuoi trade. Supporta pagination automatica per trade vecchi.

Esempi:

# Ultimi 10 trade
bitpanda.sh trades --limit 10

# Tutti i trade (pagination automatica)
bitpanda.sh trades

# Limitato a 50 trade
bitpanda.sh trades --limit 50

Output: JSON con dettagli di ogni trade (data, tipo, asset, quantità, prezzo).

price <SYMBOL> - Prezzo Singolo Asset

Ottieni il prezzo corrente di un singolo asset.

Esempi:

bitpanda.sh price BTC
bitpanda.sh price ETH
bitpanda.sh price EUR

Output: JSON con simbolo, prezzo attuale e timestamp.

prices - Prezzi di Tutti gli Asset Posseduti

Recupera i prezzi correnti di tutti gli asset che possiedi nel tuo portafoglio.

Esempio:

bitpanda.sh prices

Output: JSON con lista di simboli e prezzi corrispondenti.

📚 API Reference

Base URL: https://developer.bitpanda.com/

Endpoint Utilizzati (CORRETTI secondo docs ufficiali)

ComandoEndpointMetodoNote
balances/v1/asset-walletsGETFiltra solo balance > 0
data/v1/asset-walletsGETRisposta completa con tutte le categorie
trades/v1/tradesGETCursor-based pagination
price/v1/ticker?symbol=...GETPrezzo singolo asset
prices/v1/tickerGETPrezzi di tutti gli asset disponibili

⚠️ Endpoint NON ESISTENTI (rimossi):

  • /v1/balances - Non esiste nella docs ufficiale!
  • /v1/data - Non esiste nella docs ufficiale!

Pagination

Trades: Usa cursor e page_size per paginazione.

{
  "data": [...],
  "meta": {
    "total_count": 197,
    "next_cursor": "...",
    "page_size": 10
  }
}

Asset Wallets: Nessuna pagination - restituisce tutti i wallet in una sola chiamata.

⚠️ Errori Comuni e Troubleshooting

401 Unauthorized

Causa: API key invalida o mancante. Soluzione: Verifica che $env:BITPANDA_API_KEY sia impostata correttamente.

429 Rate Limit

Causa: Troppe richieste in breve tempo. Soluzione: Attendi qualche secondo e riprova. Bitpanda ha limiti di rate.

Timeout

Causa: Connessione lenta o API non risponde. Soluzione: Controlla la tua connessione internet, riprova dopo.

jq Non Trovato

Causa: jq non installato sul sistema. Soluzione:

  • Windows: Installa via Chocolatey (choco install jq) o scarica da stedolan.github.io/jq
  • Mac: brew install jq
  • Linux: sudo apt install jq (Debian/Ubuntu)

Output JSON Non Formattato

Causa: jq non funziona correttamente. Soluzione: Testa con echo '{}' | jq '.'. Se non funziona, reinstalla jq.

🔧 Configurazione Avanzata

Timeout Personalizzato

Modifica lo script per cambiare il timeout delle richieste:

# Nel file bitpanda.sh, cerca la riga con --max-time e modifica
curl ... --max-time 30 ...

Verbose Mode

Per debug, aggiungi -v alle chiamate curl nello script.

📝 Note Importanti

  • NO Aggregazione: Questa skill non fa calcoli o aggregazioni sui dati. Restituisce esattamente ciò che Bitpanda invia.
  • Pagination Obbligatoria: Per balances e trades, la pagination è gestita automaticamente se necessario.
  • Dati Grezzi: Se vuoi elaborare i dati (calcolare valori totali, ecc.), fallo dopo con jq o altri tool.

🚀 Esempi Pratici

Valore Totale del Portafoglio

# Ottieni il portfolio completo e estrai il valore totale
bitpanda.sh data | jq '.total_value'

Lista Asset con Quantità > 0

# Filtra solo gli asset che possiedi in quantità significativa
bitpanda.sh balances | jq '.[] | select(.available > 0) | {symbol, available}'

Ultimo Trade

# Ottieni l'ultimo trade fatto
bitpanda.sh trades --limit 1 | jq '.trades[0]'

🆚 Differenze con bitpanda-official (vecchia versione)

Caratteristicabitpanda-official (vecchia)bitpanda-v2 (nuova - MARZO 2026)
Endpoint balances/data❌ /v1/balances, /v1/data (NON ESISTENTI!)✅ /v1/asset-wallets (endpoint corretto)
Aggregazione dati✅ Automatica (buggy!)❌ NO - dati grezzi filtrati
Pagination trades⚠️ Parziale✅ Completa e corretta con cursor
Error handling⚠️ Limitato✅ Completo con messaggi chiari
Affidabilità❌ Dati errati (endpoint sbagliati)✅ Endpoint corretti secondo docs ufficiali

🔧 Aggiornamento Marzo 2026: Corretti gli endpoint balances e data che usavano URL non esistenti nella API Bitpanda. Ora usano /v1/asset-wallets come specificato nella documentazione ufficiale.

📞 Supporto

Per problemi o domande:

  1. Controlla la documentazione ufficiale Bitpanda
  2. Verifica che l'API key sia valida
  3. Testa le chiamate direttamente con curl per isolare il problema

Filosofia BradiBot: 🦥 Qualità > Velocità, Affidabilità > "Smart". Una skill semplice che funziona bene è meglio di una complessa che dà risultati errati! 💪

More in Integrations