Bitpanda V2

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

MattiaLaGreca@mattialagreca

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

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

Configurazione Variabile d'Ambiente

PowerShell:

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):

bash

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:

bash

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:

bash

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:

bash

# 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:

bash

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:

bash

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)

Comando	Endpoint	Metodo	Note
balances	`/v1/asset-wallets`	GET	Filtra solo balance > 0
data	`/v1/asset-wallets`	GET	Risposta completa con tutte le categorie
trades	`/v1/trades`	GET	Cursor-based pagination
price	`/v1/ticker?symbol=...`	GET	Prezzo singolo asset
prices	`/v1/ticker`	GET	Prezzi 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.

json

{
  "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:

bash

# 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

bash

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

Lista Asset con Quantità > 0

bash

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

Ultimo Trade

bash

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

🆚 Differenze con bitpanda-official (vecchia versione)

Caratteristica	bitpanda-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:

Controlla la documentazione ufficiale Bitpanda
Verifica che l'API key sia valida
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! 💪

Bitpanda V2

Install

Bitpanda v2 - Skill per Gestione Portafoglio

🎯 Filosofia

📋 Prerequisiti

Software

API Key Bitpanda

Configurazione Variabile d'Ambiente

🛠️ Comandi Disponibili

balances - Wallet Crypto con Saldi > 0

data - Portfolio Completo

trades [--limit N] - Storico Trade

price <SYMBOL> - Prezzo Singolo Asset

prices - Prezzi di Tutti gli Asset Posseduti

📚 API Reference

Endpoint Utilizzati (CORRETTI secondo docs ufficiali)

Pagination

⚠️ Errori Comuni e Troubleshooting

401 Unauthorized

429 Rate Limit

Timeout

jq Non Trovato

Output JSON Non Formattato

🔧 Configurazione Avanzata

Timeout Personalizzato

Verbose Mode

📝 Note Importanti

🚀 Esempi Pratici

Valore Totale del Portafoglio

Lista Asset con Quantità > 0

Ultimo Trade

🆚 Differenze con bitpanda-official (vecchia versione)

📞 Supporto

Related skills

`balances` - Wallet Crypto con Saldi > 0

`data` - Portfolio Completo

`trades [--limit N]` - Storico Trade

`price <SYMBOL>` - Prezzo Singolo Asset

`prices` - Prezzi di Tutti gli Asset Posseduti