{"openapi":"3.1.0","info":{"title":"Tolsey","version":"0.1.0","description":"Web tools your agent pays for by the call. x402 v2 exact · eip155:4663 · USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168. Each settled call emits Toll(id, payer, toolId, amount, requestHash, responseHash) on the TolseyBooth contract. responseHash = keccak256 of the exact response body bytes; requestHash = keccak256(utf8(\"tool\\nurl\\nparamsJSON\\nnonce\")). Not audited."},"servers":[{"url":"https://tolsey.xyz"}],"paths":{"/v1/paid/read":{"get":{"operationId":"paid_read","summary":"Page → clean Markdown of the main content: { title, byline, markdown, wordCount }","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"Public http(s) page to process"}],"x-x402":{"version":2,"scheme":"exact","network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","payTo":"0x2Fd52CD2d9c78f7B4d977750c833734Db946E5cD","priceUsdg":"0.01"},"responses":{"200":{"description":"Result. Headers: X-Tolsey-Toll-Id, X-Tolsey-Tx, X-Tolsey-Request-Hash, X-Tolsey-Response-Hash, PAYMENT-RESPONSE","content":{"application/json":{}}},"402":{"description":"Payment required: PAYMENT-REQUIRED header (x402 v2). Also returned when settlement fails (body not delivered, nothing charged)."},"4XX":{"description":"Bad input or the page could not be processed: not charged"},"5XX":{"description":"Tool failure: not charged"}}}},"/v1/paid/shot":{"get":{"operationId":"paid_shot","summary":"Page → PNG screenshot (desktop 1440×900 or mobile 390×844; full page capped at 8000 px)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"Public http(s) page to process"},{"name":"device","in":"query","required":false,"schema":{"type":"string","enum":["desktop","mobile"]},"description":"desktop (default) or mobile"},{"name":"full","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]},"description":"1 = full page (height capped at 8000 px)"}],"x-x402":{"version":2,"scheme":"exact","network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","payTo":"0x2Fd52CD2d9c78f7B4d977750c833734Db946E5cD","priceUsdg":"0.01"},"responses":{"200":{"description":"Result. Headers: X-Tolsey-Toll-Id, X-Tolsey-Tx, X-Tolsey-Request-Hash, X-Tolsey-Response-Hash, PAYMENT-RESPONSE","content":{"image/png":{}}},"402":{"description":"Payment required: PAYMENT-REQUIRED header (x402 v2). Also returned when settlement fails (body not delivered, nothing charged)."},"4XX":{"description":"Bad input or the page could not be processed: not charged"},"5XX":{"description":"Tool failure: not charged"}}}},"/v1/paid/table":{"get":{"operationId":"paid_table","summary":"Page → every <table> as JSON arrays (or CSV with format=csv)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"Public http(s) page to process"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"]},"description":"json (default) or csv"}],"x-x402":{"version":2,"scheme":"exact","network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","payTo":"0x2Fd52CD2d9c78f7B4d977750c833734Db946E5cD","priceUsdg":"0.01"},"responses":{"200":{"description":"Result. Headers: X-Tolsey-Toll-Id, X-Tolsey-Tx, X-Tolsey-Request-Hash, X-Tolsey-Response-Hash, PAYMENT-RESPONSE","content":{"application/json":{}}},"402":{"description":"Payment required: PAYMENT-REQUIRED header (x402 v2). Also returned when settlement fails (body not delivered, nothing charged)."},"4XX":{"description":"Bad input or the page could not be processed: not charged"},"5XX":{"description":"Tool failure: not charged"}}}},"/v1/paid/links":{"get":{"operationId":"paid_links","summary":"Page → every link with HTTP status, final URL after redirects and ok/broken (max 200, HEAD then GET)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"Public http(s) page to process"}],"x-x402":{"version":2,"scheme":"exact","network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","payTo":"0x2Fd52CD2d9c78f7B4d977750c833734Db946E5cD","priceUsdg":"0.01"},"responses":{"200":{"description":"Result. Headers: X-Tolsey-Toll-Id, X-Tolsey-Tx, X-Tolsey-Request-Hash, X-Tolsey-Response-Hash, PAYMENT-RESPONSE","content":{"application/json":{}}},"402":{"description":"Payment required: PAYMENT-REQUIRED header (x402 v2). Also returned when settlement fails (body not delivered, nothing charged)."},"4XX":{"description":"Bad input or the page could not be processed: not charged"},"5XX":{"description":"Tool failure: not charged"}}}},"/api/try":{"post":{"summary":"Free demo call (not settled, not on chain). 3/day per IP; holder pass 25/day.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["tool","url"],"properties":{"tool":{"enum":["read","shot","table","links"]},"url":{"type":"string"},"device":{"enum":["desktop","mobile"]},"full":{"type":"boolean"},"format":{"enum":["json","csv"]},"holder":{"type":"string"},"signature":{"type":"string"}}}}}}}},"/api/stats":{"get":{"summary":"Totals read from Toll events of the booth"}},"/api/receipts":{"get":{"summary":"Latest Toll receipts","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","maximum":200}},{"name":"payer","in":"query","schema":{"type":"string"}}]}},"/api/receipt/{tx}":{"get":{"summary":"Toll receipt(s) in one transaction","parameters":[{"name":"tx","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/network":{"get":{"summary":"Gas price, settle cost, tool prices"}},"/api/holder/{address}":{"get":{"summary":"Holder pass status","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}]}}}}