What is kraken-cli AGENTS.md?

An integration guide for kraken-cli, a command-line program for trading on the Kraken cryptocurrency exchange. Its commands can place real financial transactions, while paper trading provides a test environment.

Use it when connecting an AI agent or automated pipeline to Kraken, configuring spot or futures credentials, checking command and error contracts, and testing with paper trading.

It explains installation, API authentication, available agent-facing command references, and the safety requirement to test before using real funds.

kraken-cli AGENTS.md — Instructions file by krakenfx

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/krakenfx/kraken-cli/agents-md

Clone the repo

git clone --depth 1 https://github.com/krakenfx/kraken-cli

Made for: Codex, OpenCode.

Per session 6,207 This file is loaded in full into every session.

When invoked 6,207 The same file — it is already loaded in full.

Security scan C 3 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.06207	$0.06207
Opus 5	$0.03104	$0.03104
Sonnet 5	$0.01241	$0.01241
Haiku 4.5	$0.00621	$0.00621

Measured 3d ago against content hash 15ccc84a10dc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

kraken-cli AGENTS.md scanned grade C with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

result = subprocess.run(

AGENTS.md · 510 lines

How it starts

The opening of the file, as written. The whole thing — 510 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Integration Guide: kraken-cli

This is experimental software. Commands execute real financial transactions on the Kraken exchange. Test with kraken paper before using real funds. See DISCLAIMER.md for full terms.

Self-contained guide for integrating kraken-cli into AI agents, MCP clients, and automated pipelines.

Fast entry points:

Runtime agent context: CONTEXT.md
Full command contract: agents/tool-catalog.json
Error routing contract: agents/error-catalog.json
Workflow skills: skills/

Installation

Single binary, no runtime dependencies.

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh

Pre-built binaries for macOS (Apple Silicon, Intel) and Linux (x86_64, ARM64) are also available on the GitHub Releases page.

Verify: kraken --version

Authentication

Environment variables (recommended for agents)

export KRAKEN_API_KEY="your-key"
export KRAKEN_API_SECRET="your-secret"

# Futures (optional, separate credentials)
export KRAKEN_FUTURES_API_KEY="your-futures-key"
export KRAKEN_FUTURES_API_SECRET="your-futures-secret"

No config file needed. No interactive prompts. The CLI reads credentials from the environment.

Credential resolution order

Command-line flags (--api-key, --api-secret)
Environment variables (KRAKEN_API_KEY, KRAKEN_API_SECRET)
Config file (~/.config/kraken/config.toml)

Required permissions by command group

Group	Kraken API permissions
market	None (public)
account	Query Funds, Query Open Orders & Trades, Query Closed Orders & Trades, Query Ledger Entries
trade	Create & Modify Orders, Cancel/Close Orders
funding	Deposit Funds, Withdraw Funds, Query Funds
earn	Query Funds, Create & Modify Orders
subaccount	Access & Modify Account Settings
websocket (public)	None
websocket (private)	Same as account + trade
futures	Access Futures Markets, Create & Modify Orders, Cancel/Close Orders
paper	None (local simulation)
futures paper	None (local simulation)

Read the full file on GitHub · 510 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

3d ago First seen · 510 lines · 6,207 tokens per session scan C 15ccc84a10dc

Subscribe to this mod's changes

kraken-cli AGENTS.md is an instructions file published in the GitHub repository krakenfx/kraken-cli (704 stars, last pushed 26d ago), licensed MIT. It adds 6,207 tokens to every session, about $0.0310 per session on Opus 5. A static security scan graded it C with 3 findings (downloads and executes remote code, makes network calls, runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Finance and fintech

cryptoexchange-net

Use CryptoExchange.Net abstractions when generating C#/.NET code that needs to work across MULTIPLE cryptocurrency exchanges (Binance + Bybit + OKX + Kraken + Coinbase + ...) — for arbitrage, best-execution routing, multi-exchange portfolio dashboards, exchange-agnostic trading bots, or comparison tools. Triggers on…

JKorf/CryptoExchange.Net · 2,291 tokens

kraken-cli AGENTS.md