{"openapi":"3.0.3","info":{"title":"Agentic Resource Radar API","version":"1.1.0","description":"The pay-per-call x402 API of Agentic Resource Radar. Every AI tool claims to be the best. Agentic Resource Radar benchmarks them honestly. This API serves the machine-readable data behind the Agentic Search Index and the continuous telemetry: check an x402 endpoint is live, fresh, and honestly priced before an agent pays it. No account or API key; payment is the authentication (x402).","x-guidance":"Agentic Resource Radar API: before an autonomous agent pays an x402 endpoint, call GET https://api.agenticresourceradar.com/v1/check?resource=<absolute-https-url> for a full graded verdict (decision allow/warn/block/unknown plus liveness, freshness, and price/payTo/chain drift; eval/index data, $0.035/call), or GET https://api.agenticresourceradar.com/v1/trade-check?resource=<absolute-https-url> for latency-optimized telemetry facts (no score; basic telemetry data, $0.01/call). Both are PAID x402 routes: an unpaid request returns HTTP 402 with the x402 payment challenge; retry with a valid X-PAYMENT for that route. No account needed. Payable resources are listed at https://api.agenticresourceradar.com/discovery/resources. The monitor behind this API never pays the target endpoint being checked. Free rankings and methodology: https://agenticresourceradar.com (see https://agenticresourceradar.com/llms.txt and https://agenticresourceradar.com/docs).","contact":{"email":"contact@smithersbot.com","url":"https://agenticresourceradar.com"}},"externalDocs":{"description":"Quickstart, 402 flow walkthrough, and API reference","url":"https://agenticresourceradar.com/docs"},"servers":[{"url":"https://api.agenticresourceradar.com"}],"paths":{"/v1/check":{"get":{"operationId":"check","summary":"Full pre-payment x402 endpoint verdict (eval/index data)","description":"Full pre-payment verdict for an x402 endpoint: health, latency, drift, and monitoring history.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^https://","description":"Absolute https x402 endpoint URL to check before sending payment."},"expectedPayTo":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional expected receiving wallet address for drift checks."},"maxUsdPrice":{"type":"string","description":"Optional non-negative USD price ceiling for the checked endpoint."},"maxAgeSeconds":{"type":"string","description":"Optional non-negative integer freshness limit for the trust decision."}},"required":["resource"],"additionalProperties":false}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.035"},"tier":"eval/index data","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid response.","content":{"application/json":{"schema":{"type":"object","properties":{"v":{"type":"integer"},"resource":{"type":"string"},"decision":{"type":"string","enum":["allow","warn","block","unknown"]},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"observedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"ageSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"history":{"type":"object","properties":{"windowSeconds":{"type":"integer"},"targetWindowSeconds":{"type":"integer"},"complete":{"type":"boolean"}},"required":["windowSeconds","targetWindowSeconds","complete"],"additionalProperties":false},"price":{"type":"object","properties":{"usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"rangeRatio":{"anyOf":[{"type":"number"},{"type":"null"}]},"vsLow":{"anyOf":[{"type":"number"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["usd","currency","changeCount","distinct","rangeRatio","vsLow","changed24h","lastChangeAgeSeconds"],"additionalProperties":false},"config":{"type":"object","properties":{"payTo":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["value","changeCount","distinct","changed24h","lastChangeAgeSeconds"],"additionalProperties":false},"chain":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["value","changeCount","distinct","changed24h","lastChangeAgeSeconds"],"additionalProperties":false},"currency":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["value","changeCount","distinct","changed24h","lastChangeAgeSeconds"],"additionalProperties":false}},"required":["payTo","chain","currency"],"additionalProperties":false},"liveness":{"type":"object","properties":{"successRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"p95LatencyMs":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastLatencyMs":{"anyOf":[{"type":"integer"},{"type":"null"}]},"consecutiveFailures":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["successRate","p95LatencyMs","lastLatencyMs","consecutiveFailures"],"additionalProperties":false},"subscores":{"type":"object","properties":{"L":{"type":"number"},"F":{"type":"number"},"D":{"type":"number"}},"required":["L","F","D"],"additionalProperties":false},"stale":{"type":"boolean"},"freshnessAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"searchIndex":{"type":"object","description":"Published Agentic Search Index results for the checked resource's provider. Present only when the resource maps to a provider ranked in the index; every figure comes from the published release named by `version`.","properties":{"version":{"type":"string"},"released":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"score":{"type":"number"},"ci":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"rank":{"type":"integer"},"of":{"type":"integer"},"perKindPass":{"type":"object","additionalProperties":{"type":"string"}},"latency":{"type":"object","properties":{"p50Ms":{"anyOf":[{"type":"integer"},{"type":"null"}]},"p95Ms":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["p50Ms","p95Ms"],"additionalProperties":false},"costPer1kSuccessfulUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"page":{"type":"string"}},"required":["provider","score","ci","rank","of","perKindPass","latency","costPer1kSuccessfulUsd","page"],"additionalProperties":false}}},"required":["version","released","results"],"additionalProperties":false},"review_rating":{"anyOf":[{"type":"number"},{"type":"null"}]},"verified_reviews":{"type":"integer"},"weighted_review_rating":{"anyOf":[{"type":"number"},{"type":"null"}]},"review_count":{"type":"integer"},"last_reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_verified_reviews":{"type":"boolean"}},"required":["v","resource","decision","score","observedAt","ageSeconds","history","price","config","liveness","subscores","stale","freshnessAgeSeconds","reasons","review_rating","verified_reviews","weighted_review_rating","review_count","last_reviewed_at","has_verified_reviews"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/v1/trade-check":{"get":{"operationId":"tradeCheck","summary":"Fast pre-trade x402 endpoint check (basic telemetry data)","description":"Fast pre-trade check for trading agents: liveness, freshness, and price, payTo, and chain drift.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","minLength":1,"maxLength":2048,"pattern":"^https://","description":"Absolute https x402 endpoint URL to check before sending payment."},"expectedPayTo":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Optional expected receiving wallet address for drift checks."},"maxUsdPrice":{"type":"string","description":"Optional non-negative USD price ceiling for the checked endpoint."},"maxAgeSeconds":{"type":"string","description":"Optional non-negative integer freshness limit for the trust decision."}},"required":["resource"],"additionalProperties":false}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"tier":"basic telemetry data","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid response.","content":{"application/json":{"schema":{"type":"object","properties":{"v":{"type":"integer"},"resource":{"type":"string"},"observedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"ageSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"freshnessAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"stale":{"type":"boolean"},"tracked":{"type":"boolean"},"liveness":{"type":"object","properties":{"successRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"p95LatencyMs":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastLatencyMs":{"anyOf":[{"type":"integer"},{"type":"null"}]},"consecutiveFailures":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["successRate","p95LatencyMs","lastLatencyMs","consecutiveFailures"],"additionalProperties":false},"price":{"type":"object","properties":{"usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["usd","currency","changeCount","distinct","changed24h","lastChangeAgeSeconds"],"additionalProperties":false},"payTo":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["value","changeCount","distinct","changed24h","lastChangeAgeSeconds"],"additionalProperties":false},"chain":{"type":"object","properties":{"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"changeCount":{"anyOf":[{"type":"integer"},{"type":"null"}]},"distinct":{"anyOf":[{"type":"integer"},{"type":"null"}]},"changed24h":{"type":"boolean"},"lastChangeAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]}},"required":["value","changeCount","distinct","changed24h","lastChangeAgeSeconds"],"additionalProperties":false},"review_rating":{"anyOf":[{"type":"number"},{"type":"null"}]},"verified_reviews":{"type":"integer"},"weighted_review_rating":{"anyOf":[{"type":"number"},{"type":"null"}]},"review_count":{"type":"integer"},"last_reviewed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_verified_reviews":{"type":"boolean"}},"required":["v","resource","observedAt","ageSeconds","freshnessAgeSeconds","stale","tracked","liveness","price","payTo","chain","review_rating","verified_reviews","weighted_review_rating","review_count","last_reviewed_at","has_verified_reviews"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/discovery/resources":{"get":{"operationId":"discoveryResources","summary":"List payable x402 resources (free)","description":"x402 discovery convention: every payable resource on this host with its full payment requirements. Free, no payment needed.","responses":{"200":{"description":"Free machine-readable response.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/x402":{"get":{"operationId":"wellKnownX402","summary":"x402 discovery metadata (free)","description":"Service-level x402 discovery document listing the priced routes and their prices. Free, no payment needed.","responses":{"200":{"description":"Free machine-readable response.","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}