{"service":"Routheus","description":"Live DEX token prices and best-route swap quotes across 13 EVM chains (Base, Ethereum, Arbitrum, BSC, Optimism, Polygon and more). Sub-millisecond answers from our own real-time pool-state engine, not a proxy. Executable swap calldata (Permit2), simulation-verified quotes, chained-state arb quoting, token metadata, token search, DEX pools. For AI agents: pay per call in USDC on Base, Polygon, Arbitrum, Avalanche or Solana via x402 — no API keys, no subscription. From $0.001 per call; failed answers are free.","x402Versions":[1,2],"scheme":"exact","pay_to":"0x3c90C25c8d83D3FFD334d5aF2CEc5A5f256896A9","payment_networks":[{"network":"base","caip2":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","eip712_name":"USD Coin","eip712_version":"2","decimals":6,"v1":true,"facilitator":"cdp"},{"network":"polygon","caip2":"eip155:137","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","eip712_name":"USD Coin","eip712_version":"2","decimals":6,"v1":true,"facilitator":"cdp"},{"network":"arbitrum","caip2":"eip155:42161","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","eip712_name":"USD Coin","eip712_version":"2","decimals":6,"v1":false,"facilitator":"cdp"},{"network":"avalanche","caip2":"eip155:43114","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E","eip712_name":"USD Coin","eip712_version":"2","decimals":6,"v1":true,"facilitator":"payai"},{"network":"solana","caip2":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","eip712_name":"","eip712_version":"","decimals":6,"v1":true,"facilitator":"payai"}],"facilitators":{"payai":"https://facilitator.payai.network","cdp":"https://api.cdp.coinbase.com/platform/v2/x402"},"free_tier":{"products":["quote","quote_calldata"],"limits":{"quote":"4/min per IP","quote_calldata":"2/min per IP"},"note":"Single-input quote and calldata are FREE, rate-limited per IP. Free responses include the output amount, gas, route shape and the executable transaction (enough to test and execute a swap); full route info (pool addresses, per-leg amounts) and simulation are available in the paid quote. Pay per call via x402 for full route data, simulated quotes, chained-arb, multi-input batches, and higher limits."},"chains":["arb","ava","base","ber","bsc","eth","gno","hem","hyp","opt","pol","rob","son","uni"],"products":[{"kind":"quote","method":"GET","path":"/{chain}/api/router/quote","price_usdc":"0.005","price_atomic":"5000","unit":"per input amount (10% off on multi-input batches)","summary":"Live DEX token price and best-route swap quote for any token pair by contract address: output amount and split routing, sub-millisecond from our own pool-state engine — not an aggregator proxy. Batch up to 50 amounts via amounts_in.","params":"token_in, token_out, amount_in (or amounts_in), slippage_bps","free_tier":true,"example":"https://routheus.xyz/base/api/router/quote","request_example":"https://routheus.xyz/base/api/router/quote?token_in=0x4200000000000000000000000000000000000006&token_out=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amount_in=1000000000000000000","response_example":{"ok":true,"chain_id":8453,"amount_in":"1000000000000000000","amount_out":"1803691796","gas_estimate":249129,"route":[{"share":1.0,"amount_in":"1000000000000000000","amount_out":"1803691796","hops":[{"pool":"0x72AB388E2E2F6FaceF59E3C3FA2C4E29011c2D38","type":"UniswapV3","token_in":"0x4200000000000000000000000000000000000006","token_out":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}],"fee_bps":1}},{"kind":"quote_calldata","method":"GET","path":"/{chain}/api/router/quote","price_usdc":"0.01","price_atomic":"10000","unit":"per input amount (10% off on multi-input batches)","summary":"Ready-to-sign DEX swap transaction: best route plus executable calldata (Permit2 supported), expected output and min-out at slippage. Add to=<recipient>; add with_permit2_data=true for a Permit2 template with signature placeholders.","params":"same as quote + to, with_permit2_data","free_tier":true,"example":"https://routheus.xyz/base/api/router/quote","request_example":"https://routheus.xyz/base/api/router/quote?token_in=0x4200000000000000000000000000000000000006&token_out=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amount_in=1000000000000000000&to=0xYourRecipientAddress00000000000000000000&with_permit2_data=true","response_example":{"ok":true,"chain_id":8453,"amount_in":"1000000000000000000","amount_out":"1803691796","gas_estimate":249129,"route":[{"share":1.0,"amount_in":"1000000000000000000","amount_out":"1803691796","hops":[{"pool":"0x72AB388E2E2F6FaceF59E3C3FA2C4E29011c2D38","type":"UniswapV3","token_in":"0x4200000000000000000000000000000000000006","token_out":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}],"fee_bps":1,"min_amount_out":"1794673337","tx":{"to":"0x0000000000b12B7895f5EeB5ca60c1eDCB5A4e08","data":"0x…","value":"0","chainId":8453},"tx_permit2":{"to":"0x0000000000b12B7895f5EeB5ca60c1eDCB5A4e08","data":"0x…(template with zeroed nonce/deadline/signature)","value":"0","chainId":8453,"nonce_offset":164,"permit_deadline_offset":196,"signature_offset":420,"signature_length":65}}},{"kind":"quote_sim","method":"GET","path":"/{chain}/api/router/quote","price_usdc":"0.02","price_atomic":"20000","unit":"per simulated amount (10% off on multi-input batches)","summary":"Simulation-verified swap quote — amount_out IS the onchain eth_call result, not an estimate. For agents that must not overquote. Failed simulations are free.","params":"same as quote/calldata + simulate=true","free_tier":false,"example":"https://routheus.xyz/base/api/router/quote","request_example":"https://routheus.xyz/base/api/router/quote?token_in=0x4200000000000000000000000000000000000006&token_out=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amount_in=1000000000000000000&simulate=true","response_example":{"ok":true,"chain_id":8453,"amount_in":"1000000000000000000","amount_out":"1803210544","gas_estimate":249129,"route":[{"share":1.0,"amount_in":"1000000000000000000","amount_out":"1803691796","hops":[{"pool":"0x72AB388E2E2F6FaceF59E3C3FA2C4E29011c2D38","type":"UniswapV3","token_in":"0x4200000000000000000000000000000000000006","token_out":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}],"fee_bps":1,"simulation":{"success":true,"amount_out":"1803210544","gas_used":121843}}},{"kind":"quote_arb","method":"GET","path":"/{chain}/api/router/quote","price_usdc":"0.03","price_atomic":"30000","unit":"per request (not combinable with simulate or amounts_in)","summary":"EXCLUSIVE chained-state quoting for arbitrage sizing and MEV bundles (quote_on_top_of_amounts): final output as if prior in-flight swaps already executed, up to 8 chained amounts. No other x402 API offers this.","params":"same as quote/calldata + quote_on_top_of_amounts=a,b,c","free_tier":false,"example":"https://routheus.xyz/base/api/router/quote","request_example":"https://routheus.xyz/base/api/router/quote?token_in=0x4200000000000000000000000000000000000006&token_out=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amount_in=1000000000000000000&quote_on_top_of_amounts=500000000000000000","response_example":{"ok":true,"chain_id":8453,"amount_in":"1000000000000000000","amount_out":"1803691796","gas_estimate":249129,"route":[{"share":1.0,"amount_in":"1000000000000000000","amount_out":"1803691796","hops":[{"pool":"0x72AB388E2E2F6FaceF59E3C3FA2C4E29011c2D38","type":"UniswapV3","token_in":"0x4200000000000000000000000000000000000006","token_out":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}],"fee_bps":1,"on_top_of_amounts":["500000000000000000"]}},{"kind":"token_metadata","method":"GET","path":"/{chain}/api/tokens/metadata","price_usdc":"0.003","price_atomic":"3000","unit":"per request","summary":"ERC-20 token metadata by contract address: name, symbol, decimals, balance storage slot. Cache-only; unknown tokens return an error (never charged).","params":"token","free_tier":false,"example":"https://routheus.xyz/base/api/tokens/metadata","request_example":"https://routheus.xyz/base/api/tokens/metadata?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","response_example":{"ok":true,"data":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"name":"USD Coin","symbol":"USDC","balance_slot":{"slot_type":"solidity","slot_number":9}}}},{"kind":"token_search","method":"GET","path":"/{chain}/api/tokens/search","price_usdc":"0.003","price_atomic":"3000","unit":"per request","summary":"Search tokens by symbol, name or contract address — resolve a ticker to the right contract before quoting; returns addresses and pool counts (paginated).","params":"query, page, page_size","free_tier":false,"example":"https://routheus.xyz/base/api/tokens/search","request_example":"https://routheus.xyz/base/api/tokens/search?query=USDC","response_example":{"ok":true,"total":139,"page":1,"page_size":20,"total_pages":7,"tokens":[{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","name":"USD Coin","decimals":6,"pool_count":12062}]}}],"notes":["Pay in USDC on ANY listed payment network — every 402 offer carries one accepts entry per network; pick one.","Both x402 v1 (X-PAYMENT header, JSON body offer) and v2 (PAYMENT-SIGNATURE header, base64 PAYMENT-REQUIRED offer header) are supported. Arbitrum is v2-only (the frozen v1 client can't express it); every other network works on both.","x402-fetch (v1) defaults to a 0.10 USDC per-request spend cap — raise maxValue for large simulated/calldata batches, or they fail client-side after the 402.","Payment is only settled for successful responses; upstream errors, failed simulations and {\"ok\":false} answers are never charged and the payment authorization can be reused.","One payment authorization (nonce) pays for exactly one served response.","Multi-input quotes (amounts_in, up to 50) are priced per amount with a 10% batch discount.","With simulate=true the returned amount_out IS the simulated on-chain result — what you'd actually receive, not a local estimate.","Quote responses with to= include ready-to-send transaction calldata; with_permit2_data=true returns a Permit2 template plus byte offsets (nonce_offset, permit_deadline_offset, signature_offset) where the caller splices their EIP-712 Permit2 signature.","Token metadata is served from the local index only — unknown tokens return an error, no on-demand RPC lookups.","Only the documented query parameters are accepted; anything else is ignored.","The {chain} path segment accepts aliases: canonical slug, chain name, or EIP-155 chain-id — /eth, /ethereum and /1 are equivalent. See /chain-peers for the full alias map."],"links":{"landing":"https://routheus.xyz/","openapi":"https://routheus.xyz/openapi.json","well_known":"https://routheus.xyz/.well-known/x402","chains":"https://routheus.xyz/chain-peers","llms_txt":"https://routheus.xyz/llms.txt"},"contact":{"email":"contact@routheus.xyz","note":"Questions, higher rate limits, a custom/enterprise plan, or a private deployment? Email us — we tailor limits and pricing for high-volume and integration partners."}}