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 |