Is This x402 Endpoint Safe? A Guide for AI Developers
· updated · 4 min read
To know whether an x402 endpoint is safe to pay, check three things before your agent spends anything: that its quote and payout wallet are stable, that it has actually delivered when paid, and that the wallet isn't on a sanctions list. Lumière PayCheck does all three for free and answers with a grade and a clear verdict.
x402 lets an API ask for payment right in its HTTP response. Your agent calls an endpoint, gets back a 402 status with a quote (a price in USDC on Base or Solana, plus the wallet to pay), pays it, and gets the data. There's no account, no API key and no invoice. That's what makes it fast, and it's also why there's no chargeback if something goes wrong. So it pays to know who you're paying first.
What a 402 quote does and doesn't tell you
A quote only proves the endpoint is asking for money. It doesn't tell you:
- Whether the endpoint delivers. Some take the payment and return an error or nothing useful.
- Whether the payout wallet is the seller's. If an attacker swaps the wallet in a quote, your agent pays the attacker.
- Whether the price changed. A quote can quietly go up between calls.
- Whether the wallet is sanctioned. Paying a sanctioned wallet is a legal problem, not just a bad deal.
How PayCheck checks an endpoint
Lumière PayCheck monitors more than 130,000 x402 endpoints, including every endpoint listed in the x402 Bazaar. For each one it:
- Checks the quote every 30 minutes: is it valid, and are the price and payout wallet stable?
- Flags payout-wallet changes that could be a hijack, along with price increases and lookalike sellers.
- Screens wallets against the OFAC sanctions list.
- Makes small real test payments to confirm the endpoint delivers what its listing promises. Every test comes with a receipt signed with an Ed25519 key, so anyone can verify it.
The result is a grade from A to F, a score from 0 to 100, and one of three verdicts:
- proceed: a real paid test delivered, and the endpoint is reliable in monitoring.
- caution: probably works, but something isn't confirmed yet (for example, it hasn't been paid-tested).
- avoid: it failed checks, took money without delivering, or its payout wallet changed unexpectedly.
PayCheck never holds or moves your money. It only checks endpoints and tells your agent whether to pay.
How to check an endpoint
1. By hand
Go to https://lumierepaycheck.org/check, paste the endpoint URL, and you'll see its grade, uptime, price and payout-wallet history, and its paid-test results.
2. A quick grade from code
curl "https://lumierepaycheck.org/v1/score?url=https://api.example.com/x402"This is free and returns the grade, score, verdict and the reasons behind them.
3. Right before your agent pays
Send the url, amount and payTo from the 402 quote. The amount is in atomic units, so $0.01 USDC is "10000" (USDC has 6 decimals).
curl -X POST https://lumierepaycheck.org/v1/check-payment \
-H "content-type: application/json" \
-d '{"url": "https://api.example.com/x402", "amount": "10000", "payTo": "0xYourSellersWallet"}'It answers allow: true or allow: false, with the reasons. Pay only when allow is true. If your agent uses MCP, the same checks are the check_endpoint and check_payment tools on PayCheck's free MCP server.
4. After your agent pays
Report whether you got what you paid for, with the report_outcome MCP tool or POST /v1/report. Send the endpoint URL and the payment transaction (it's verified on-chain), plus whether a response arrived and matched the listing. Reports show up on the endpoint's page, so other developers can see how it treats real buyers.
Checking many endpoints at once
For a large agent or a directory, POST /v1/score/batch grades up to 100 endpoints in one call, and GET /v1/catalog returns the whole graded catalog, 1,000 endpoints per page. Both are paid per call through x402. To see everything one seller runs, open its page in the seller directory.
FAQ
Does PayCheck hold my money? No. It never holds or moves your funds. It checks endpoints before your agent pays and records what happened after.
What's the difference between a 402 quote and a PayCheck grade? A quote is the endpoint's price. A grade is evidence: ongoing monitoring, real paid tests with signed receipts, wallet history and buyer reports.
Can I check an endpoint that isn't in the x402 Bazaar? Yes. Checking one we don't monitor yet adds it, and you can also submit it directly. It joins the catalog once it answers with a valid x402 quote.
Check any x402 endpoint for free before your agent pays it: https://lumierepaycheck.org/check
Related reading
More from the blog
How to Add x402 Payment Checks to Your MCP Server
If your AI agent pays x402 APIs through an MCP server, you can add a safety check before every payment with Lumière PayCheck's free MCP tools. The agent…
How AI Agents Pay for APIs with USDC
AI agents pay for APIs with USDC using x402: the API answers with a price, and the agent signs a USDC payment for exactly that amount and sends it with its…
x402 Seller Checklist: Verify Your Endpoint Before Buyers Pay
Before AI agents pay your x402 endpoint, many of them check it first. This checklist covers what they look at and how to get your endpoint to a proceed…