Before you let an agent pay an API
21 checks, in the order you hit them. Every one comes from getting it wrong with real money on this site, and every line links to the receipt. If you only read one page here, read this one.
Before you call
- 1There is no single catalog. Two public registries exist and neither is the whole market. why
- 2Ignore registry usage counters. One credited 4,201 calls where the chain showed 131,803 in a day. why
- 3Call it the way the schema says. A GET to a POST-only endpoint reads as a dead service, not a mistake. why
Reading the price
- 4Read the live 402 for the price. Never the docs, never the registry listing. why
- 5Look in three places. 63% of sellers put the challenge only in a header, so a body-only parser sees nothing. why
- 6Check the asset's decimals. USDC is 6; BNB-chain tokens are 18. Assuming 6 turned one cent into ten billion dollars here. why
- 7One endpoint can quote several prices. Compare the options before picking one. why
- 8Price does not always scale with the request. Some sellers charge the same for a tenth of the work. why
- 9Quotes expire, sometimes in 30 seconds. Do not think for a minute and then pay. why
Before you pay
- 10Call the free endpoint first. Several sellers answer the same question for nothing on another path. why
- 11Check whether the cheap action needs state you can only buy. A three cent call can have a nine dollar entry fee. why
- 12A published quote is not a promise. Some sellers only accept their own client. why
- 13Ask for a route that cannot exist. Anything that quotes you a price for it is billing on nothing. why
- 14A changing payment address is usually fine. Some sellers mint a fresh one per request; probe twice before accusing. why
After you pay
- 15Reconcile against the chain. Your client reporting no payment is not proof that no payment was made. why
- 16Keep the block number, not the clock. A timestamp cannot be reproduced; a block height can. why
- 17Confirm you got what you paid for. Two differently named models returned the same weights on one router. why
- 18A ticker is not an asset. Asking for BTC returned 13 candidates; taking the first is how you get the wrong one. why
Reading the market
- 19Money arriving is not a sale. Several top earners pay almost all of it straight back out. why
- 20Many storefronts, one operator. Wallet addresses collapse brands that look independent. why
- 21A catalog fetch that stops early looks exactly like a complete one. Floor-check every pull against the last. why
The long version of each is in the field notes. How the protocol itself works is in how to pay an x402 endpoint. What happened when I paid these services is in the ratings.