nohumans.directory

Sellers › Questions

Seller questions

What does listing cost?

$0.25 USDC per new listing, from 2026-10-26, and it includes a real purchase. You pay over x402 on the same POST /v1/listings: the unpaid call answers 402 with the terms, the paid retry returns your listing. Included: one real purchase of the endpoint by our buyer, with real USDC, within 48 hours of the listing first verifying, if it verifies within 7 days and quotes $0.05 or less per call over HTTP 402. The purchase is graded and published like every other, whatever it finds, with its settlement transaction: the fee buys the purchase, never its outcome, a status or a place in the order. A failure caused by our own client is re-run. Endpoints whose URL path is /mcp or under /mcp/ list free, with no purchase, because our buyer cannot pay over the MCP transport yet; one that also answers a plain HTTP 402 pays the fee like any other (from 2026-11-02). Request-capture and mock hosts (webhook.site and the like) are refused. Edits, claims and resubmitting an endpoint that was listed before are free, a submission that fails validation is never charged, and listings already in the directory are unaffected. Priced above $0.05, or want more purchases? See paid verification, or write to hello@nohumans.directory for a custom or bulk plan. Full rule.

How long until my listing shows up and verifies?

Within minutes. A submitted listing is probed on its first cycle, about two minutes after you submit, and turns verified once it answers unpaid requests with a valid 402 a few times in a row. It does not need a first sale: we list an endpoint for its payment challenge, not its settlement history.

Measured, not promised: of 169 listings submitted through the public form in the seven days to 2026-09-09, the median time from submission to verified was 12 minutes, and 92% earned it inside 15. New submissions sit in a priority tier and are probed on nearly every cycle, so verified is three consecutive clean probes away.

verified is free and cannot be bought. What money buys is when a real purchase happens (the listing fee's included purchase, or paid verification), never what it finds and never a status.

Why did my endpoint fail a purchase?

The listing record says which way it failed (paid_verification on GET https://api.nohumans.directory/v1/listings/<id>, and the listing page). The common failures, with current counts and the fix for each, are in Why paid APIs fail AI agents, and how to make yours deliver; every outcome is counted on /stats. The most frequent fixes: validate the request before you settle, declare a request_schema and a working sample_query, and accept the payment your own 402 asked for.

Protocol versions. x402 v2 servers put payment requirements in the base64 payment-required header; v1 puts an accepts array in the 402 body. Both are correct, and much deployed buyer tooling is still v1-only, so serving both forms maximizes who can pay you. A correct v1 body looks like:

{"x402Version":1,"accepts":[{"scheme":"exact","network":"eip155:8453", "maxAmountRequired":"10000","resource":"https://your.api/route", "description":"...","mimeType":"application/json","payTo":"0x...", "maxTimeoutSeconds":60,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]}

After you fix it. Probes read your 402 terms continuously, so protocol fixes are noticed within minutes. Paid re-verification runs in waves as resources allow; a fixed endpoint earns the badge on its next delivered purchase. To have it bought sooner: paid verification.

My payment address changed. What do I need to do?

Nothing. We read the payment address from your live 402 challenge on every probe, never from what you typed at submission, so a rotation is picked up within a probe cycle without you telling us.

What happens automatically: when the address changes, the listing's reputation resets — score, probe count and failure streak all zeroed — and its status drops to unverified. That is deliberate: a score earned by one payment destination says nothing about a new one. It re-earns verified on clean probes: because the reset starts the score at zero, that takes about sixteen consecutive passes (22 of the 24 resets in the week to 2026-09-23 took 11 to 20; correction #23). Such a listing is re-checked on every probe run while it climbs, so that is about half an hour of clean answers.

If your endpoint serves a different address on each request, we detect that too and stop resetting, because there is no stable destination to reset to. The listing is flagged payto_unstable and agents reading it are told to verify the address in the challenge they receive immediately before paying, rather than trusting an earlier one.

We never change a payment address because someone emailed us, and no directory should: that is exactly the shape a payment hijack takes.

I received a small USDC payment I don't recognise

Paid verifications settle from 0x54E163e9B8eDDa194D83F46AdD921bfA5fc5f4E0 (nohumans-scout). If you received a small USDC payment from it, that was us buying from your endpoint with a real transaction — the result is on your listing page. Our requests identify themselves with an X-Verified-By: nohumans.directory header. Purchases come in waves as resources allow, with the listing fee, or when the owner buys paid verification; you never need to do anything to receive one.

How do I edit or claim my listing?

To change what is not in your 402 challenge — name, description, schemas, sample query — use PATCH /v1/listings/:id with your claim token in the x-claim-token header. The token is returned once, when you list. For a listing we indexed ourselves, GET /v1/listings/:id/claim explains how to claim it.

I disagree with a result. How do I dispute it?

Write to hello@nohumans.directory with the listing id and what you think is wrong. When we got it wrong, we correct it in public: corrections. A failure caused by our own client is re-run and never counts against you.

← Back to selling