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 |