{"uid":"cap_MMwNFyRZ8aVisj0lKwIsx","slug":"1inch-multi-venue-swap-quote-base-chain-749f2bfc","name":"1inch Multi-Venue Swap Quote (Base Chain)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/1inch/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"},"queryParams":{"type":"object","required":["from","to","amount"],"properties":{"to":{"type":"string","examples":["WETH"],"description":"Token out: symbol or 0x address"},"from":{"type":"string","examples":["USDC"],"description":"Token in: symbol (USDC, ETH, WETH, cbBTC, DAI, USDbC, AERO, DEGEN, BRETT, VIRTUAL) or 0x address"},"amount":{"type":"string","examples":["10"],"description":"Amount of token in, human units (e.g. 10 = 10 USDC)"},"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional sender/recipient: returns ready-to-sign tx + allowance/balance check"},"slippage_bps":{"type":"integer","maximum":2000,"minimum":1,"description":"Slippage tolerance in bps (default 50 = 0.5%)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":{"symbol":"WETH","address":"0x4200000000000000000000000000000000000006","decimals":18},"from":{"symbol":"USDC","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6},"hops":1,"chain":"base","price":2224.6,"route":["pmm-2"],"router":"0x6131b5fae19ea4f9d964eac0408e4408b66337b5","source":"kyberswap","gas_usd":0.0319,"min_out":0.00447272,"verdict":"GOOD","cost_pct":-0.73,"guidance":"Good fill. Pass wallet= for ready-to-sign calldata; verify it with /crypto/decode-calldata before signing.","amount_in":10,"amount_out":0.0044952,"l1_fee_usd":0.0015,"net_out_usd":10.0153,"router_label":"KyberSwap MetaAggregation Router v2","slippage_bps":50,"amount_in_usd":9.976,"amount_out_usd":10.0487}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UGokAPgr-7HbUG5Vlmvp_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an aggregated DEX swap quote for a token pair on Base, including best route, price, gas cost, and swap quality verdict, optionally with ready-to-sign calldata.","exampleAgentPrompt":"What's the best swap quote to convert 10 USDC to WETH on Base right now — show me the route, gas cost, and whether it's a good fill?","exampleUseCases":[{"title":"Pre-trade swap price check","prompt":"How much WETH would I get if I swap 50 USDC on Base right now, and is the fill quality considered good? Use 0.5% slippage tolerance."},{"title":"Ready-to-sign swap transaction","prompt":"I want to swap 100 USDC to WETH on Base from my wallet 0xAbCd1234567890abcdef1234567890abcdef1234 — can you get me a ready-to-sign transaction with default slippage?"},{"title":"Gas-aware swap routing decision","prompt":"Compare the gas cost and net output for swapping 500 USDC to cbBTC on Base — I want to know the route used and whether the fees eat into the trade significantly."}],"resultDescription":"A JSON object containing: input and output token details (symbol, address, decimals), best price, swap route array, router address and label, gas cost in USD, L1 fee in USD, amount out in token units, net output in USD, amount in USD, slippage setting, a verdict string (e.g. GOOD), and a human-readable guidance message. If a wallet address was provided, also includes ready-to-sign calldata for the swap.","failureModes":["Unsupported token symbol returns an error or empty route","Insufficient liquidity for the requested amount yields no valid quote","Invalid wallet address format causes a validation error","Network congestion may cause stale or unavailable gas estimates","Very large swap amounts may have no aggregated route available"],"whenToPreferThis":"Use this endpoint when an AI agent needs a real-time, aggregated DEX swap quote on Base chain without managing API keys, especially when wanting a quality verdict and optional ready-to-sign calldata in a single pay-per-call call. Prefer over raw 1inch or KyberSwap APIs when operating in an x402 micropayment environment where API key management is undesirable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:29.303Z","isFirstParty":false,"canonicalSlug":"1inch-multi-venue-swap-quote-base-chain-749f2bfc"}