> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useotto.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Otto X402 Router

> Ask what you need; the Router recommends the best x402 services across Otto's verified catalog and the live CDP Bazaar — each with price and pay_url. Non-custodial, zero markup.

The **Otto X402 Router** answers a question every x402 agent hits: *which endpoint do I call for this?* Send one request describing what you need, and the Router returns the best-matching x402 services — ranked across **both** Otto's own verified catalog **and** the live, public [CDP Bazaar](https://docs.cdp.coinbase.com/) — each with its real price and a ready-to-call `pay_url`.

Otto only **recommends**. You pay each service directly at its `pay_url`. There is no prepay wallet, no held balance, and **zero markup** on the downstream services.

**Base URL:** `https://x402.ottoai.services`

The Router is canonical at `x402.ottoai.services/meta-intelligence` — the same host as every other Otto x402 service. (Under the hood it is served by Otto's `open-router` service, fronted by the x402 router as a transparent pass-through.)

**Pricing:** **\$0.001 per call** (USDC on Base) — a flat router fee, never a markup on the services it recommends.

**Custody:** **Meta Intelligence is non-custodial** — it only recommends; you pay each service directly. Otto never holds your funds.

## How it works

Every query returns two clearly-labeled candidate pools — never blended into one anonymous ranked list:

| Pool                     | Source                                                       | Verification |
| ------------------------ | ------------------------------------------------------------ | ------------ |
| `otto_verified`          | Otto's own published x402 endpoints (owned, evidence-backed) | `verified`   |
| `open_bazaar_candidates` | Live CDP Bazaar search (free public marketplace, per-ask)    | `unverified` |

Every candidate row carries blunt `source` and `verification` labels so you always know where a recommendation came from.

<Note>
  `quality_score` now reflects **live-status + on-chain (x402scan) volume** where measured — candidates are ranked by liveness and real on-chain usage, never fabricated ratings. It stays `null` for a candidate until it has been probed/measured, and `uptime_pct` is only populated where directly observed. Otto never fabricates quality signals.
</Note>

## Endpoints

### `POST /meta-intelligence` — Meta Intelligence

The core product. Returns top Otto-verified endpoints plus live CDP Bazaar candidates for your ask.

<Note>
  `POST /meta` remains as a back-compat alias of `/meta-intelligence`.
</Note>

**Request**

```json theme={null}
{
  "ask": "real-time crypto news with sentiment",
  "price_cap_usd": 0.05,
  "network": "eip155:8453"
}
```

| Field           | Type   | Required | Description                                                            |
| --------------- | ------ | -------- | ---------------------------------------------------------------------- |
| `ask`           | string | ✅        | Natural-language description of the data or service you need           |
| `price_cap_usd` | number | —        | Filter to candidates at or below this price (USD)                      |
| `network`       | string | —        | Prefer candidates on this CAIP-2 network (e.g. `eip155:8453` for Base) |

**Response**

```json theme={null}
{
  "ask": "crypto news for bitcoin",
  "classification": {
    "category": "News & Sentiment",
    "intent": "get latest crypto news for bitcoin",
    "keywords": ["crypto news", "bitcoin", "latest"],
    "llm_degraded": false
  },
  "otto_verified": [
    {
      "name": "Crypto News",
      "provider": "Otto AI",
      "price_usd": 0.001,
      "currency": "USDC",
      "network": "eip155:8453",
      "verification": "verified",
      "source": "ours",
      "quality_score": null,
      "uptime_pct": null,
      "sample_output": null,
      "pay_url": "https://x402.ottoai.services/crypto-news",
      "relevance": 0.333
    }
  ],
  "open_bazaar_candidates": [
    {
      "name": "apitoll",
      "provider": "news.apitoll.cloud",
      "price_usd": 0.001,
      "currency": "USD Coin",
      "network": "eip155:8453",
      "verification": "unverified",
      "source": "cdp-bazaar",
      "quality_score": null,
      "uptime_pct": null,
      "sample_output": { "articles": [] },
      "pay_url": "..."
    }
  ]
}
```

**Example**

```bash theme={null}
curl -s -X POST https://x402.ottoai.services/meta-intelligence \
  -H 'content-type: application/json' \
  -d '{"ask":"crypto news for bitcoin","price_cap_usd":0.05}'
```

Then pick a candidate and pay it directly at its `pay_url` using any x402-compatible wallet or agent — exactly as you would call any other Otto endpoint.

### `GET /stats` — Registry counts

Returns the verified + Bazaar registry counts and the current fence state.

```json theme={null}
{
  "registry": { "verified": 51, "bazaar": 33 },
  "x402Enabled": true,
  "fullAutoEnabled": false,
  "refundsEnabled": true
}
```

### `POST /feedback` — Feedback & Refunds (live)

Rate a paid call and claim a refund. An approved refund returns **only to the original payer** and **never more than you actually paid Otto**, with a **\$10/day** budget cap and a required **≥50-word** entitlement reason (abuse-resistant by design). Live and paid.

## Coming next (not yet live)

One further Router pillar is built behind a fence and is **not live** — it ships once finalized and Founder-armed. Do not depend on it yet:

* **`POST /full-auto` — Full Auto.** The Router picks the best service and pays it on your behalf, at-cost, then returns the data. No prepay, no standing balance — per-call pass-through, zero markup. Returns `503` until armed.

## Discovery

* [Landing page](https://x402.ottoai.services) — interactive endpoint explorer
* [LLM docs](https://x402.ottoai.services/llm.txt) — machine-readable catalog (includes the Router)
* [Discovery doc](https://x402.ottoai.services/.well-known/x402) — x402scan-compatible

## Honesty constraints

| Constraint            | Guarantee                                                                                                                            |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| No held balance       | Meta Intelligence never takes custody — you pay each service directly                                                                |
| Zero markup           | The Router fee is flat \$0.001; downstream services are passed through at their real price                                           |
| Measured quality only | `quality_score` reflects liveness + on-chain (x402scan) volume where measured; `null` until a candidate is probed — never fabricated |
| Blunt source labels   | Every candidate is tagged `ours` / `cdp-bazaar` and `verified` / `unverified`                                                        |