Prices a swap between two different tokens across the indexed venues and stores it under a quoteId.

• Cost: 0.01 USDC per call, paid over x402.

• Inputs: sell, buy and amount (required), and optional side, slippageBps, split and hop limits, venues, excludeVenues, taker and ttlSec. Name the wallet that will trade in taker to get readiness.

• Returns: the best plan in best, with routes, safety, warnings and expiresAt. With taker, readiness says whether that wallet holds the input, which approval tradeSwap will need, whether it can pay gas and the swap fee, and the total cost to finish. The quoteId is good until expiresAt (ttlSec, at most 120 seconds). Check safety.verdict before you swap.

• Errors:

  • 400 ticker_not_allowed: sell and buy are 0x addresses. Resolve a ticker with tradeSearch.

  • 400 unsupported_pair: sell and buy must be different assets.

  • 400 unknown_venue: use ids from tradeVenues.

  • 404 token_not_found: no ERC-20 token at that address.

  • 422 no_route, insufficient_liquidity, unsupported_venue or buy_reverts: no tradable route. Stop, or change the trade.

• Next:

  • tradeSwap: turn the quoteId into unsigned transactions. Do it when next is swap. stop means the quote cannot be traded, and nextReason says why: best.executable is false, the verdict is cannot_sell, high_tax or illiquid, readiness.ready is false, the request asked exitRisk stop and the token you buy rated high (nextReason.code exit_risk_high; tradeSwap refuses it with 422), or the sell check was inconclusive because of the token or an unknown cause (nextReason.code sell_unverified; tradeSwap refuses it with 422, including for a sale into USDC). requote means the sell check was inconclusive because it did not finish (a provider error, the call budget, the simulation allowance): quote again shortly, and stop if the second quote also answers requote. tradeSwap still accepts a requote quote: on a token output it re-checks the sell from the recipient wallet, serves the swap if that check passes, and answers 503 rpc_unavailable if the re-check does not finish; on a USDC or pinned output it serves the swap, because the swap's own simulation is the exit. An inconclusive quote is still charged. A sell tax above 1000 basis points (trade.quote.max_sell_tax_bps) is a high_tax verdict: the sell works, the tax is too high to trade (nextReason.code high_tax; tradeSwap refuses it with 422). A sell tax at or above 9000 basis points (trade.quote.honeypot_sell_tax_bps) is a cannot_sell verdict, a honeypot. A tax measured inside the launchpad's launch window reads high_tax with a launch_window warning instead, and the check after the window settles it. exitRisk on the response is the stored exit-risk rating of the token you buy, null when you buy USDC or the token has no rating yet. It is separate from the sell-check verdict: it says whether outside buyers got out, from the trading history. A high level adds an exit_risk_high warning. The request's exitRisk policy is warn by default and leaves next alone; stop answers next: stop on a high level, and only for the token you buy, so it never blocks selling a token to USDC.

Costs 10000 base units (0.01 USDC) per call. Or send an account's key in the ARCGATE-KEY header on the MCP connection to pay in units instead. Payment goes in params._meta["x402/payment"]; use an x402-aware MCP client (see https://docs.arcgate.dev/#arcgate/description/mcp-for-agents).