{"openapi":"3.1.0","info":{"title":"CRA AGENT data","version":"0.1.0","description":"Arc chain data by the call, paid in USDC over x402: base fees, contract deploys, RPC health, and executed prices for a pair against USDC. Free summaries under /v1, priced detail under /v1/paid.","x-guidance":"CRA AGENT sells Arc chain data by the call over x402, settled in USDC on Arc through Circle Gateway.\n\nFree routes under /v1 need no payment and no signup. Priced routes under /v1/paid answer 402 with the\npayment requirements in the payment-required header; pay with any x402 client and repeat the request.\n\nTwo things worth knowing before you buy. The payment is settled only after the handler succeeds, so a\nfailing endpoint costs you nothing: GET /v1/paid/selftest/fail always answers 500 and is never charged,\nand it is there so you can check that yourself. And every settled payment ends in a USDC transfer on\nArc whose hash you can look up.\n\nPrices range from $0.0005 to $0.005 per call. The Arc network routes (fees, deploys, rpc, fx) are read\nfrom Arc by our own collector. The /arc routes read the chain live. The rest (web, packages, domains,\ncurrency, wiki) return public sources as one clean JSON shape, and every answer names its source. A bad\nparameter answers 400 and an upstream failure 502, and neither is ever charged.","contact":{"name":"CRA AGENT","url":"https://cra-agent.tech"},"license":{"name":"MIT","url":"https://github.com/giupy997/arcagentx402/blob/main/LICENSE"}},"servers":[{"url":"https://api.cra-agent.tech"}],"tags":[{"name":"free","description":"No payment, no signup."},{"name":"paid","description":"Priced per call, paid over x402 in USDC on Arc."}],"paths":{"/v1/network":{"get":{"summary":"Chain head and collector state","description":"Head block, chain id, genesis, blocks collected and how far behind the collector is.","operationId":"v1_network","tags":["free"],"responses":{"200":{"description":"Chain head and collector state","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/fees":{"get":{"summary":"Base fee summary","description":"Base fee now and over the last hours, with the floor and the average cost of a transfer.","operationId":"v1_fees","tags":["free"],"responses":{"200":{"description":"Base fee summary","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/fees/estimate":{"get":{"summary":"Cost of a transaction","description":"Cost in USDC of a transaction with the given gas, at the current base fee.","operationId":"v1_fees_estimate","tags":["free"],"parameters":[{"name":"gas","in":"query","required":false,"description":"Gas the transaction would use.","schema":{"type":"integer","example":21000}}],"responses":{"200":{"description":"Cost of a transaction","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/activity":{"get":{"summary":"Blocks, transactions and operations per hour","description":"Per-hour counts of blocks, transactions and operations by type.","operationId":"v1_activity","tags":["free"],"responses":{"200":{"description":"Blocks, transactions and operations per hour","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/deploys":{"get":{"summary":"Recent contract deploys","description":"The most recent contract deploys seen on chain.","operationId":"v1_deploys","tags":["free"],"parameters":[{"name":"limit","in":"query","required":false,"description":"How many deploys to return, 1 to 200.","schema":{"type":"integer","example":50}}],"responses":{"200":{"description":"Recent contract deploys","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/rpc":{"get":{"summary":"Per-provider RPC observations","description":"Latency and head lag of each RPC endpoint the collector polls.","operationId":"v1_rpc","tags":["free"],"responses":{"200":{"description":"Per-provider RPC observations","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/fx":{"get":{"summary":"Headline executed rate for a pair","description":"Last executed rate and the window summary for a pair against USDC. The size curve and the venues are the paid route.","operationId":"v1_fx","tags":["free"],"parameters":[{"name":"window","in":"query","required":false,"description":"Window in minutes, 5 to 1440.","schema":{"type":"integer","example":60}},{"name":"symbol","in":"query","required":false,"description":"Base token symbol, quoted in USDC.","schema":{"type":"string","example":"EURC"}}],"responses":{"200":{"description":"Headline executed rate for a pair","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/token":{"get":{"summary":"Token burns, payouts and price","description":"Buyback burns, USDC payouts and the executed price of the project token, read from the chain.","operationId":"v1_token","tags":["free"],"responses":{"200":{"description":"Token burns, payouts and price","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/selftest":{"get":{"summary":"Hourly self-test of the rail","description":"Our own wallet buying our own endpoint every hour, plus the endpoint that must fail without charging. Not customer activity.","operationId":"v1_selftest","tags":["free"],"responses":{"200":{"description":"Hourly self-test of the rail","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/health":{"get":{"summary":"Service health","description":"503 when the collector is stalled or lagging behind the chain head.","operationId":"v1_health","tags":["free"],"responses":{"200":{"description":"Service health","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/fees/forecast":{"get":{"summary":"Base fee now and next block","description":"Base fee now and next block, 24h band, utilisation trend, cost per operation type","operationId":"v1_paid_fees_forecast","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Base fee now and next block","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"},"example":{"hint":"pay $0.001 USDC via x402 to get the forecast; free summary at /v1/fees"}}}}}}},"/v1/paid/fees/estimate":{"get":{"summary":"Cost of a transaction at the current base fee","description":"Cost in USDC of a transaction with the given gas at current and next base fee (?gas=21000)","operationId":"v1_paid_fees_estimate","tags":["paid"],"parameters":[{"name":"gas","in":"query","required":false,"description":"Gas the transaction would use.","schema":{"type":"integer","example":21000}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.0005","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"500","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Cost of a transaction at the current base fee","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.0005 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/deploys/history":{"get":{"summary":"Contract deploys, recent and per hour","description":"Recent contract deploys with labels and per-hour history (?limit=200)","operationId":"v1_paid_deploys_history","tags":["paid"],"parameters":[{"name":"limit","in":"query","required":false,"description":"How many deploys to return, 1 to 1000.","schema":{"type":"integer","example":200}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.002","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"2000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Contract deploys, recent and per hour","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.002 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/rpc/health":{"get":{"summary":"Per-provider RPC latency and head lag","description":"Per-provider RPC latency, head lag and error rates, last 15 minutes","operationId":"v1_paid_rpc_health","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.0005","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"500","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Per-provider RPC latency and head lag","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.0005 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/fx/execution":{"get":{"summary":"Executed prices against USDC, by trade size","description":"A pair on Arc as executed against USDC: volume-weighted rate, range, the rate by trade size, and where the volume traded. ?symbol=EURC (default) or any token the collector watches.","operationId":"v1_paid_fx_execution","tags":["paid"],"parameters":[{"name":"window","in":"query","required":false,"description":"Window in minutes, 5 to 1440.","schema":{"type":"integer","example":60}},{"name":"symbol","in":"query","required":false,"description":"Base token symbol, quoted in USDC.","schema":{"type":"string","example":"EURC"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Executed prices against USDC, by trade size","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"},"example":{"hint":"pay $0.001 USDC via x402 for the size curve and venue breakdown; the headline rate is free at /v1/fx"}}}}}}},"/v1/paid/arc/wallet":{"get":{"summary":"Balances, transaction count and account type of an Arc address","description":"USDC and CRA balances, transactions sent and account type (wallet or contract) for any Arc address, read from the latest block.","operationId":"v1_paid_arc_wallet","tags":["paid"],"parameters":[{"name":"address","in":"query","required":true,"description":"A 0x address on Arc.","schema":{"type":"string","example":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.002","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"2000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Balances, transaction count and account type of an Arc address","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.002 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/arc/token":{"get":{"summary":"Name, symbol, decimals and total supply of an ERC-20 on Arc","description":"Name, symbol, decimals and total supply of any ERC-20 on Arc, read from the contract at the latest block.","operationId":"v1_paid_arc_token","tags":["paid"],"parameters":[{"name":"address","in":"query","required":true,"description":"The token contract on Arc.","schema":{"type":"string","example":"0x70857041Fef0CED97F9e01E7Ccc21889AFe3F6F4"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.002","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"2000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Name, symbol, decimals and total supply of an ERC-20 on Arc","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.002 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/arc/tx":{"get":{"summary":"Status, parties, fee and decoded token transfers of an Arc transaction","description":"Status, sender, recipient, fee in USDC and every ERC-20 transfer in an Arc transaction, with symbols and human-readable amounts.","operationId":"v1_paid_arc_tx","tags":["paid"],"parameters":[{"name":"hash","in":"query","required":true,"description":"A transaction hash on Arc.","schema":{"type":"string","example":"0x903a75fb579f4f6eb6b7ffb90ff3f7de405f117e9aed78d1f21c23a0f1fa0250"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.003","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"3000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Status, parties, fee and decoded token transfers of an Arc transaction","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.003 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/web/extract":{"get":{"summary":"Title, description, headings and clean text of a public URL","description":"Title, description, headings and up to 20,000 characters of clean readable text from any public URL. Built for LLM context. Private and local addresses are refused.","operationId":"v1_paid_web_extract","tags":["paid"],"parameters":[{"name":"url","in":"query","required":true,"description":"A public http(s) URL, on the default port.","schema":{"type":"string","example":"https://www.arc.network"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.005","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"5000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Title, description, headings and clean text of a public URL","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.005 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/web/check":{"get":{"summary":"Status, redirect chain, response time and security headers of a URL","description":"HTTP status, redirect chain with timings, total response time and security headers present or missing, for any public URL, measured from our server.","operationId":"v1_paid_web_check","tags":["paid"],"parameters":[{"name":"url","in":"query","required":true,"description":"A public http(s) URL, on the default port.","schema":{"type":"string","example":"https://www.arc.network"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.002","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"2000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Status, redirect chain, response time and security headers of a URL","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.002 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/packages/npm":{"get":{"summary":"Latest version, licence, downloads, dependencies and deprecation of an npm package","description":"Latest version, publish date, licence, weekly downloads, dependencies, engines and deprecation status of an npm package.","operationId":"v1_paid_packages_npm","tags":["paid"],"parameters":[{"name":"name","in":"query","required":true,"description":"Package name, scoped or not.","schema":{"type":"string","example":"hono"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.002","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"2000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Latest version, licence, downloads, dependencies and deprecation of an npm package","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.002 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/packages/pypi":{"get":{"summary":"Latest version, Python requirement, licence, dependencies and advisories of a PyPI project","description":"Latest version, Python requirement, licence, dependencies and the advisories against the current release of a PyPI project.","operationId":"v1_paid_packages_pypi","tags":["paid"],"parameters":[{"name":"name","in":"query","required":true,"description":"Project name on PyPI.","schema":{"type":"string","example":"requests"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.002","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"2000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Latest version, Python requirement, licence, dependencies and advisories of a PyPI project","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.002 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/packages/vulns":{"get":{"summary":"Known advisories for a package or one exact version","description":"Known advisories for a package, or for one exact version, with severity and the versions that fix them. npm, PyPI, Go, crates.io, Maven, RubyGems, NuGet, Packagist.","operationId":"v1_paid_packages_vulns","tags":["paid"],"parameters":[{"name":"name","in":"query","required":true,"description":"Package name.","schema":{"type":"string","example":"lodash"}},{"name":"ecosystem","in":"query","required":false,"description":"npm (default), pypi, go, crates.io, maven, rubygems, nuget, packagist.","schema":{"type":"string","example":"npm"}},{"name":"version","in":"query","required":false,"description":"One exact version. Without it, every version ever published.","schema":{"type":"string","example":"4.17.20"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.004","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"4000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Known advisories for a package or one exact version","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.004 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/domains/dns":{"get":{"summary":"Live DNS records with TTLs and DNSSEC status","description":"Live DNS records for a host name, with TTLs and whether the answers validated under DNSSEC. ?type= takes a comma-separated list of A, AAAA, CNAME, MX, TXT, NS, SOA, CAA.","operationId":"v1_paid_domains_dns","tags":["paid"],"parameters":[{"name":"name","in":"query","required":true,"description":"Host name.","schema":{"type":"string","example":"cra-agent.tech"}},{"name":"type","in":"query","required":false,"description":"Record types, comma-separated. Defaults to A,AAAA,CNAME,MX,TXT,NS.","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Live DNS records with TTLs and DNSSEC status","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/domains/whois":{"get":{"summary":"Registrar, dates, name servers and availability of a domain","description":"Registrar, creation and expiry dates, status codes and name servers of a domain from the registry's RDAP record, and whether the name looks available.","operationId":"v1_paid_domains_whois","tags":["paid"],"parameters":[{"name":"domain","in":"query","required":true,"description":"A registrable domain name.","schema":{"type":"string","example":"cra-agent.tech"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.003","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"3000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Registrar, dates, name servers and availability of a domain","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.003 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/currency/rates":{"get":{"summary":"ECB reference rates against a base currency, today or on a past date","description":"European Central Bank reference rates against a base currency, latest or on a past date. A daily reference, not an executed price: for that see /v1/paid/fx/execution.","operationId":"v1_paid_currency_rates","tags":["paid"],"parameters":[{"name":"base","in":"query","required":false,"description":"Three-letter currency code. Defaults to USD.","schema":{"type":"string","example":"USD"}},{"name":"symbols","in":"query","required":false,"description":"Only these currencies, comma-separated.","schema":{"type":"string","example":"EUR,GBP,JPY"}},{"name":"date","in":"query","required":false,"description":"A past date as YYYY-MM-DD. Defaults to the latest rates.","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"ECB reference rates against a base currency, today or on a past date","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/currency/convert":{"get":{"summary":"Convert an amount at the ECB reference rate","description":"Convert an amount between two currencies at the European Central Bank reference rate, latest or on a past date.","operationId":"v1_paid_currency_convert","tags":["paid"],"parameters":[{"name":"from","in":"query","required":true,"description":"Three-letter currency code.","schema":{"type":"string","example":"USD"}},{"name":"to","in":"query","required":true,"description":"Three-letter currency code.","schema":{"type":"string","example":"EUR"}},{"name":"amount","in":"query","required":true,"description":"The amount to convert.","schema":{"type":"string","example":"100"}},{"name":"date","in":"query","required":false,"description":"A past date as YYYY-MM-DD. Defaults to the latest rates.","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Convert an amount at the ECB reference rate","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/wiki/search":{"get":{"summary":"Best matching Wikipedia articles for a query","description":"The best matching Wikipedia articles for a query, with descriptions and excerpts, as clean JSON. Content is CC BY-SA 4.0.","operationId":"v1_paid_wiki_search","tags":["paid"],"parameters":[{"name":"q","in":"query","required":true,"description":"What to search for.","schema":{"type":"string","example":"stablecoin"}},{"name":"limit","in":"query","required":false,"description":"1 to 20, default 5.","schema":{"type":"integer","example":5}},{"name":"lang","in":"query","required":false,"description":"Wikipedia language code. Defaults to en.","schema":{"type":"string","example":"en"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Best matching Wikipedia articles for a query","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/wiki/summary":{"get":{"summary":"Short plain-text summary of one article","description":"A short plain-text summary of one Wikipedia article, with its image and last update. Content is CC BY-SA 4.0.","operationId":"v1_paid_wiki_summary","tags":["paid"],"parameters":[{"name":"title","in":"query","required":true,"description":"Article title.","schema":{"type":"string","example":"Stablecoin"}},{"name":"lang","in":"query","required":false,"description":"Wikipedia language code. Defaults to en.","schema":{"type":"string","example":"en"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Short plain-text summary of one article","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/wiki/article":{"get":{"summary":"Full plain text of an article, up to 20,000 characters","description":"The full plain text of a Wikipedia article, up to 20,000 characters, ready for LLM context. Content is CC BY-SA 4.0.","operationId":"v1_paid_wiki_article","tags":["paid"],"parameters":[{"name":"title","in":"query","required":true,"description":"Article title.","schema":{"type":"string","example":"Stablecoin"}},{"name":"lang","in":"query","required":false,"description":"Wikipedia language code. Defaults to en.","schema":{"type":"string","example":"en"}}],"x-payment-info":{"price":{"mode":"fixed","amount":"0.003","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"3000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"200":{"description":"Full plain text of an article, up to 20,000 characters","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required: $0.003 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/paid/selftest/fail":{"get":{"summary":"Always fails, on purpose","description":"Always fails on purpose. Proves the rule: the payment is only settled when the handler succeeds, so a broken endpoint costs the buyer nothing.","operationId":"v1_paid_selftest_fail","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","amount":"0.001","currency":"USD"},"protocols":[{"x402":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:5042","asset":"0x3600000000000000000000000000000000000000","amount":"1000","payTo":"0x33b37c6d7a98b58da3Ccb3F36A4b578053d0Ea74","maxTimeoutSeconds":604900}}]},"responses":{"402":{"description":"Payment required: $0.001 in USDC on Arc. Requirements are in the payment-required header.","content":{"application/json":{"schema":{"type":"object"},"example":{"hint":"this route always returns 500 after payment is verified; your payment is never settled"}}}},"500":{"description":"Always. The payment is verified but never settled."}}}}}}