# NetIntel Router

> Which x402 endpoint should I call? The NetIntel Router ranks the whole Coinbase Bazaar catalog of pay-per-call endpoints for a job described in plain words — by fit, real paying demand (distinct wallets in 30 days), health (our own payment-challenge checks) and price — and explains every pick. Search is free; recommend health-checks the best matches live; vet checks one endpoint you already chose. Paid calls use x402 (USDC on Base or Solana), no API key, and are never charged when there is nothing to answer.

## Endpoints

### GET /route/search — free
Ranks the live catalog for a job described in plain words: up to 25 endpoints (default 10), each with price, paying wallets in 30 days, our last health check, the raw signals and a plain-words why[]. Stored health only (recommend checks live). 60 searches an hour per client.

Parameters:
  - `q` (required): the job, in plain words (2-300 characters)
  - `limit`: 1-25

Example: https://router.netintel.dev/route/search?q=check%20SPF%20DKIM%20DMARC%20for%20a%20domain

### GET /route/recommend — $0.005 per call (x402)
Which x402 endpoint should I call? Describe the job in plain words; get the 3 best endpoints from different providers, each health-checked live just now, with its current price quote, its inputs and the reasons — ranked over the whole Coinbase Bazaar catalog by fit, real paying demand and health. Uncharged when nothing passes.

Parameters:
  - `q` (required): The job, in plain words (2-300 characters)

### GET /route/vet — $0.002 per call (x402)
Is this x402 endpoint working right now? Give one endpoint URL from the Coinbase Bazaar catalog; get a live payment-challenge check, its current price quote, its 7/30/90-day check history and paying-wallet trend, and a plain verdict: ok, slow, unstable or failing. Uncharged when the URL is not in the catalog.

Parameters:
  - `url` (required): The endpoint's resource URL, exactly as the Bazaar lists it
  - `method`: Only when the URL is listed under both methods

## Paying (x402)

- Call a paid endpoint normally. Unpaid, it answers HTTP 402 with the payment requirements (`accepts[]`) in the `PAYMENT-REQUIRED` header (base64 JSON) and in the JSON body.
- Pay with any x402 client: USDC on Base (eip155:8453) or on Solana mainnet, `exact` scheme, then retry the same request with the payment header. No API key, no account.
- You are only charged for an answer: a bad request (400), nothing to answer (404: no healthy match, or a URL not in the catalog) and an outage (503) are never settled.
- After recommend or vet, call the chosen endpoint yourself with your own x402 client; `live_quote` is what it asked for moments ago.

## Daily rankings

- [Rankings page](https://router.netintel.dev/rankings): the top 3 endpoints for each of 40 common agent tasks, updated nightly, with the reasons.
- [rankings.json](https://router.netintel.dev/rankings.json): the same snapshot as JSON.

## How the ranking works

score = 0.6·R + 0.2·D·R + 0.15·H + 0.05·P, where R is fit to the job (0.4 meaning + 0.2 key words + 0.4 coverage of the request's words), D is real demand (min(1, log10(1 + paying wallets in 30 days) / 2)), H is health (1 passed our payment check in under 2 s, 0.6 slow, 0.3 unchecked, 0 failed) and P is price (1 / (1 + price / $0.01)). Only listings in today's catalog with a mainnet rail are ranked; the top three always come from three different providers. Full method: https://router.netintel.dev/rankings#how

## Independence

NetIntel also sells pay-per-call endpoints (https://netintel.dev). They are labeled `provider: "netintel"`, ranked by the same formula, and get no boost; ties break by URL, never by owner.

## Discovery

- [OpenAPI](https://router.netintel.dev/openapi.json)
- [x402 manifest](https://router.netintel.dev/.well-known/x402)
- [llms.txt](https://router.netintel.dev/llms.txt)