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.

Security Scan

The skill is a plausible Bitpanda API client, but its package metadata does not declare the API key it expects and there are small mismatches between the README and the script—these inconsistencies should be resolved before trusting it with secrets.

Purpose & Capability

The skill's name, description, SKILL.md and the included script all consistently implement a Bitpanda API client, which is coherent with the stated purpose. However, the registry metadata declares no required environment variables or primary credential while the SKILL.md and scripts require a BITPANDA_API_KEY. This mismatch between metadata and actual runtime requirements is an incoherence and should be fixed.

Instruction Scope

SKILL.md and scripts limit actions to calling Bitpanda endpoints using curl/jq, handling pagination and errors. The instructions do not ask the agent to read unrelated system files or contact endpoints other than Bitpanda. The README does instruct the user to persist an API key in shell environment files, which is a user choice but not out-of-scope for this client.

Install Mechanism

There is no install spec and the skill is instruction-only plus a shell script included in the bundle. No downloads or archive extraction are performed. This is low-risk from an install perspective.

Credentials

The tool legitimately needs one API credential (BITPANDA_API_KEY), which is proportionate. The problem is the registry metadata does not list this required env var nor a primary credential, creating an information gap. SKILL.md also instructs users how to persist the key in shell rc files — a common practice but one that increases exposure of the secret to local processes and backups.

Persistence & Privilege

The skill does not request permanent/always-on privileges and does not modify other skills or system-wide settings. It simply runs as a CLI script when invoked.

What to consider before installing

This skill appears to be a straightforward Bitpanda API client and not obviously malicious, but there are packaging inconsistencies you should address before installing or using it with a real key: - Metadata mismatch: The registry lists no required environment variables, but the script and SKILL.md clearly require BITPANDA_API_KEY. Treat this as a red flag until the publisher updates metadata to declare the credential. - Secrets handling: The script expects the API key in BITPANDA_API_KEY or as a parameter. Avoid pasting high-privilege API keys into ~/.bashrc or other persistent files unless you understand the risk. Prefer creating a least-privilege Bitpanda API key (only the permissions needed) and consider using a temporary or read-only key for testing. - Verify endpoints: SKILL.md references developer.bitpanda.com (the docs site) while the script uses https://api.bitpanda.com. Confirm the correct base URL and endpoint paths against Bitpanda's official docs before use. - Local review: Because this is a shell script, review it yourself (or have someone you trust review) for any logging, network calls, or accidental echoing of secrets. The included script appears to only send requests to Bitpanda and print results, but it has some brittle jq selectors and minor logic bugs (e.g., how trades are concatenated) — test in a safe environment first. If you decide to proceed: create a least-privilege API key, test with non-critical account data or a sandbox, and request the publisher to update the registry metadata to declare BITPANDA_API_KEY as the primary credential and to correct doc/script discrepancies.

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)

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.

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

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:

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! 💪