{ "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= 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= 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" } }, "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" } } } } } } } } }