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.