One read-only service, three ways in: an HTTP API for code, an MCP server for agents, and a pass over x402 for when the free minute is not enough. No key, no account, no cookies. Every answer carries its time and its source.
Free60 unitsa minute per client, HTTP and MCP together. A call is 1 unit, a passport 3, a batch of n addresses ⌈n/10⌉.
Pass · x4020.01 USDCon Base for 10 minutes at 600 units a minute. Version 1 or 2, no account.
MCP7 toolsread-only, on the same limit and the same pass, at https://proofofstock.xyz/mcp.
HTTP API
free
Read-only JSON over GET at https://proofofstock.xyz. A refused request costs nothing; over the limit the answer says when to come back.
GET/verify1 unit
Is this exact contract the issuer's token on this chain? Listed or not, a look-alike or not, with the issuer list it was decided against.
When the free minute is not enough, an agent pays for itself: 0.01 USDC on Base buys 10 minutes at 600 units a minute, ten times the free rate. No account, no key, no card. The payment is x402, version 1 or 2; the answers are the same verdicts as on the free minute.
GET/api/pass0.01 USDC
Buy a pass before you need one. Unpaid it answers 402 with the offer (x402 v1 in the body, v2 in the PAYMENT-REQUIRED header); paid, 200 with the pass and when it ends. It takes no unit of the free minute.
pass 10 min · 600 units/min · about 200 passports a minute
A batch bigger than the free 50, up to 150 addresses in one call (⌈n/10⌉ units of the pass). Without a live pass the answer is the pass's 402, saying why. Only the size is paid for, never the verdict.
curl -s 'https://proofofstock.xyz/verify?chain=base&addresses=<51 to 150 addresses, comma-separated>'
ANYevery route above, and /mcpover the free minute
A client past 60 units in 60 seconds gets the same offer as a 402 instead of a plain 429. Pay it, retry the request with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2), and the call is served with the pass started.
for catalogues/openapi.json describes the paid route, its price and its 402
The same answers for an agent: a public MCP server over streamable HTTP at https://proofofstock.xyz/mcp, no key. Every POST costs 1 unit; the tools below say where a call costs more. Connect an agent.
TOOLfind_stock_token1 unit
Find the issuer's tokens on one chain by ticker, company name or ISIN.
60single checks: /verify, /api/find and the other 1-unit reads
20passports, at 3 units each
600addresses checked, in batches of 50 at ⌈50/10⌉ = 5 units
The window slides by the second: any 60 seconds, wherever a minute begins. The limit is per client address, HTTP and MCP share it, and a pass raises it for that client alone.