modbender Kraken Crypto Skill
Use the kraken_cli.py wrapper to query your Kraken account.
Setup
Export your Kraken API credentials.
export KRAKEN_API_KEY="your_api_key"
export KRAKEN_API_SECRET="your_api_secret"
You can also create a .env file in the skill directory.
1. Primary Commands
Use these commands for portfolio queries. They calculate totals automatically.
| Command | Description |
|---|---|
| summary | Portfolio overview with correct totals |
| net-worth | Total net worth calculation |
| performance | Returns compared to deposits |
| holdings | Asset breakdown with USD values |
| staking | Staking positions and rewards |
Example Output summary
TOTAL NET WORTH
Main Wallet (Equity): $544.95
Earn Wallet (Bonded): $81.89
TOTAL: $626.84
AUTO EARN (Flexible) in Main Wallet
BTC : $493.92 (rewards: $0.03)
ETH : $50.66 (rewards: $0.11)
BONDED STAKING in Earn Wallet
SOL : $66.73 (rewards: $0.89)
DOT : $15.16 (rewards: $0.55)
Total Staking Rewards: $1.71
The wrapper separates Auto Earn from Bonded staking to avoid double counting.
2. Raw API Commands
These commands use kraken_api.py for detailed data. Use them for specific information not covered by primary commands.
Market Data Public
| Command | Description | Use Case |
|---|---|---|
| ticker --pair XXBTZUSD | Current price and 24h stats | Price checks |
| ohlc --pair XXBTZUSD | Historical candles | Chart data |
| depth --pair XXBTZUSD | Order book | Liquidity analysis |
| recent-trades --pair XXBTZUSD | Live trades | Market activity |
| assets | Asset names and decimals | Asset lookups |
| pairs | Valid trading pairs | Pair discovery |
| status | Exchange status | Connectivity check |
| time | Server time | API health check |
Account Data Private
| Command | Description | Use Case |
|---|---|---|
| balance | Raw asset quantities | Detailed holdings |
| balance-ex | Balance with reserved funds | Margin analysis |
| portfolio | Trade balance in USD | Raw equity data |
| open-orders | Active orders | Order management |
| closed-orders | Completed orders | Order history |
| trades | Trade execution history | Trade analysis |
| ledger | All transactions | Transaction tracking |
| ledger --asset ZUSD | Filtered by asset | Asset history |
| volume | 30 day volume | Fee tier info |
Earn Data Private
| Command | Description | Use Case |
|---|---|---|
| earn-positions | Raw staking allocations | Detailed staking data |
| earn-strategies | Available yield programs | Strategy discovery |
| earn-status | Pending stakes | Allocation monitoring |
| earn-dealloc-status --refid ID | Pending unstakes | Deallocation monitoring |
Funding Private
| Command | Description | Use Case |
|---|---|---|
| deposits-methods | Available deposit methods | Deposit options |
| deposits-address --asset BTC | Wallet address | Receiving crypto |
3. Critical Caveats
Double Counting Warning
Do not add balance and earn-positions together.
Kraken has two staking types.
- Auto Earn Flexible assets stay in the Main wallet. These are included in portfolio equity.
- Bonded Staking assets move to the Earn wallet. These are not in portfolio equity.
The summary command handles this correctly. If you use raw commands manually follow this logic.
- Correct calculation is Total equals Portfolio Equity plus Bonded Earn Only.
- Incorrect calculation is Total equals Portfolio Equity plus All Earn Allocations.
API Response Notes
- ohlc returns a list under the pair key.
- depth bids and asks are nested under the pair key.
- recent-trades returns a list containing price, volume, time, side, type, and misc.
- earn-strategies uses the items key with apr_estimate.
4. Example Usage
| User Request | Bot Action |
|---|---|
| What is my crypto portfolio? | Run summary |
| What is my net worth? | Run net-worth |
| How am I performing? | Run performance |
| Show my holdings | Run holdings |
| Show my staking | Run staking |
| What is BTC price? | Run ticker --pair XXBTZUSD |
| Show my open orders | Run open-orders |
| Show my trade history | Run trades |
| Get my BTC deposit address | Run deposits-address --asset BTC |
5. API Key Permissions Required
| Feature | Permission |
|---|---|
| Balance and Portfolio | Query Funds |
| Orders and Trades and Ledgers | Query Funds |
| Earn Allocations | Earn |
| Deposit Addresses | Query Funds |
| Market Data | None |