Skip to main content
Credentials remain outside the SDK. agent.kraken supports spot limit and trigger orders across the live pair catalog, including non-dollar quote currencies; it excludes margin, derivatives and withdrawals. Kraken orders and order reads require a hosted target; local circuit run rejects them. markets.list() returns namespaced pairs, venue status, native identifiers, minimums and increments. Use its asset unchanged, such as KRAKEN:XBT/USD; allocation assets match catalog base/quote IDs. assets.list() supplies native codes and ledger precision. orderBooks.retrieve({ asset, depth? }) returns asks/bids; depth is a positive integer. tickers.retrieve returns ask, bid, last and volume. orders.create(order, options?) places a spot order with decimal-string base volume; Circuit refuses one below the pair’s live volume or cost minimum with BELOW_MINIMUM before anything is sent. A limit order is { asset, side, volume, price, timeInForce?, expiresAt? }: timeInForce is “gtc” (default, rests), “ioc” (fills what crosses now) or “alo” (post-only, rejected if it would take), and an ISO expiresAt within the next 28 days rests it only until then. { type: "stopLoss" | "takeProfit", triggerPrice } sells or buys at market once Kraken’s last price crosses triggerPrice; the “stopLossLimit” and “takeProfitLimit” forms then rest at price. Paper sessions reject expiresAt. options can retain admitted references. Its result carries orderIds, clientOrderId and averageFillPrice: the size-weighted price of the order’s recorded trades before fees, to 18 decimals truncated toward zero, null when nothing filled; operations.retrieve reports its current value while the order rests. orders.listOpen({ asset? }), retrieve and cancel cover session-attributed orders only. orders.cancel({ orderId }, options?) completes on accepted CancelOrder with result { orderId, count }; retrieve current order details separately. Size from each allocation balance’s quantity, never pooling USD and USDC; credential-wide balances do not establish session ownership. Inventory includes resting-order commitments, so inspect open orders. Venue balances and limits validate execution. Opposite orders unwind inventory; cancel exits a resting order. Observed fills account for net amounts and fee currencies; inconsistent ledger evidence fails observation. Writes submit once and preserve failure evidence.