How to use the Kraken Futures API with Python? (Developer Guide)

Setting Up Authentication Credentials

1. Log into your Kraken account and navigate to the Settings section under API.

2. Generate a new API key pair specifically for Futures trading, ensuring the 'Futures' permission is enabled.

3. Store the API key and private key securely—never hardcode them in source files or commit them to version control.

4. Use environment variables like KRAKEN_FUTURES_API_KEY and KRAKEN_FUTURES_PRIVATE_KEY to inject credentials at runtime.

5. Validate the keys by making a minimal authenticated request such as fetching account balances via the GET /api/v3/accounts endpoint.

Installing and Configuring Required Libraries

1. Install the official Kraken Futures Python SDK using pip: pip install kraken-futures-api.

2. Alternatively, use requests directly if fine-grained control over headers and signing logic is needed.

3. Import necessary modules: KrakenFuturesAPI, json, and base64 for manual signature generation.

4. Initialize the client with your credentials: client = KrakenFuturesAPI(key=key, secret=secret).

5. Confirm connectivity by calling client.get_server_time() and verifying the response contains a valid Unix timestamp.

Placing and Managing Futures Orders

1. Construct an order payload specifying symbol (e.g., PI_XBTUSD), side (buy or sell), size, and order type (limit, market, stop).

2. Submit the order using client.send_order(...), which returns a structured response containing order_id, status, and filled_size.

3. Cancel an active order with client.cancel_order(order_id) and validate the cancellation status in the returned JSON.

4. Retrieve open orders using client.get_open_orders(), filtering by symbol or order ID when necessary.

5. Monitor real-time fills by polling client.get_fills() or integrating with Kraken’s WebSocket feed for execution events.

Handling Margin and Position Data

1. Fetch current margin requirements per contract with client.get_margin_requirements(symbol='PI_XBTUSD').

2. Query open positions via client.get_open_positions(), inspecting fields like size, mark_price, and unrealized_pnl.

3. Adjust leverage for a position using client.set_leverage(symbol='PI_XBTUSD', leverage=5), subject to Kraken’s tiered margin rules.

4. Close a position explicitly by submitting an opposing market order matching the current size, or use client.close_position(symbol='PI_XBTUSD').

5. Parse liquidation risk indicators from client.get_account_summary(), particularly margin_level and available_margin.

Frequently Asked Questions

Q: Can I use the same API key for Spot and Futures endpoints?A: No. Kraken requires separate API keys for Spot and Futures services. Keys generated under the Spot API settings lack Futures permissions and will return HTTP 403 on Futures endpoints.

Q: What happens if my order signature expires?A: Kraken enforces a 60-second validity window for signed requests. If the timestamp in the Kraken-Api-Key header differs from server time by more than 60 seconds, the request fails with error code EAPI:Invalid nonce.

Q: How do I interpret the status field in order responses?A: Valid values include accepted, triggered, cancelled, filled, and expired. Each reflects a distinct lifecycle stage governed by price conditions and system processing.

Q: Is there rate limiting on the Futures API?A: Yes. Kraken applies dynamic rate limits based on account tier and endpoint category. Exceeding limits returns HTTP 429 and includes a Retry-After header indicating delay duration in seconds.