{"uid":"cap_gznBoLegyDdVMX6WAcEJ_","slug":"3route-token-swap-quote-02b3c274","name":"3Route Token Swap Quote","description":"Best-priced crypto token swaps for agents, traders and apps. Pay-per-call quote & swap API via x402/MPP. No API key or subscription.","url":"https://api.3route.io/v1/%7BchainId%7D/quote?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["chainId"],"properties":{"chainId":{"enum":["1","4663","42793","8453","143","128064"],"type":"string","example":"4663","pattern":"^[0-9]+$","description":"Chain ID for the operation."}},"additionalProperties":false},"queryParams":{"type":"object","required":["src","dst","amount"],"properties":{"dst":{"type":"string","example":"0x5fc5360d0400a0fd4f2af552add042d716f1d168","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address of the token being bought; take one from the token-list operation for the selected chain, or use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset."},"fee":{"type":"number","default":0,"maximum":3,"minimum":0},"src":{"type":"string","example":"0x0000000000000000000000000000000000000000","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address of the token being sold; use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset"},"amount":{"type":"string","example":"1000000000000000000","pattern":"^[0-9]+$","description":"Positive amount of src to sell in smallest units, as an integer string."},"gasPrice":{"type":"string","example":"1000000000","pattern":"^[0-9]+$"},"protocols":{"type":"string"},"includeProtocols":{"type":"boolean","default":false},"excludedProtocols":{"type":"string"},"includeTokensInfo":{"type":"boolean","default":false},"includeBlockNumber":{"type":"boolean","default":false}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"gas":210000,"dstAmount":"950000","srcAmount":"1000000000000000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lSBTzySDWxu67oTKXHWnl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a best-priced swap quote for exchanging one crypto token for another on a specified EVM chain, including estimated output amount and gas cost.","exampleAgentPrompt":"What's the best price I can get swapping 1 ETH (1000000000000000000 wei) for USDC (0x5fc5360d0400a0fd4f2af552add042d716f1d168) on Etherlink chain 42793? Use 3Route to get the quote.","exampleUseCases":[{"title":"Pre-trade price check for DeFi bot","prompt":"Before I execute, get me a quote on 3Route for swapping 500 USDC (address 0x5fc5360d0400a0fd4f2af552add042d716f1d168) for the native asset on Etherlink chain 42793 — tell me how much I'd receive and what the gas estimate is."},{"title":"Best rate comparison for portfolio rebalancing","prompt":"I want to rebalance and sell 2 ETH worth of the native asset (2000000000000000000 wei) for USDC on chain 4663. Can you get me a 3Route quote showing the expected output amount?"},{"title":"Agent swap routing for automated trading","prompt":"My trading agent needs a price quote to swap 1000000 of token 0x0000000000000000000000000000000000000000 into 0x5fc5360d0400a0fd4f2af552add042d716f1d168 on chain 128064 — fetch the best available route and estimated gas from 3Route."}],"resultDescription":"Returns a JSON object with the estimated destination token amount (dstAmount), the source amount used (srcAmount), and the estimated gas cost for the swap. These values allow an agent or trader to evaluate the trade before committing to execution.","failureModes":["Invalid or unsupported chain ID returns an error — only 4663, 42793, and 128064 are supported","Malformed token address (not 0x + 40 hex chars) returns a validation error","Zero or non-integer amount string causes a bad request response","Insufficient liquidity for the requested pair may return no route found","Payment not included or failed x402 payment results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a real-time, best-priced swap quote on Etherlink or supported EVM chains without requiring API key setup or subscriptions. It is ideal for agents that pay per call via x402/MPP and need to evaluate a trade before executing. Prefer this over aggregator APIs that require upfront credentials or subscriptions when operating in a pay-as-you-go agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T12:30:08.538Z","isFirstParty":false,"canonicalSlug":"3route-token-swap-quote-02b3c274"}