# DeFi Oracle — Best Token Swap Route Finder

> DeFi Oracle — Best Token Swap Route Finder is a paid API for AI agents from oraclius.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Finds the optimal swap route between two tokens on a specified chain, returning ranked route options with pricing details

## Facts

- Endpoint: POST https://oraclius.vercel.app/api/best-route
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-oracle-best-token-swap-route-finder-55cf8769
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xFOSzW2lPcvXNNIDQmYlh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability defi-oracle-best-token-swap-route-finder-55cf8769 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-oracle-best-token-swap-route-finder-55cf8769/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oraclius.vercel.app](https://www.zero.xyz/host/oraclius.vercel.app/llms.txt)