true402
for data providers

List in
one POST.

Free to list — no stake, no approval, no review queue. Buyers pay you directly, at your own address: true402 never holds the money and takes no cut. What a listing buys you is discovery. Read §04 before you count on it buying you a ranking.

§01 · publish

Describe your stall.

Serve a small manifest at your domain. It states what you sell, the price, and the wallet that gets paid.

x402-service.json 
// served at https://my-service.example.com/.well-known/x402-service.json
{
  "x402": "1.0",
  "name": "my-microclimate-feed",
  "capabilities": ["data", "temperature"],
  "pricing": { "currency": "USDC", "base": "0.002", "unit": "request" },
  "payment": {
    "address": "0xYourWallet",
    "chain": "base",
    "facilitator": "https://pay.openfacilitator.io"
  },
  "endpoint": "https://my-service.example.com/v1/feed"
}
§02 · register

One call. No gatekeeper.

Hand the registry your URL. It pulls your manifest and indexes you. No account, no review queue.

bash 
curl -X POST https://true402.dev/api/v1/services \
  -H 'content-type: application/json' \
  -d '{"url":"https://my-service.example.com"}'

# The registry fetches /.well-known/x402-service.json from your URL
# (SSRF-guarded), or falls back to a manifest you include in the body.
§03 · get paid

Keyless income.

Your endpoint returns 402 with your payment requirements; the buyer signs USDC to your address; the facilitator settles it on-chain. You never sign or pay gas to receive — the wallet only ever collects.

We are not in that payment. The authorization the buyer signs names your address, not ours. true402 never takes custody, takes no cut, and cannot reverse, freeze or claw back a settlement. The flip side is that we never see it either — which is what §04 is about.

§04 · reputation

Ranked by what we can see.

The catalog ranks on a Trust Score built from settlements, and it is a good formula: distinct settled counterparties weighted highest (one wallet paying itself in a loop is cheap; trade from many independent wallets is not), then settled volume, success rate, recency, and listing age as a tie-break.

Every one of those signals is read from our own payment ledger. Your buyers pay you directly, at your address, so none of your settlements are in it — and nothing in true402 today ingests settlement history from anywhere else: no attestation you can upload, no indexing of your address on-chain. So, flatly:

  • A third-party listing scores zero, however much it actually sells. The signals that would lift it can’t be fed.
  • Among listings on zero, the order is fixed — true402’s own stalls first, then the oldest registration, then id. Registering earlier moves you past other listings on zero. That is all it moves you past.
  • If the registry fills up, the rows reclaimed to make room are the ones with no recorded settlements and more than thirty days on the clock, oldest first — which today is every third-party listing. Re-listing is the same single POST.
  • Nobody outranks you for money either. There is no paid placement and no moderation. The ranking simply has nothing to say about you.

None of that is a judgement on your service, and you can’t trade your way out of it. It falls out of the same design that keeps us out of your money: we can’t rank what we can’t see, and we would rather not see it than sit in the middle of it. List for the discovery — the free, machine-readable catalog, /v1/services and the /.well-known/ manifests that agents actually read — and price that at what it is worth to you.