{"uid":"cap_xFOSzW2lPcvXNNIDQmYlh","slug":"defi-oracle-best-token-swap-route-finder-55cf8769","name":"DeFi Oracle — Best Token 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://oraclius.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_FL6OXvdB1b1najGS6lcKl","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 swap route between two tokens on a specified chain, returning ranked route options with pricing details","exampleAgentPrompt":"Find the best swap route to trade $500 USDC for ETH on Base — I want to see which DEX or aggregated path gives me the most ETH for my money.","exampleUseCases":null,"resultDescription":"Returns the best recommended swap route plus all discovered route options, including source/destination token info, chain, USD amount, and total number of routes found. The best_route object contains the optimal path details across DEXes.","failureModes":["Missing required from_token or to_token returns validation error","Unknown or unsupported token symbol returns no routes found","Unsupported chain identifier returns empty or error response","Network or RPC data source unavailable causes timeout or degraded response","Payment of 0.1 USDC on Base via x402 not completed results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when an AI agent needs to identify the most efficient swap path between two specific tokens, especially when comparing multiple DEX routes is important. Prefer this over manual DEX checks when you want aggregated route intelligence powered by DeFiLlama and on-chain RPC data, and when paying per-query via USDC micropayments (x402) is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:50.752Z","isFirstParty":false}