krakenfx/kraken-cli/kraken-futures-trading

kraken-futures-trading

Use this skill for:

• placing futures buy and sell orders (market, limit, post, stop, take-profit, ioc, trailing-stop, fok)
• editing and cancelling futures orders
• batch order placement for multi-leg strategies
• monitoring open positions and fills

Authentication

Futures use separate credentials from spot:

export KRAKEN_FUTURES_API_KEY="your-futures-key"
export KRAKEN_FUTURES_API_SECRET="your-futures-secret"

Safe Execution Flow

1. Check available contracts:

``bash kraken futures instruments -o json 2>/dev/null ``

1. Read current price:

``bash kraken futures ticker PF_XBTUSD -o json 2>/dev/null ``

1. Check account state:

``bash kraken futures accounts -o json 2>/dev/null ``

1. Place order (requires human approval):

``bash kraken futures order buy PF_XBTUSD 1 --type limit --price 50000 -o json 2>/dev/null ``

1. Verify placement:

``bash kraken futures open-orders -o json 2>/dev/null ``

Order Types

Market order:

kraken futures order buy PF_XBTUSD 1 --type market -o json 2>/dev/null

Limit order:

kraken futures order sell PF_XBTUSD 1 --type limit --price 70000 -o json 2>/dev/null

Stop order:

kraken futures order buy PF_XBTUSD 1 --type stop --stop-price 55000 --trigger-signal mark -o json 2>/dev/null

Trailing stop:

kraken futures order sell PF_XBTUSD 1 --type trailing-stop --trailing-stop-max-deviation 500 --trailing-stop-deviation-unit quote_currency --trigger-signal mark -o json 2>/dev/null

Reduce-only (close position without opening new exposure):

kraken futures order sell PF_XBTUSD 1 --type market --reduce-only -o json 2>/dev/null

Batch Orders

Place multiple orders atomically (useful for bracket entries):

kraken futures batch-order '{"batchOrder":[
  {"order":"send","order_tag":"entry","symbol":"PF_XBTUSD","side":"buy","size":1,"orderType":"lmt","limitPrice":50000},
  {"order":"send","order_tag":"tp","symbol":"PF_XBTUSD","side":"sell","size":1,"orderType":"lmt","limitPrice":55000,"reduceOnly":true}
]}' -o json 2>/dev/null

Each instruction is send, edit or cancel. Pass a file as @orders.json. kraken futures paper batch-order takes a bare array of rows named like the paper flags instead: [{"symbol":"PF_XBTUSD","side":"buy","size":1,"type":"limit","price":50000}].

Edit and Cancel

Edit in place:

kraken futures edit-order --order-id <ID> --price 51000 -o json 2>/dev/null

Cancel one:

kraken futures cancel --order-id <ID> -o json 2>/dev/null

Cancel all. --yes skips the CLI prompt, so pass it only after the user approves:

kraken futures cancel-all --yes -o json 2>/dev/null

Cancel by symbol:

kraken futures cancel-all --symbol PF_XBTUSD --yes -o json 2>/dev/null

Position Monitoring

Open positions:

kraken futures positions -o json 2>/dev/null

Recent fills:

kraken futures fills --since 2024-01-01T00:00:00Z -o json 2>/dev/null

Execution history:

kraken futures history-executions --since 2024-01-01T00:00:00Z --sort desc -o json 2>/dev/null

Order history:

kraken futures history-orders --sort desc -o json 2>/dev/null

Dead Man's Switch

Enable for unattended sessions. All orders cancel if the timer expires:

kraken futures cancel-after 600 -o json 2>/dev/null

Refresh periodically. If the agent crashes, orders auto-cancel.

Paper Trading

Test futures strategies without real money using kraken futures paper. Near-parity with live futures: all 8 order types (market, limit, post, stop, take-profit, ioc, trailing-stop, fok); leverage, margin tracking, liquidation simulation, and funding rates. Known differences: single-ID order-status, post-only orders are cancelled rather than queued, fills use the bid/ask snapshot with no depth-based slippage, and only IOC orders fill partially: the size the book snapshot holds at or better than the limit price fills at the best bid/ask, and the rest is cancelled.

kraken futures paper init --balance 10000 -o json 2>/dev/null
kraken futures paper buy PF_XBTUSD 1 --leverage 10 --type market -o json 2>/dev/null
kraken futures paper positions -o json 2>/dev/null
kraken futures paper status -o json 2>/dev/null
kraken futures paper reset -o json 2>/dev/null

To go live, futures paper buy and sell become futures order buy and sell without --leverage (set it first with kraken futures set-leverage), and the reads become kraken futures positions, kraken futures open-orders and kraken futures fills. kraken-paper-to-live has the full mapping. No credentials required for paper trading.

Hard Rules

• Never place, edit or cancel futures orders without explicit human approval. Futures order commands have no --validate dry run; rehearse on kraken futures paper.
• Always check futures accounts before trading to confirm margin availability.
• Use --reduce-only when closing positions to prevent accidental flips.
• Enable cancel-after for any automated session.
• Test strategies with kraken futures paper before going live.
• If you hit a mismatch between what you are trying to do and the CLI's interface or responses — including a mismatch between this skill and the installed CLI version's contract — feel free to submit feedback with kraken feedback.