# Ozmium Arbitrage Route Ranker

> Ozmium Arbitrage Route Ranker is a paid API for AI agents from ozmium.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns ranked, fee-netted arbitrage routes into a target token on Base, comparing DEX vs Coinbase CDP swap prices across multiple input assets for a given USD budget.

## Facts

- Endpoint: GET https://ozmium.org/v1/arbitrage
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ozmium-arbitrage-route-ranker-45ef277f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PcjY_qy4yrNxq_5WzThQ6

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 ozmium-arbitrage-route-ranker-45ef277f
```

Example prompt: I have a $500 budget and want to buy USDC on Base — can you check all the liquid input tokens like ETH, cbBTC, and cbETH and rank which one gives me the best net dollars after gas and fees if I swap into that target token with 50 bps slippage tolerance?

## When to prefer this

Use this endpoint when an AI agent needs to determine the optimal input token and venue for acquiring a specific Base token given a USD budget, especially when comparing DEX-vs-Coinbase venue arbitrage across multiple cross-asset paths (USDC, ETH, WETH, cbETH, cbBTC, cbADA, cbXRP). Prefer this over generic DEX aggregators when you need fee-netted, real executable pricing ranked by actual net profit rather than raw swap output.

## Known failure modes

- Missing required 'target' or 'budget' query param returns a 400 or error response
- Invalid taker address format may return a validation error
- No liquid routes found for specified target token returns empty routes array
- Coinbase CDP pricing temporarily unavailable causes degraded or stale route data
- Extremely low budget may yield zero or negative net USD for all routes
- Unsupported target token returns empty or error response

## How this service works

Ranked, fee-netted arbitrage routes into a target token on Base. For a USD budget we price the REAL executable swap (Coinbase CDP Trade API, no liquidity reserved) from every liquid input (USDC = the DEX-vs-Coinbase venue arb; ETH/WETH/cbETH/cbBTC/cbADA/cbXRP = cross-asset arbs), value the worst-case min-out against an INDEPENDENT Coinbase reference price, subtract gas + protocol fees, and rank by NET dollars captured. Full details: GET /v1.

## Output

An array of ranked arbitrage routes, each showing the input token (from), the target token (to), and the net USD captured after subtracting gas and protocol fees, ordered from most to least profitable. The response also includes the network identifier (Base mainnet).

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "taker": {
       "type": "string"
      },
      "budget": {
       "type": "string"
      },
      "target": {
       "type": "string"
      },
      "slippageBps": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "routes": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "to": {
            "type": "string"
           },
           "from": {
            "type": "string"
           },
           "netUsd": {
            "type": "number"
           }
          }
         }
        }
       }
      },
      "network": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ozmium-arbitrage-route-ranker-45ef277f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ozmium.org](https://www.zero.xyz/host/ozmium.org/llms.txt)