agent.swaps accepts one semantic intent. quote(request) inspects it; create(request, options?) takes the same request, obtains a fresh executable route and never broadcasts the preview. Both size the request the same way.
The request has these fields:
create’s options take a once name, and its result carries the received amount of the destination asset. A quote’s assetSend.amount is the amount it sized. Circuit refuses a swap worth under MINIMUM_SWAP_USD, which circuit:sdk exports, with BELOW_MINIMUM before anything is sent.
A quote is an estimate: it inspects unfunded intents, never simulates source calls and never submits. Create qualifies a fresh route after required funding/setup settles. Each prerequisite and the swap receives a separate operation ID, receipts and deadline; a failed swap may still have observed source debits or partial destination credits. Source amount, recipient, provider selection and explicit minimum remain binding. A review pins expected output less slippage, rounded down to the destination token’s smallest unit with a minimum of one, or a higher inherited or explicit floor. Prerequisite continuations retain that floor; a separately approved review may tighten it, while execution preserves it. Existing approved floors are never implicitly lowered. An ineligible higher-output provider cannot hide an eligible alternative; provider restrictions remain binding. circuit capabilities --resource networks --json lists each network’s gas and dollar assets, wrapper and swapProviders. Across also supports incoming HyperCore and Lighter USDC; a Solana recipient must already have its USDC associated token account. Across never spends from Solana; Solana-source bridges route through Relay or NEAR Intents, and same-chain Solana swaps through Jupiter or NEAR Intents. Jupiter quotes compare its Metis router with a JupiterZ market-maker fill at a firm price; Jupiter lands a JupiterZ fill, and a market maker that declines or lets its quote expire fails the swap with SUBMISSION_REJECTED before anything is sent. ERC-4626 routes run only where the vault router is deployed, which enforces the minimum atomically; a deposit above the vault’s current maxDeposit fails with NO_ROUTE_AVAILABLE before routing. A provider’s route that does not execute in Circuit’s pre-sign simulation fails with PROVIDER_UNAVAILABLE, SLIPPAGE_EXCEEDED when it reverts at its slippage guard, or INSUFFICIENT_BALANCE when the wallet no longer holds the amount; routes Circuit builds itself (wrap, vault, HyperCore, Lighter, Derive and Papertrade) and approvals keep SIMULATION_FAILED. Direct velora quotes use Market v6.2 and are same-chain only. metric quotes Metric’s oracle-priced pools on Ethereum, BNB Chain and Robinhood Chain, same-chain only, through at most one intermediate token, and prices each route onchain; a pool whose latest price has not reached the chain does not quote. Direct cowswap quotes sell ERC-20 tokens through CoW Protocol; the source wallet pre-signs the order in one transaction, a solver batch delivers it within 20 minutes, and an unfilled order expires without moving funds. Direct uniswap quotes use the Uniswap Trading API’s v2/v3/v4 pool routing through Universal Router 2.1.2: the source wallet approves Permit2 once per token without limit, and each swap embeds a Permit2 permit for exactly its input, signed with the swap’s own confirmation. nearIntents (NEAR Intents 1Click) is opt-in: it quotes only when engines names it or confidential is set, same-chain or cross-chain; it delivers HyperCore and HyperEVM USDC but never spends them; the source wallet deposits once to a 1Click address, delivery often takes minutes, and refunds return to the source wallet. Every swap settles as a signed transaction; required ERC-20 approvals receive separate confirmations. Liquidity management is outside the swap API. Circuit compares eligible providers by exact destination output. Quoted USD costs are informational.
Quote returns provider, exact assets/addresses, required assetReceive.minimumAmount (the provider’s executable guarantee, which can exceed the approved floor), venuePriceImpact when available, feeBreakdown and quoteFreshness: { issuedAtMs, ttlMs }. Every eligible route guarantees at least its applicable floor before selection. Route construction may enforce a stricter minimum from the current quote, but never lowers the approved floor. feeBreakdown lists every fee the route reports as { kind, amount?, symbol?, asset?, amountUsd? } with amount in whole tokens. kind is one of network (the source network’s fee for the transactions the wallet signs, paid on top in that network’s fee token), execution (delivery on the destination by a relayer, solver or bridge, including its gas and any destination account activation) liquidity (liquidity providers, pools, solver rebalancing and the routing provider’s own fee) or circuit (Circuit’s own 0.01% fee, on routes that can carry it). execution, liquidity and circuit fees are already taken out of the quoted amounts, so do not subtract them again. Fees come from each provider’s quote; Solana network fees are the exact message fee. Hosted quotes convert any fee the provider reports only in tokens into USD with Circuit’s prices, and circuit run leaves those in tokens. An entry without amounts is charged but not itemized, such as aggregator pool fees priced into the rate; a kind with no entry is unknown, never zero. amountUsd is negative when the provider pays the user. USD values are display facts, never transaction authorization.
Price impact is reflected in expected output; slippage allows additional execution deterioration. Review warns above 2% estimated impact, independently of the 1% default slippage. Reported impact is advisory; swaps have no configurable price-impact cap. Slippage and minimum-output floors do not guarantee a maximum price impact.
HyperCore sides use venue token indices, including USDC "0" and HYPE "150". The hypercore provider transfers native HYPE and venue-linked ERC-20s between Core and HyperEVM. Native HYPE on HyperEVM uses 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee. Direct transfers preserve the wallet; Circle USDC deposits can name another recipient. Decimal conversion rejects dust instead of burning it. ERC-20 withdrawals simulate delivery and check Core HYPE for destination gas; final success requires both observed movements. Other routers determine their token coverage from executable quotes; none swaps two HyperCore assets, which trade as Hyperliquid spot orders. Mode, exact balance, provider currencies and scales are rechecked before submission, without resizing or retrying.
Arc mainnet (ethereum:5042) uses USDC for gas and its canonical dollar asset: the native sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee. Its ERC-20 USDC interface at 0x3600000000000000000000000000000000000000 spends the same balance. Circuit counts that balance once; there is no wrap or unwrap operation. Relay supports Arc bridging with EVM networks, Solana and HyperCore. Across supports Arc↔EVM and Arc→HyperCore, but currently rejects Arc↔Solana pairs. Relay, KyberSwap and Uniswap support same-chain swaps. Across and Uniswap translate native USDC into its ERC-20 denomination: Circuit rounds inputs down to whole micro-USDC, minimum outputs round upward, and Max reserves gas then rounds input downward. Velora and ERC-4626 routing are unavailable on Arc. Agent starting inventory uses native USDC. Native transfers, ERC-20 transfers and raw EVM calls use the shared transaction lifecycle.