Check an x402 endpoint before your agent pays it. Settled shows whether it answers, what it charges and whether it delivered, receipt included. Settled probes every x402 endpoint listed with the public facilitator catalogues (Coinbase, PayAI, Dexter, UltravioletaDAO, PayAPI Market) and anything submitted, buys from live ones with real USDC on Base and checks what comes back against the listing, and follows who really pays each seller. Every answer is signed, so your agent can quote it. Anyone can score a seller by looking at it; a receipt is proof. The scout buys and the ledger reads on Base: an endpoint on another network is checked by its probes alone, and the answer says so.
Measured by Settled's own probes, purchases and ledger reads; refreshed every 30 minutes; totals only. x402 by the numbers →
A probe says whether it answers and what it charges, a real purchase says whether it delivered, the ledger on Base says who pays it, and a signature lets you prove what Settled said.
An unpaid request to every endpoint in the four public facilitator catalogs (CDP Bazaar, PayAI, Dexter, UltravioletaDAO), plus anything submitted, on an adaptive schedule. Settled parses the 402 quote and stops. It never pays and never settles.
The scout buys with real USDC and checks the response against the endpoint's own listing: the promised fields, the price actually charged, placeholder data served as content.
Every USDC transfer to the sellers Settled tracks, read from Base block by block, so volume a seller pays itself stands out from real demand. Sellers registered as ERC-8004 agents are matched to their wallets.
Every answer is EIP-191 signed, and the whole index is snapshotted and hash-chained every day. Check any answer at /v1/verify without trusting Settled. Settled itself is ERC-8004 agent #98131 on Base, paid at getsettled.base.eth.
Plenty of venues advertise paid work for agents; far fewer show money leaving escrow. Settled reads venue escrow on Base and the venues' own award records, uses only sanctioned venue APIs, and flags listings built to trap agents: hidden instructions, requests for keys or seed phrases, human-only terms. The weekly Agent Income Report sums it up, and GET /v1/income/venues is free. All venue verdicts →
A check is free from the cache; a paid check is $0.002, a preflight $0.005, a day pass $0.05; sellers claim free and keep Seller Watch from $5.00 a month. Paid routes answer 402 and any x402 client pays and retries; a failed call is never charged. The terms.
All paid over x402 in USDC on Base; a person without an x402 client can buy the pass, the Watchdog, the re-test, Seller Watch and the index export from a browser wallet at /buy.
| Route | Price | What you get |
|---|---|---|
POST /v1/pass | $0.05 | 24-hour pass: preflight, check, endpoints, payto, income and income check, plus every MCP tool except settled_watch, 120 requests/min (endpoint searches up to 1,000 a day) |
GET /v1/preflight?url= | $0.005 | Whether the seller's on-chain sales look real, a fresh probe on both verbs, quote, payability, payee and seller reputation, the scout's purchase result, agent reports and a honeypot scan, as one pay | caution | avoid answer with reasons |
GET /v1/check?url= | $0.002 | Live probe, parsed quote, payability, latency, on-chain activity, quality and flags, plus the scout's last purchase, agent reports and the seller's claim |
GET /v1/endpoints?q= | $0.005 | Live endpoints matching every word of the query (top 50), best match first, then by quality, each with payability and delivery status |
GET /v1/payto/{address} | $0.005 | Seller reputation by recipient address: whether its on-chain sales look organic or self-generated, its payers, endpoints and flags |
GET /v1/income | $0.01 | Open bounties and tasks with honeypot scoring, trust, gating and payout evidence |
GET /v1/income/check?url= | $0.005 | Scan one bounty, repo or listing for agent-bait patterns before working on it |
POST /v1/watch | $2.00 | Watchdog: probes one endpoint about every 15 minutes for 30 days and records a signed alert when its status, payability, price or payTo changes. Renew with its watch_id. Also in MCP as settled_watch. Sellers get the same checks on their own endpoints through Seller Watch |
POST /v1/export | $5.00 | Index export: every endpoint Settled tracks, live and dead, as one gzipped JSON download, with each seller's 30-day on-chain demand, the scout's delivery checks, payability and flags. A link good for 24 hours; free sample |
POST /v1/retest | $2.00 | Seller re-test: the scout buys from your endpoint now and checks the response against your listing. Charged only if it completes a purchase. Claimed sellers get one free a week for endpoints up to $0.25: sign with the payout wallet instead of paying |
POST /v1/seller-watch | $5.00 | Seller Watch: 30 more days for your claimed wallet: 25 of its endpoints checked about every 15 minutes (you choose which), with an alert when one stops being payable, comes back, changes price or asks buyers to pay a different wallet, when a purchase gets nothing usable or not what you listed, and when the wallet goes on hold and when it clears. The first 10 days come free with the claim |
POST /v1/seller-watch/plus | $15.00 | Seller Watch Plus: the same 30 days with up to 250 of the wallet's endpoints checked about every 15 minutes instead of 25. The free 10 days after a claim include it |
| Route | What you get | Limit |
|---|---|---|
POST /mcp | MCP server (Streamable HTTP). Setup | Free: 25 calls a day per address, 300 with a payer record (searches at most 50, 150 with a record) |
GET /v1/free/check?url= | The paid check's answer, from the 5-minute cache | Free: 25 a day per address, 300 with a payer record; shared with MCP |
GET /v1/free/endpoints?q= | The paid endpoint search, from the cache | 50 a day, shared with search over MCP; 150 a day per wallet with a payer record |
GET /v1/watch/{id}/alerts | A Watchdog's alerts since your last check, plus the endpoint's state now | rate-limited |
GET /v1/seller-watch/alerts?wallet= | A claimed wallet's Seller Watch alerts since your last check, with its hold status now | rate-limited |
GET /v1/peek?url= | Coarse status and quality for one endpoint | rate-limited |
GET /v1/deliveries | Every purchase the scout made, its settlement transaction on Base, and whether it matched the listing | rate-limited |
GET /v1/income/venues | Which venues actually pay agents: verdicts from on-chain escrow payouts, policy and gating | rate-limited |
GET /v1/events | Change feed: venue verdict flips, new honeypots, integrity changes | rate-limited |
GET /v1/reports/latest | The weekly Agent Income Report | rate-limited |
GET /v1/observatory/latest | The weekly x402 Payability Observatory, with a CC BY sample of the index | rate-limited |
POST /v1/report | Tell Settled whether a call you paid for worked, proven by your payment | rate-limited |
POST /v1/credentials/payer | Agents: a signed payer record for your wallet, to show sellers that ask with x401. Free until Jan 11, 2027, then $0.10 for 7 days over x402 | 3 a day per wallet |
GET /x401/demo | A live x401 verifier to test a client against: asks for a payer record, checks the answer, stores nothing | rate-limited |
POST /x401/token | Trade a payer record presentation for an hour-long token that lifts free searches to 150 a day for your wallet | rate-limited |
POST /v1/credentials/verify | Sellers: check a payer record an agent showed you (signature, facts, expiry, revocation, key binding) | rate-limited |
POST /v1/claim | Sellers: claim every endpoint paid to your wallet with one signature. Includes 10 days of Seller Watch and a free re-test each week | rate-limited |
GET /v1/claim?wallet= | Whether a wallet is claimed, what the scout bought from it, and when its next free re-test is | rate-limited |
GET /v1/sellers | Claimed sellers and their endpoints | rate-limited |
POST /v1/submit | Add an endpoint to the index | rate-limited |
POST /v1/verify | Check any signed answer; GET /v1/snapshots/latest for the daily signed, hash-chained snapshot of the index | free |
GET /v1/status | Index size and freshness, scout totals, prices | free |
Check your endpoint in the box above: the verdict, the receipt and the badge are what every agent gets before it pays you. Then claim it with one signature from the wallet it is paid to, and show "Checked by Settled" on your site. Claiming shows every endpoint paid to your wallet as yours, on every host; no key files, nothing paid, and claims never change scores. It turns on Seller Watch for 10 days, free, with Plus: up to 250 of your endpoints checked about every 15 minutes, and an alert in the feed and by email when one stops being payable, changes price or payTo, when a purchase from you goes wrong, or when your wallet goes on hold. The scout holds you to your own listing and nothing else, you see what it bought from you, and one re-test a week is free; any other is $2, charged only if it completes a purchase. How to pass the checks · What our crawlers do.
In Claude Code: claude mcp add --transport http settled https://settled.tools/mcp. In Node or Python, settled-x402 checks each payment before it is signed and holds it to the limits you set; on Amazon Bedrock AgentCore, n8n or plain HTTP, the same check runs before the money moves.
$ claude mcp add --transport http settled https://settled.tools/mcp
$ npm install settled-x402 # then wrap your x402 client: # settledGuard(new x402HTTPClient(client), { maxUsdPerCall: 1, dailyBudgetUsd: 5 })
$ pip install settled-x402 "x402[clients]" # then wrap your x402 client: # settled_guard(x402HTTPClient(client), max_usd_per_call=1, daily_budget_usd=5) # on Amazon Bedrock AgentCore: plugins=[payments, SettledStrandsPlugin(max_usd_per_call=1)]
$ mkdir -p ~/.settled-x402 && (umask 077; openssl rand -hex 32 > ~/.settled-x402/proxy-key) $ npx -y -p settled-x402 -p @x402/fetch@2 -p @x402/evm@2 -p viem@2 settled-x402 proxy --max-usd-per-call 0.25 --daily-budget-usd 5 # send the wallet it prints a few dollars of USDC on Base, then # import settled.tools/n8n/settled-pay-through-proxy.json into n8n
$ curl "https://settled.tools/v1/free/check?url=https://api.example.com/search" # free, cached: 25 a day, 300 with a payer record $ curl -i "https://settled.tools/v1/preflight?url=https://api.example.com/search" # HTTP/1.1 402 Payment Required: pay $0.005 with any x402 client, then retry
Build your setup in the Loadout → Listed on Smithery and the official MCP Registry, and on npm and PyPI as settled-x402. Full setup for agents →