{"uid":"cap_hNMSWkIqUBW-UIEfou9Uj","slug":"defi-oracle-best-swap-route-finder-800fa1f1","name":"DeFi Oracle — Best Swap Route Finder","description":"DeFi data for AI agents — yield rates, swap routes, IL calculator, liquidation risk, MEV scanner, TVL tracking. Powered by DeFiLlama + on-chain RPC data. Pay with USDC on Base via x402.","url":"https://aracil.vercel.app/api/best-route","method":"POST","headers":{},"bodySchema":{"type":"object","required":["to_token","from_token"],"properties":{"chain":{"type":"string"},"to_token":{"type":"string","description":"Target token symbol"},"amount_usd":{"type":"number"},"from_token":{"type":"string","description":"Source token symbol"}}},"responseSchema":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"chain":{"type":"string"},"all_routes":{"type":"array"},"amount_usd":{"type":"number"},"best_route":{"type":"object"},"routes_found":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wKVLKmDIu-r6ULxx7gqXq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds the optimal cross-DEX swap route between two tokens on a specified chain, returning ranked route options with pricing data.","exampleAgentPrompt":"Find the best swap route to trade $500 of ETH to USDC on Base — show me all available routes and which one gives the best deal.","exampleUseCases":[{"title":"Optimal token swap before DeFi trade","prompt":"I want to swap $2000 worth of WBTC into USDC on Ethereum — find me the best DEX route so I get the most USDC for my money."},{"title":"Cross-DEX arbitrage route scouting","prompt":"Compare all available swap routes from ARB to ETH on Arbitrum for a $500 trade and tell me which one is the most efficient."},{"title":"Stablecoin swap routing","prompt":"I need to convert $1000 USDC to DAI on Base — which swap route gives me the best rate right now?"}],"resultDescription":"Returns a best_route object with the optimal swap path, an all_routes array listing every discovered route ranked by efficiency, the total number of routes found, and echoed inputs including from/to token symbols, chain, and amount in USD.","failureModes":["Unsupported token symbols result in no routes found","Invalid or unsupported chain name causes an error response","Token pair with no liquidity returns empty routes array","Malformed request body missing required fields returns validation error","Network or RPC connectivity issues may cause timeouts or stale data"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically identify the best on-chain swap route between two tokens before executing a trade, or when comparing DEX routing options across liquidity pools. It is particularly useful for agents managing DeFi portfolios, executing token swaps optimally, or building trade strategies that require route-level detail rather than just a price quote.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:24.287Z","isFirstParty":false}