Chapter 2
The 402 Desk
HTTP has had a status code for 'payment required' since 1997. Nobody used it. Nami does. Ask a question, get a ticket, pay the Desk contract, get your answer.
Panel by panel
One request, one receipt
ドン!
The ticket is the trick.
When Nami answers 402, she signs a ticket for this endpoint, these exact parameters, valid for 30 minutes. Its hash is the request id you pay for. So a receipt can never be reused for a different question, and nobody can pay for you and steal your answer.
Payments go straight to the treasury in the same transaction. The Desk never holds funds.
Live from the chain
The Desk right now
Price board
Read live from the contract. An empty cell means that asset isn't accepted for that endpoint.
| Endpoint | ETH |
|---|---|
| /v1/ask | … |
| /v1/scan/wallet | … |
| /v1/scan/funder | … |
| /v1/scan/hours | … |
| /v1/burner/watch | … |
| /v1/receipt/read | … |
| /v1/pool/crowd | … |
| /v1/pool/check | … |
Latest receipts
Reading the chain…
Building an agent? The API docs show the whole loop with curl and viem.