\n\nDocumentation\n\n# Pay per call. Nothing else to set up.\n\nEvery service is a JSON endpoint behind HTTP 402. If you already use an x402 client, you are done: point it at any endpoint below. Agents can read this whole page as Markdown at
/llms-full.txt.\n\n
\n\n## Free trial, no wallet\n\nEvery service has a free sample endpoint that runs its example input and returns the real output, so your agent can check format and quality. Your own input goes through the paid endpoint. Limits: 3 calls per service per day, heavy services (screenshot, PDF, OCR, scrape, resize) 1, 20 per IP in total. Send an empty body or the example input.\n\n``` code-block\ncurl -X POST https://agentsvc.io/api/v1/try/web-scrape \\\n -H \"Content-Type: application/json\" \\\n -d '{\"url\":\"https://example.com\"}'\n\n# GET works too and uses the example input:\ncurl https://agentsvc.io/api/v1/try/weather\n```\n\nThe response carries `trial.remaining_today` and `paid_endpoint`. Hitting the limit returns 429 with `resets_at`.\n\n
\n\n
\n\n## Quickstart with a wallet\n\nYou need an EVM private key whose address holds USDC on Base mainnet (chain 8453). No ETH is needed; the facilitator pays gas. Then:\n\n
\n\n
\n\n
\n\n
\n\nJavaScript\n\nPython\n\nMCP\n\n
\n\ncopy\n\n
\n\n``` code-block\nnpm i @x402/fetch @x402/evm viem\nimport { wrapFetchWithPayment, x402Client } from \"@x402/fetch\";\nimport { registerExactEvmScheme } from \"@x402/evm/exact/client\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nconst client = new x402Client();\nregisterExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });\nconst payFetch = wrapFetchWithPayment(fetch, client);\nconst res = await payFetch(\"https://agentsvc.io/api/v1/proxy/web-scrape\", { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify({ url: \"https://example.com\" }) });\nconsole.log(await res.json());\n```\n\n
\n\n
\n\nSwap the URL for any endpoint from the
reference. The client handles 402, signing and retry. The 200 response contains `data` and `payment.transaction`.\n\n
\n\n
\n\n## Payment protocol (x402 v1 and v2)\n\nOne request without payment returns 402. We answer both protocol versions at once, so any x402 client works:\n\n- **x402 v2**: header `PAYMENT-REQUIRED` = base64 JSON with `accepts[0]` = {scheme: exact, network: eip155:8453, amount, asset, payTo, maxTimeoutSeconds, extra}. Pay by sending `PAYMENT-SIGNATURE`.\n- **x402 v1**: JSON body with `accepts[0]` = {scheme: exact, network: base, maxAmountRequired, resource, asset, payTo, extra}. Pay by sending `X-PAYMENT`.\n\n``` code-block\nPOST https://agentsvc","truncated":true},"trial":{"free":true,"used_example_input":true,"input_used":{"url":"https://agentsvc.io/docs","max_chars":5000},"remaining_today":0,"resets_at":"2026-10-07T00:00:00.000Z","note":"Real output for the example input. The paid endpoint returns the same format for your own input."},"paid_endpoint":"https://agentsvc.io/api/v1/proxy/doc-parse","price_usdc":0.006,"payment":"x402, USDC on Base mainnet, no account needed","docs":"https://agentsvc.io/docs"}