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
- Check available contracts:
kraken futures instruments -o json 2>/dev/null - Read current price:
kraken futures ticker PF_XBTUSD -o json 2>/dev/null - Check account state:
kraken futures accounts -o json 2>/dev/null - Place order (requires human approval):
kraken futures order buy PF_XBTUSD 1 --type limit --price 50000 -o json 2>/dev/null - Verify placement:
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
--validatedry run; rehearse onkraken futures paper. - Always check
futures accountsbefore trading to confirm margin availability. - Use
--reduce-onlywhen closing positions to prevent accidental flips. - Enable
cancel-afterfor any automated session. - Test strategies with
kraken futures paperbefore 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.