Shared runtime contract for kraken-cli: auth, invocation, parsing, and safety.
This tool is experimental. Commands execute real financial transactions on the Kraken exchange. Test with kraken paper before using real funds. See DISCLAIMER.md for full terms.
Always call:
kraken <command> [args...] -o json 2>/dev/null
Rules:
stdout only.stderr as diagnostics.0 means success.stdout.export KRAKEN_API_KEY="your-key"
export KRAKEN_API_SECRET="your-secret"
Optional futures credentials:
export KRAKEN_FUTURES_API_KEY="your-futures-key"
export KRAKEN_FUTURES_API_SECRET="your-futures-secret"
Public market data and paper trading require no credentials.
Route on .error:
auth: re-authenticaterate_limit: read suggestion and docs_url fields, adapt strategynetwork: retry with exponential backoffvalidation: fix inputs, do not retry unchanged requestapi: inspect request parametersThe catalog marks 32 commands as dangerous: true. Always check the dangerous field in agents/tool-catalog.json before executing a command.
Require explicit human approval before:
Use paper trading for dry runs:
kraken paper init --balance 10000 -o json