{"beta":true,"service":"BotsRated","currency":"USDC","network_note":"x402 v2, exact scheme, Base USDC; charged only on a 2xx answer","routes":{"preflight":{"url":"https://botsrated.com/v1/preflight?url=<host>","price_usd":"0","note":"free and unlimited (normal per-IP rate limits apply)"},"check":{"url":"https://botsrated.com/v1/check?host=<host>","price_usd":"0.001","amount_atomic":"1000","free_per_day":100},"report":{"url":"https://botsrated.com/v1/report/<host>","price_usd":"0.002","amount_atomic":"2000","free_per_day":10},"best":{"url":"https://botsrated.com/v1/best?task=<keywords>","price_usd":"0.01","amount_atomic":"10000","free_per_day":0}},"free_quota":{"per":"client IP address (IPv6: /48 prefix)","day":"UTC","check":100,"report":10,"exhausted":"normal x402 402 payment requirement","opt_out_header":"X-BotsRated-Free-Quota: off","response_fields":"free_quota {route, used, limit, remaining, resets_at}; headers X-BotsRated-Free-Quota-Remaining / -Limit / -Reset","not_applied_to":"blockrun.ai (the advertised example that x402 scanners probe); use /v1/sample/* for a free example"},"volume_tiers":"none yet (planned: automatic per-wallet monthly tiers; never prepaid balances or stored credit)","no_custody":"No accounts, prepaid balances, stored credit or refunds held. Each paid call is one x402 payment for that call.","verified_badge":"Free and earned from measurements; never sold. Paying BotsRated never changes a host's data, rank or badge.","free_data":{"dataset":"https://botsrated.com/dataset.json","signature":"https://botsrated.com/dataset.sig.json","archive":"https://botsrated.com/archive","history":"https://botsrated.com/v1/history?host=<host>"},"pricing_page":"https://botsrated.com/pricing","updated":"2026-10-23","plans":{"rules":"One x402 USDC payment on Base buys one 30-day period and grants access immediately after settlement. No accounts, balances, stored credit, top-ups or refunds held. Cancelling stops delivery and does not refund. The dataset (dataset.json, archives, history) stays free.","alerts":[{"plan":"alerts-free","price_usd_per_30_days":"0","amount_atomic":"0","hosts":1,"delivery":"daily digest","includes":"1 host; one signed webhook digest per UTC day when its facts changed. Renew for free every 30 days.","subscribe":"POST https://botsrated.com/v1/alerts/subscribe (free)"},{"plan":"alerts-10","price_usd_per_30_days":"9","amount_atomic":"9000000","hosts":10,"delivery":"instant","includes":"Up to 10 hosts; a signed webhook within one probe cycle of a change (payTo, quoted price, valid 402 lost/regained, delisted/relisted, stale).","subscribe":"POST https://botsrated.com/v1/subscribe/alerts-10 (x402)"},{"plan":"alerts-50","price_usd_per_30_days":"29","amount_atomic":"29000000","hosts":50,"delivery":"instant","includes":"Up to 50 hosts; same events as alerts-10.","subscribe":"POST https://botsrated.com/v1/subscribe/alerts-50 (x402)"}],"data":[{"plan":"data-starter","price_usd_per_30_days":"49","amount_atomic":"49000000","includes":"Bearer token: /v1/check, /v1/report and /v1/best without per-call payment for 30 days (fair use, 60 requests/min). Dataset, history and archives stay free for everyone.","subscribe":"POST https://botsrated.com/v1/subscribe/data-starter (x402)"},{"plan":"data-pro","price_usd_per_30_days":"199","amount_atomic":"199000000","includes":"Bearer token: /v1/check, /v1/report and /v1/best without per-call payment for 30 days (600 requests/min). Planned: signed change feed for all hosts.","subscribe":"POST https://botsrated.com/v1/subscribe/data-pro (x402)"},{"plan":"custom","price_usd_per_month":"499+","includes":"Custom volume, SLA or bulk delivery. Write to botsrated@gmail.com.","contact":"botsrated@gmail.com"}],"webhooks":{"delivery":"POST JSON to your webhook_url; no email.","signature":"Headers X-BotsRated-Key-Id (botsrated-prober-1), X-BotsRated-Timestamp, X-BotsRated-Signature: ed25519 over `${timestamp}.${raw body}`, base64. Public key: /.well-known/botsrated-key. Reject timestamps older than 5 minutes.","verification":"At subscribe time we POST {type:'botsrated.verify', challenge}; answer 2xx with the challenge in the body. https on a public DNS name only, no redirects."},"client_note":"x402 client libraries cap single payments by default (for example @x402/fetch spendControls.maxAmountPerPayment is $1). Raise that cap to the plan price for the subscribe call only. The webhook is verified on the unpaid request, before any 402.","manage":{"status":"GET https://botsrated.com/v1/subscription (Authorization: Bearer <token>)","update":"POST https://botsrated.com/v1/subscription/update {hosts, webhook_url}","cancel":"POST https://botsrated.com/v1/subscription/cancel"}}}