Skip to main content
Credentials stay outside the SDK. Circuit exposes USD/USDC spot limit orders, not margin, derivatives, withdrawals, or arbitrary quote currencies.
Pairs and assets are venue-namespaced and come from the catalog unchanged: an order names the markets.list() asset exactly, and an allocation balance’s asset equals a catalog base or quote (KRAKEN:XBT, KRAKEN:USD). Monetary values are exact decimal strings. markets.list() returns enabled pairs, minimums, and increments; orderBooks.retrieve returns asks/bids and tickers.retrieve returns ask, bid, last, and volume. Create requires asset, side, type: "limit", base volume, and price; validate: true validates without placing. orders.listOpen({ asset? }), orders.retrieve, and orders.cancel expose only orders durably attributed to this session.

Allocation guidance

Size from the matching agent.allocation.balances entry’s amountRaw and decimals; USD and USDC are never pooled. Inventory includes funds committed to resting orders, so inspect orders.listOpen() when sizing. Allocation guides the agent; venue balances and order limits validate execution. An opposite order unwinds inventory; orders.cancel exits a resting session order. Observed fills use ledger amounts and fee currencies for net inventory; missing or inconsistent ledger evidence fails observation. Writes submit once; failures throw ApiError. krakenMetadata.availableBaseVolume has been removed. Agents using it must switch to the standard balance fields and rebuild; local execution requires the updated CLI.