jiayaoqijia/cryptoskill/kraken

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.

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

Account Data Private

Earn Data Private

Funding Private

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

5. API Key Permissions Required