{ "openapi": "3.1.0", "info": { "title": "YourAITools API", "version": "1.0.0", "description": "Pay-per-call x402 APIs for AI agents (USDC on Base, Polygon, Arbitrum or Solana). Each tool is also documented at /openapi.json.", "contact": { "email": "hello@youraitools.co", "url": "https://youraitools.co/built-by-us" } }, "servers": [ { "url": "https://api.youraitools.co" } ], "paths": { "/agentgate/v1/check-agent": { "get": { "operationId": "check_agent", "summary": "Concordium Agent Registry verdict + full record", "tags": [ "AgentGate", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Badge (CIS-2 token address, short or CAIP-19 form) or Concordium account address", "example": "Mf22soLh1NuZYFgBK8iSs" }, { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "mainnet", "testnet", "devnet" ], "default": "mainnet" } } ], "responses": { "200": { "description": "Success (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "network": { "type": "string" }, "found": { "type": "boolean" }, "active": { "type": "boolean" }, "cardHashMatches": { "type": [ "boolean", "null" ] }, "verified": { "type": "boolean" }, "tokenAddress": { "type": [ "string", "null" ] }, "tokenId": { "type": [ "integer", "null" ] }, "owner": { "type": [ "string", "null" ] }, "agentWallet": { "type": [ "string", "null" ] }, "agentUri": { "type": [ "string", "null" ] }, "source": { "type": "string" }, "mock": { "type": "boolean" }, "issues": { "type": "array" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header)" } }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] } } }, "/agentgate/v1/check-agent/preview": { "get": { "operationId": "check_agent_preview", "summary": "Free verdict-only preview (20/min/IP)", "security": [], "responses": { "200": { "description": "OK" }, "429": { "description": "Free tier rate limit reached" } }, "parameters": [ { "name": "id", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Badge (CIS-2 token address, short or CAIP-19 form) or Concordium account address", "example": "Mf22soLh1NuZYFgBK8iSs" }, { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "mainnet", "testnet", "devnet" ], "default": "mainnet" } } ], "tags": [ "AgentGate" ] } }, "/webread/v1/read": { "get": { "operationId": "read_url", "summary": "Web page to clean Markdown", "tags": [ "WebRead", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002" }, "protocols": [ { "x402": {} } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" }, "description": "Absolute http(s) URL of a public web page (HTML or plain text)", "example": "https://example.com/" }, { "name": "maxChars", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 100, "maximum": 200000, "default": 200000 } } ], "responses": { "200": { "description": "Success (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "finalUrl": { "type": "string" }, "status": { "type": "integer" }, "contentType": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "lang": { "type": [ "string", "null" ] }, "canonical": { "type": [ "string", "null" ] }, "markdown": { "type": "string" }, "chars": { "type": "integer" }, "wordCount": { "type": "integer" }, "links": { "type": "integer" }, "truncated": { "type": "boolean" }, "sourceBytes": { "type": "integer" }, "redirects": { "type": "integer" }, "fetchMs": { "type": "integer" }, "robots": { "type": "string" }, "fetchedAt": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header)" } }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "2000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] } } }, "/webread/v1/read/preview": { "get": { "operationId": "read_url_preview", "summary": "Free 2,000-character preview (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" }, "429": { "description": "Free tier rate limit reached" } }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" }, "description": "Absolute http(s) URL of a public web page (HTML or plain text)", "example": "https://example.com/" } ], "tags": [ "WebRead" ] } }, "/injectscan/v1/scan": { "get": { "operationId": "scan", "summary": "Scan text or a URL for prompt injection", "tags": [ "InjectScan", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "text", "in": "query", "schema": { "type": "string" }, "description": "Text to scan", "example": "Please summarize this article about solar panels." }, { "name": "url", "in": "query", "schema": { "type": "string", "format": "uri" }, "description": "Public http(s) page to fetch and scan (visible + hidden HTML)" } ], "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string", "enum": [ "text", "url", "tools" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 }, "verdict": { "type": "string", "enum": [ "safe", "suspicious", "malicious" ] }, "flagged": { "type": "boolean" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "score": { "type": "integer" }, "rules": { "type": "integer" }, "description": { "type": "string" } } } }, "findings": { "type": "array", "items": { "type": "object", "properties": { "rule": { "type": "string" }, "category": { "type": "string" }, "weight": { "type": "number" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "location": { "type": "string" }, "text": { "type": "string" } } } }, "hidden": { "type": "object" }, "decoded": { "type": "array" }, "chars_scanned": { "type": "integer" }, "truncated": { "type": "boolean" }, "ruleset": { "type": "string" }, "tools": { "type": "array", "description": "tools= mode: one result per tool" }, "hidden_html": { "type": "object", "description": "url= mode: hidden HTML segments checked and flagged" } } }, "example": { "input": "text", "risk_score": 0, "verdict": "safe", "flagged": false, "categories": [], "findings": [], "hidden": { "zero_width": 0, "bom_soft_hyphen": 0, "bidi_controls": 0, "unicode_tags": 0, "homoglyph_words": 0 }, "decoded": [], "chars_scanned": 49, "truncated": false, "ruleset": "2026.10.1", "ms": 1 } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "403": { "description": "url= blocked by robots.txt (never charged)" }, "502": { "description": "url= fetch failed (never charged)" } } }, "post": { "operationId": "scan_post", "summary": "Scan text, a URL, or MCP tool definitions", "tags": [ "InjectScan", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 100000 }, "url": { "type": "string", "format": "uri" }, "tools": { "type": "array", "maxItems": 100, "items": { "type": "object" } } }, "oneOf": [ { "required": [ "text" ] }, { "required": [ "url" ] }, { "required": [ "tools" ] } ] }, "example": { "text": "Please summarize this article about solar panels." } } } }, "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string", "enum": [ "text", "url", "tools" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 }, "verdict": { "type": "string", "enum": [ "safe", "suspicious", "malicious" ] }, "flagged": { "type": "boolean" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "score": { "type": "integer" }, "rules": { "type": "integer" }, "description": { "type": "string" } } } }, "findings": { "type": "array", "items": { "type": "object", "properties": { "rule": { "type": "string" }, "category": { "type": "string" }, "weight": { "type": "number" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "location": { "type": "string" }, "text": { "type": "string" } } } }, "hidden": { "type": "object" }, "decoded": { "type": "array" }, "chars_scanned": { "type": "integer" }, "truncated": { "type": "boolean" }, "ruleset": { "type": "string" }, "tools": { "type": "array", "description": "tools= mode: one result per tool" }, "hidden_html": { "type": "object", "description": "url= mode: hidden HTML segments checked and flagged" } } }, "example": { "input": "text", "risk_score": 0, "verdict": "safe", "flagged": false, "categories": [], "findings": [], "hidden": { "zero_width": 0, "bom_soft_hyphen": 0, "bidi_controls": 0, "unicode_tags": 0, "homoglyph_words": 0 }, "decoded": [], "chars_scanned": 49, "truncated": false, "ruleset": "2026.10.1", "ms": 1 } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "403": { "description": "url= blocked by robots.txt (never charged)" }, "502": { "description": "url= fetch failed (never charged)" } } } }, "/injectscan/v1/scan/preview": { "get": { "operationId": "scan_preview", "summary": "Free scan for text up to 2,000 characters (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" } }, "parameters": [ { "name": "text", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2000 } } ], "tags": [ "InjectScan" ] }, "post": { "operationId": "scan_preview_post", "summary": "Free scan (POST {\"text\"})", "security": [], "responses": { "200": { "description": "OK" } }, "tags": [ "InjectScan" ] } }, "/domaincheck/v1/domain": { "get": { "operationId": "check_domain", "summary": "Domain trust report (DNS, email auth, RDAP age, flags, score)", "tags": [ "DomainCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "2000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain, URL or email address" } ], "responses": { "200": { "description": "Domain report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "registrable_domain": { "type": "string" }, "public_suffix": { "type": "string" }, "exists": { "type": "boolean" }, "verdict": { "type": "string", "enum": [ "low_risk", "medium_risk", "high_risk", "nonexistent" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "flags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "penalty": { "type": "integer" }, "description": { "type": "string" }, "detail": { "type": "string" } } } }, "dns": { "type": "object", "description": "a, aaaa, ns, mx[{priority,host}], null_mx, cname, dnssec_validated, caa" }, "email": { "type": "object", "description": "accepts_mail, mx_provider, spf, dmarc, dkim, mta_sts, tls_rpt, bimi, grade (A-F)" }, "registration": { "type": "object", "description": "RDAP: registrar, created, expires, age_days, expires_in_days, status, nameservers, dnssec_signed" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Invalid email syntax (never charged)" }, "504": { "description": "Lookup timed out (never charged)" } } }, "post": { "operationId": "check_domain_post", "summary": "Domain trust report (POST {\"domain\"})", "tags": [ "DomainCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "2000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" } }, "required": [ "domain" ] } } } }, "responses": { "200": { "description": "Domain report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "registrable_domain": { "type": "string" }, "public_suffix": { "type": "string" }, "exists": { "type": "boolean" }, "verdict": { "type": "string", "enum": [ "low_risk", "medium_risk", "high_risk", "nonexistent" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "flags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "penalty": { "type": "integer" }, "description": { "type": "string" }, "detail": { "type": "string" } } } }, "dns": { "type": "object", "description": "a, aaaa, ns, mx[{priority,host}], null_mx, cname, dnssec_validated, caa" }, "email": { "type": "object", "description": "accepts_mail, mx_provider, spf, dmarc, dkim, mta_sts, tls_rpt, bimi, grade (A-F)" }, "registration": { "type": "object", "description": "RDAP: registrar, created, expires, age_days, expires_in_days, status, nameservers, dnssec_signed" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Invalid email syntax (never charged)" }, "504": { "description": "Lookup timed out (never charged)" } } } }, "/domaincheck/v1/email": { "get": { "operationId": "check_email", "summary": "Email address check (syntax, disposable, MX, domain age, verdict)", "tags": [ "DomainCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "email", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Email address" } ], "responses": { "200": { "description": "Email check (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string" }, "normalized": { "type": "string" }, "canonical": { "type": "string" }, "domain": { "type": "string" }, "verdict": { "type": "string", "enum": [ "valid", "risky", "undeliverable", "invalid" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "syntax": { "type": "object" }, "disposable": { "type": "boolean" }, "role": { "type": "boolean" }, "free_provider": { "type": "boolean" }, "plus_tag": { "type": [ "string", "null" ] }, "deliverability": { "type": "object", "description": "domain_exists, accepts_mail, mx, null_mx, mx_provider" }, "domain_auth": { "type": "object", "description": "spf, dmarc policy and grade" }, "registration": { "type": [ "object", "null" ] }, "flags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "penalty": { "type": "integer" }, "description": { "type": "string" }, "detail": { "type": "string" } } } }, "mailbox_checked": { "type": "boolean", "const": false } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Invalid email syntax (never charged)" }, "504": { "description": "Lookup timed out (never charged)" } } }, "post": { "operationId": "check_email_post", "summary": "Email address check (POST {\"email\"})", "tags": [ "DomainCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string" } }, "required": [ "email" ] } } } }, "responses": { "200": { "description": "Email check (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string" }, "normalized": { "type": "string" }, "canonical": { "type": "string" }, "domain": { "type": "string" }, "verdict": { "type": "string", "enum": [ "valid", "risky", "undeliverable", "invalid" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "syntax": { "type": "object" }, "disposable": { "type": "boolean" }, "role": { "type": "boolean" }, "free_provider": { "type": "boolean" }, "plus_tag": { "type": [ "string", "null" ] }, "deliverability": { "type": "object", "description": "domain_exists, accepts_mail, mx, null_mx, mx_provider" }, "domain_auth": { "type": "object", "description": "spf, dmarc policy and grade" }, "registration": { "type": [ "object", "null" ] }, "flags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "penalty": { "type": "integer" }, "description": { "type": "string" }, "detail": { "type": "string" } } } }, "mailbox_checked": { "type": "boolean", "const": false } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Invalid email syntax (never charged)" }, "504": { "description": "Lookup timed out (never charged)" } } } }, "/domaincheck/v1/domain/preview": { "get": { "operationId": "domain_preview", "summary": "Free DNS / MX / SPF / DMARC summary (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" } }, "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Domain" } ], "tags": [ "DomainCheck" ] }, "post": { "operationId": "domain_preview_post", "summary": "Free domain preview (POST {\"domain\"})", "security": [], "responses": { "200": { "description": "OK" } }, "tags": [ "DomainCheck" ] } }, "/domaincheck/v1/email/preview": { "get": { "operationId": "email_preview", "summary": "Free syntax + disposable / role / free-provider check (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" } }, "parameters": [ { "name": "email", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Email address" } ], "tags": [ "DomainCheck" ] }, "post": { "operationId": "email_preview_post", "summary": "Free email preview (POST {\"email\"})", "security": [], "responses": { "200": { "description": "OK" } }, "tags": [ "DomainCheck" ] } }, "/payguard/v1/address": { "get": { "operationId": "screen_address", "summary": "OFAC SDN screen of one crypto address (matches, programs, list date, chain, checksum)", "tags": [ "PayGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 140 }, "description": "Blockchain address (EVM 0x, bc1 / 1 / 3, T..., Solana, Litecoin, XMR ...)" } ], "responses": { "200": { "description": "Screening result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string" }, "address": { "type": "string", "description": "Lookup key (EVM hex and bech32 lower-cased)" }, "sanctioned": { "type": "boolean" }, "match_count": { "type": "integer" }, "matches": { "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "string" }, "entity_type": { "type": "string" }, "sdn_uid": { "type": "integer" }, "programs": { "type": "array", "items": { "type": "string" } }, "list_date": { "type": [ "string", "null" ], "format": "date" }, "listed_currency": { "type": "string" }, "listed_as": { "type": "string" } } } }, "chain": { "type": "object", "description": "format, guess, candidates, checksum (eip55 | base58check | bech32 | cashaddr | null), checksum_valid (true | false | null), checksum_address" }, "source": { "type": "string" }, "source_url": { "type": "string" }, "list_updated_at": { "type": "string", "format": "date" }, "list_age_days": { "type": "integer" }, "sdn_address_count": { "type": "integer" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" } } }, "post": { "operationId": "screen_address_post", "summary": "OFAC SDN screen of one address (POST {\"address\"})", "tags": [ "PayGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" } }, "required": [ "address" ] } } } }, "responses": { "200": { "description": "Screening result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "input": { "type": "string" }, "address": { "type": "string", "description": "Lookup key (EVM hex and bech32 lower-cased)" }, "sanctioned": { "type": "boolean" }, "match_count": { "type": "integer" }, "matches": { "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "string" }, "entity_type": { "type": "string" }, "sdn_uid": { "type": "integer" }, "programs": { "type": "array", "items": { "type": "string" } }, "list_date": { "type": [ "string", "null" ], "format": "date" }, "listed_currency": { "type": "string" }, "listed_as": { "type": "string" } } } }, "chain": { "type": "object", "description": "format, guess, candidates, checksum (eip55 | base58check | bech32 | cashaddr | null), checksum_valid (true | false | null), checksum_address" }, "source": { "type": "string" }, "source_url": { "type": "string" }, "list_updated_at": { "type": "string", "format": "date" }, "list_age_days": { "type": "integer" }, "sdn_address_count": { "type": "integer" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" } } } }, "/payguard/v1/batch": { "post": { "operationId": "screen_batch", "summary": "OFAC SDN screen of up to 50 addresses", "tags": [ "PayGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "10000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "addresses": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 50 } }, "required": [ "addresses" ] } } } }, "responses": { "200": { "description": "Batch result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "integer" }, "sanctioned_count": { "type": "integer" }, "any_sanctioned": { "type": "boolean" }, "results": { "type": "array", "items": { "type": "object", "properties": { "input": { "type": "string" }, "address": { "type": "string", "description": "Lookup key (EVM hex and bech32 lower-cased)" }, "sanctioned": { "type": "boolean" }, "match_count": { "type": "integer" }, "matches": { "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "string" }, "entity_type": { "type": "string" }, "sdn_uid": { "type": "integer" }, "programs": { "type": "array", "items": { "type": "string" } }, "list_date": { "type": [ "string", "null" ], "format": "date" }, "listed_currency": { "type": "string" }, "listed_as": { "type": "string" } } } }, "chain": { "type": "object", "description": "format, guess, candidates, checksum (eip55 | base58check | bech32 | cashaddr | null), checksum_valid (true | false | null), checksum_address" }, "source": { "type": "string" }, "source_url": { "type": "string" }, "list_updated_at": { "type": "string", "format": "date" }, "list_age_days": { "type": "integer" }, "sdn_address_count": { "type": "integer" }, "disclaimer": { "type": "string" } } } }, "list_updated_at": { "type": "string" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" } } } }, "/payguard/v1/preview": { "get": { "operationId": "screen_preview", "summary": "Free sanctioned true/false + chain guess (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" }, "429": { "description": "Free tier rate limit" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 140 }, "description": "Blockchain address (EVM 0x, bc1 / 1 / 3, T..., Solana, Litecoin, XMR ...)" } ], "tags": [ "PayGuard" ] }, "post": { "operationId": "screen_preview_post", "summary": "Free preview (POST {\"address\"})", "security": [], "responses": { "200": { "description": "OK" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "PayGuard" ] } }, "/pkgguard/v1/scan": { "post": { "operationId": "scan_dependencies", "summary": "Scan a manifest / lockfile / package list for vulnerable and malicious packages (up to 500)", "tags": [ "PkgGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "manifest": { "type": "string", "maxLength": 512000, "description": "File contents: package.json, package-lock.json, requirements.txt, Pipfile.lock, poetry.lock, go.mod, Cargo.lock, composer.lock" }, "filename": { "type": "string" }, "type": { "type": "string", "enum": [ "package.json", "package-lock.json", "requirements.txt", "Pipfile.lock", "poetry.lock", "go.mod", "Cargo.lock", "composer.lock" ] }, "include_dev": { "type": "boolean", "default": true }, "packages": { "type": "array", "maxItems": 500, "items": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "PyPI", "Go", "crates.io", "Packagist", "RubyGems", "Maven", "NuGet", "Pub", "Hex" ] }, "name": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name", "version" ] } } } } } } }, "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "manifest_type": { "type": "string" }, "package_count": { "type": "integer" }, "scanned_count": { "type": "integer" }, "unpinned_count": { "type": "integer" }, "vulnerable_count": { "type": "integer" }, "malicious_count": { "type": "integer" }, "advisory_count": { "type": "integer" }, "verdict": { "type": "string", "enum": [ "clean", "vulnerable", "malicious" ] }, "highest_severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "by_severity": { "type": "object" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "ecosystem": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "version_source": { "type": "string", "enum": [ "exact", "range_floor" ] }, "malicious": { "type": "boolean" }, "highest_severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "vuln_count": { "type": "integer" }, "vulns": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "malicious": { "type": "boolean" }, "severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "cvss_score": { "type": [ "number", "null" ] }, "cvss_vector": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "aliases": { "type": "array", "items": { "type": "string" } }, "fixed_in": { "type": "array", "items": { "type": "string" } }, "published": { "type": [ "string", "null" ] }, "url": { "type": "string" } } } } } }, "description": "Only packages with at least one advisory" }, "unpinned": { "type": "array", "items": { "type": "object" } }, "source": { "type": "object" }, "scanned_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "OSV.dev unavailable (never charged)" } } } }, "/pkgguard/v1/package": { "get": { "operationId": "check_package", "summary": "Known vulnerabilities and malicious flag for one package version", "tags": [ "PkgGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "ecosystem", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "npm", "PyPI", "Go", "crates.io", "Packagist", "RubyGems", "Maven", "NuGet", "Pub", "Hex" ], "default": "npm" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 214 }, "description": "Package name, e.g. lodash, requests, github.com/gin-gonic/gin" }, { "name": "version", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 64 }, "description": "Exact version, e.g. 4.17.15" } ], "responses": { "200": { "description": "Package result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "manifest_type": { "type": "string" }, "package_count": { "type": "integer" }, "scanned_count": { "type": "integer" }, "unpinned_count": { "type": "integer" }, "vulnerable_count": { "type": "integer" }, "malicious_count": { "type": "integer" }, "advisory_count": { "type": "integer" }, "verdict": { "type": "string", "enum": [ "clean", "vulnerable", "malicious" ] }, "highest_severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "by_severity": { "type": "object" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "ecosystem": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "version_source": { "type": "string", "enum": [ "exact", "range_floor" ] }, "malicious": { "type": "boolean" }, "highest_severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "vuln_count": { "type": "integer" }, "vulns": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "malicious": { "type": "boolean" }, "severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "cvss_score": { "type": [ "number", "null" ] }, "cvss_vector": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "aliases": { "type": "array", "items": { "type": "string" } }, "fixed_in": { "type": "array", "items": { "type": "string" } }, "published": { "type": [ "string", "null" ] }, "url": { "type": "string" } } } } } }, "description": "Only packages with at least one advisory" }, "unpinned": { "type": "array", "items": { "type": "object" } }, "source": { "type": "object" }, "scanned_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "OSV.dev unavailable (never charged)" } } }, "post": { "operationId": "check_package_post", "summary": "Same as GET, POST {\"ecosystem\",\"name\",\"version\"}", "tags": [ "PkgGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "PyPI", "Go", "crates.io", "Packagist", "RubyGems", "Maven", "NuGet", "Pub", "Hex" ], "default": "npm" }, "name": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name", "version" ] } } } }, "responses": { "200": { "description": "Package result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "manifest_type": { "type": "string" }, "package_count": { "type": "integer" }, "scanned_count": { "type": "integer" }, "unpinned_count": { "type": "integer" }, "vulnerable_count": { "type": "integer" }, "malicious_count": { "type": "integer" }, "advisory_count": { "type": "integer" }, "verdict": { "type": "string", "enum": [ "clean", "vulnerable", "malicious" ] }, "highest_severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "by_severity": { "type": "object" }, "packages": { "type": "array", "items": { "type": "object", "properties": { "ecosystem": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "string" }, "version_source": { "type": "string", "enum": [ "exact", "range_floor" ] }, "malicious": { "type": "boolean" }, "highest_severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "vuln_count": { "type": "integer" }, "vulns": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "malicious": { "type": "boolean" }, "severity": { "type": "string", "enum": [ "CRITICAL", "HIGH", "MEDIUM", "LOW", "UNKNOWN", "NONE" ] }, "cvss_score": { "type": [ "number", "null" ] }, "cvss_vector": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "aliases": { "type": "array", "items": { "type": "string" } }, "fixed_in": { "type": "array", "items": { "type": "string" } }, "published": { "type": [ "string", "null" ] }, "url": { "type": "string" } } } } } }, "description": "Only packages with at least one advisory" }, "unpinned": { "type": "array", "items": { "type": "object" } }, "source": { "type": "object" }, "scanned_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "OSV.dev unavailable (never charged)" } } } }, "/pkgguard/v1/preview": { "get": { "operationId": "preview_package", "summary": "Free verdict + counts for one package (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "OSV.dev unavailable" } }, "parameters": [ { "name": "ecosystem", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "npm", "PyPI", "Go", "crates.io", "Packagist", "RubyGems", "Maven", "NuGet", "Pub", "Hex" ], "default": "npm" } }, { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 214 }, "description": "Package name, e.g. lodash, requests, github.com/gin-gonic/gin" }, { "name": "version", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 64 }, "description": "Exact version, e.g. 4.17.15" } ], "tags": [ "PkgGuard" ] }, "post": { "operationId": "preview_scan", "summary": "Free verdict + counts for a manifest or up to 25 packages", "security": [], "responses": { "200": { "description": "OK" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "OSV.dev unavailable" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "manifest": { "type": "string", "maxLength": 512000, "description": "File contents: package.json, package-lock.json, requirements.txt, Pipfile.lock, poetry.lock, go.mod, Cargo.lock, composer.lock" }, "filename": { "type": "string" }, "type": { "type": "string", "enum": [ "package.json", "package-lock.json", "requirements.txt", "Pipfile.lock", "poetry.lock", "go.mod", "Cargo.lock", "composer.lock" ] }, "include_dev": { "type": "boolean", "default": true }, "packages": { "type": "array", "maxItems": 500, "items": { "type": "object", "properties": { "ecosystem": { "type": "string", "enum": [ "npm", "PyPI", "Go", "crates.io", "Packagist", "RubyGems", "Maven", "NuGet", "Pub", "Hex" ] }, "name": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name", "version" ] } } } } } } }, "tags": [ "PkgGuard" ] } }, "/stackdetect/v1/detect": { "get": { "operationId": "detect_stack", "summary": "Technology stack of a website, with versions, confidence, evidence and DNS-based providers", "tags": [ "StackDetect", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 }, "description": "Absolute http(s) URL or bare domain, e.g. https://laravel.com" } ], "responses": { "200": { "description": "Detection result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "url": { "type": "string" }, "final_url": { "type": "string" }, "http_status": { "type": "integer" }, "content_type": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "technology_count": { "type": "integer" }, "technologies": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string", "enum": [ "cms", "ecommerce", "site-builder", "blog", "js-framework", "web-framework", "static-site-generator", "language", "server", "cdn", "hosting", "waf", "analytics", "tag-manager", "advertising", "marketing", "crm", "live-chat", "payments", "ui-library", "js-library", "fonts", "video", "ab-testing", "consent", "captcha", "monitoring", "search", "reviews", "maps", "forms", "email-provider", "email-delivery", "dns-provider", "saas", "web3", "auth", "database" ] } }, "version": { "type": [ "string", "null" ] }, "confidence": { "type": "integer", "minimum": 0, "maximum": 100 }, "evidence": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "header", "cookie", "meta", "script", "link", "html", "ip", "mx", "ns", "txt", "implied" ] }, "value": { "type": "string" } } } } } } }, "categories": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "providers": { "type": "object", "properties": { "email": { "type": "array" }, "email_delivery": { "type": "array" }, "dns": { "type": "array" }, "hosting": { "type": "array" }, "verified_saas": { "type": "array" } } }, "headers_seen": { "type": "object" }, "dns": { "type": [ "object", "null" ] }, "fetched": { "type": "object" }, "engine": { "type": "string" }, "scanned_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid or blocked URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Site error page with nothing detectable, or DNS failure (never charged)" }, "502": { "description": "Site unreachable (never charged)" }, "504": { "description": "Site timed out (never charged)" } } }, "post": { "operationId": "detect_stack_post", "summary": "Same as GET, POST {\"url\": \"...\"}", "tags": [ "StackDetect", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048 } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Detection result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "url": { "type": "string" }, "final_url": { "type": "string" }, "http_status": { "type": "integer" }, "content_type": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "technology_count": { "type": "integer" }, "technologies": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string", "enum": [ "cms", "ecommerce", "site-builder", "blog", "js-framework", "web-framework", "static-site-generator", "language", "server", "cdn", "hosting", "waf", "analytics", "tag-manager", "advertising", "marketing", "crm", "live-chat", "payments", "ui-library", "js-library", "fonts", "video", "ab-testing", "consent", "captcha", "monitoring", "search", "reviews", "maps", "forms", "email-provider", "email-delivery", "dns-provider", "saas", "web3", "auth", "database" ] } }, "version": { "type": [ "string", "null" ] }, "confidence": { "type": "integer", "minimum": 0, "maximum": 100 }, "evidence": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "header", "cookie", "meta", "script", "link", "html", "ip", "mx", "ns", "txt", "implied" ] }, "value": { "type": "string" } } } } } } }, "categories": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "providers": { "type": "object", "properties": { "email": { "type": "array" }, "email_delivery": { "type": "array" }, "dns": { "type": "array" }, "hosting": { "type": "array" }, "verified_saas": { "type": "array" } } }, "headers_seen": { "type": "object" }, "dns": { "type": [ "object", "null" ] }, "fetched": { "type": "object" }, "engine": { "type": "string" }, "scanned_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid or blocked URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Site error page with nothing detectable, or DNS failure (never charged)" }, "502": { "description": "Site unreachable (never charged)" }, "504": { "description": "Site timed out (never charged)" } } } }, "/stackdetect/v1/preview": { "get": { "operationId": "preview_stack", "summary": "Free: technology names and categories (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid URL" }, "429": { "description": "Free tier rate limit" } }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 }, "description": "Absolute http(s) URL or bare domain, e.g. https://laravel.com" } ], "tags": [ "StackDetect" ] }, "post": { "operationId": "preview_stack_post", "summary": "Free: same as GET, POST {\"url\": \"...\"}", "security": [], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid URL" }, "429": { "description": "Free tier rate limit" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048 } }, "required": [ "url" ] } } } }, "tags": [ "StackDetect" ] } }, "/tokenverdict/v1/lite": { "get": { "operationId": "token_verdict_lite", "summary": "Verdict (SAFE/CAUTION/DANGER), score 0-100 and the reasons ($0.005)", "tags": [ "TokenVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "description": "Base (chain 8453) ERC-20 contract address, e.g. 0x532f27101965dd16442E59d40670FaF5eBB142E4" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not a contract / not an ERC-20 on Base (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } }, "post": { "operationId": "token_verdict_lite_post", "summary": "Same as GET, POST {\"token\": \"0x...\"}", "tags": [ "TokenVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "token" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not a contract / not an ERC-20 on Base (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } } }, "/tokenverdict/v1/quick": { "get": { "operationId": "token_verdict_quick", "summary": "Full check with evidence: sell simulation and taxes, owner powers, proxy, liquidity and LP burn, holders, verification, age ($0.015)", "tags": [ "TokenVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "15000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "description": "Base (chain 8453) ERC-20 contract address, e.g. 0x532f27101965dd16442E59d40670FaF5eBB142E4" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not a contract / not an ERC-20 on Base (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } }, "post": { "operationId": "token_verdict_quick_post", "summary": "Same as GET, POST {\"token\": \"0x...\"}", "tags": [ "TokenVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "15000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "token" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not a contract / not an ERC-20 on Base (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } } }, "/tokenverdict/v1/deep": { "get": { "operationId": "token_verdict_deep", "summary": "Quick + simulations on up to 2 pools, pool table, creation block, GeckoTerminal cross-check ($0.05)", "tags": [ "TokenVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "description": "Base (chain 8453) ERC-20 contract address, e.g. 0x532f27101965dd16442E59d40670FaF5eBB142E4" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not a contract / not an ERC-20 on Base (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } }, "post": { "operationId": "token_verdict_deep_post", "summary": "Same as GET, POST {\"token\": \"0x...\"}", "tags": [ "TokenVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" } }, "required": [ "token" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not a contract / not an ERC-20 on Base (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } } }, "/tokenverdict/v1/preview": { "get": { "operationId": "token_verdict_preview", "summary": "Free: verdict, score and flag counts (no reasons), 10/min per IP", "security": [], "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$" }, "description": "Base (chain 8453) ERC-20 contract address, e.g. 0x532f27101965dd16442E59d40670FaF5eBB142E4" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid address" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "TokenVerdict" ] } }, "/signcheck/v1/check": { "post": { "operationId": "check_signature", "summary": "Is it safe to sign or send this? Verdict, reasons, on-chain facts and simulation", "tags": [ "SignCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "15000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "description": "base (default), ethereum, base-sepolia or a numeric chain id" }, "tx": { "type": "object", "properties": { "to": { "type": "string" }, "data": { "type": "string" }, "value": { "type": "string" }, "from": { "type": "string" } }, "required": [ "to" ] }, "typed_data": { "type": "object", "description": "EIP-712 {domain, types, primaryType, message}" }, "authorization": { "type": "object", "description": "EIP-7702 {address, chainId, nonce}" }, "payment_required": { "oneOf": [ { "type": "object" }, { "type": "string" } ], "description": "x402 PAYMENT-REQUIRED header (base64) or {accepts:[…]}" }, "payment_payload": { "oneOf": [ { "type": "object" }, { "type": "string" } ], "description": "x402 PAYMENT-SIGNATURE / X-PAYMENT (base64) or JSON" } } } } } }, "responses": { "200": { "description": "Check result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 }, "kind": { "type": "string", "enum": [ "transaction", "typed_data", "eip7702_authorization", "x402_payment" ] }, "action": { "type": "string" }, "summary": { "type": "string" }, "chain": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } }, "flags": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "message": { "type": "string" } } } }, "counterparties": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "label": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "eoa", "contract", "eip7702_delegated_eoa" ] }, "sanctioned": { "type": "object" } } } }, "decoded": { "type": "array" }, "x402": { "type": "object" }, "onchain": { "type": "object", "properties": { "available": { "type": "boolean" }, "block": { "type": [ "integer", "null" ] }, "tokens": { "type": "array" }, "simulation": { "type": [ "object", "null" ] }, "selector_names": { "type": [ "object", "null" ] } } }, "sanctions": { "type": "object" }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Body too large (never charged)" }, "503": { "description": "Chain RPC unavailable (never charged)" }, "504": { "description": "Timed out (never charged)" } } }, "get": { "operationId": "check_signature_get", "summary": "Same as POST, inputs as query parameters", "tags": [ "SignCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "15000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.to (or use POST for typed data / x402)" }, { "name": "data", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.data, 0x hex" }, { "name": "value", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.value in wei" }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.from (enables simulation)" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base | ethereum | base-sepolia | chain id" }, { "name": "typed_data", "in": "query", "required": false, "schema": { "type": "string" }, "description": "EIP-712 JSON (URL-encoded)" }, { "name": "payment_required", "in": "query", "required": false, "schema": { "type": "string" }, "description": "x402 PAYMENT-REQUIRED header value" }, { "name": "payment_payload", "in": "query", "required": false, "schema": { "type": "string" }, "description": "x402 PAYMENT-SIGNATURE header value" } ], "responses": { "200": { "description": "Check result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 }, "kind": { "type": "string", "enum": [ "transaction", "typed_data", "eip7702_authorization", "x402_payment" ] }, "action": { "type": "string" }, "summary": { "type": "string" }, "chain": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } }, "flags": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "message": { "type": "string" } } } }, "counterparties": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "label": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "eoa", "contract", "eip7702_delegated_eoa" ] }, "sanctioned": { "type": "object" } } } }, "decoded": { "type": "array" }, "x402": { "type": "object" }, "onchain": { "type": "object", "properties": { "available": { "type": "boolean" }, "block": { "type": [ "integer", "null" ] }, "tokens": { "type": "array" }, "simulation": { "type": [ "object", "null" ] }, "selector_names": { "type": [ "object", "null" ] } } }, "sanctions": { "type": "object" }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Body too large (never charged)" }, "503": { "description": "Chain RPC unavailable (never charged)" }, "504": { "description": "Timed out (never charged)" } } } }, "/signcheck/v1/lite": { "post": { "operationId": "check_signature_lite", "summary": "Offline check ($0.005): verdict, every flag with its reason, decoded args, counterparties, x402 payment-vs-402 match, OFAC SDN; no RPC", "tags": [ "SignCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "description": "base (default), ethereum, base-sepolia or a numeric chain id" }, "tx": { "type": "object", "properties": { "to": { "type": "string" }, "data": { "type": "string" }, "value": { "type": "string" }, "from": { "type": "string" } }, "required": [ "to" ] }, "typed_data": { "type": "object", "description": "EIP-712 {domain, types, primaryType, message}" }, "authorization": { "type": "object", "description": "EIP-7702 {address, chainId, nonce}" }, "payment_required": { "oneOf": [ { "type": "object" }, { "type": "string" } ], "description": "x402 PAYMENT-REQUIRED header (base64) or {accepts:[…]}" }, "payment_payload": { "oneOf": [ { "type": "object" }, { "type": "string" } ], "description": "x402 PAYMENT-SIGNATURE / X-PAYMENT (base64) or JSON" } } } } } }, "responses": { "200": { "description": "Check result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 }, "kind": { "type": "string", "enum": [ "transaction", "typed_data", "eip7702_authorization", "x402_payment" ] }, "action": { "type": "string" }, "summary": { "type": "string" }, "chain": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } }, "flags": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "message": { "type": "string" } } } }, "counterparties": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "label": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "eoa", "contract", "eip7702_delegated_eoa" ] }, "sanctioned": { "type": "object" } } } }, "decoded": { "type": "array" }, "x402": { "type": "object" }, "onchain": { "type": "object", "properties": { "available": { "type": "boolean" }, "block": { "type": [ "integer", "null" ] }, "tokens": { "type": "array" }, "simulation": { "type": [ "object", "null" ] }, "selector_names": { "type": [ "object", "null" ] } } }, "sanctions": { "type": "object" }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Body too large (never charged)" }, "503": { "description": "Chain RPC unavailable (never charged)" }, "504": { "description": "Timed out (never charged)" } } }, "get": { "operationId": "check_signature_lite_get", "summary": "Same as POST /v1/lite, inputs as query parameters", "tags": [ "SignCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.to (or use POST for typed data / x402)" }, { "name": "data", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.data, 0x hex" }, { "name": "value", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.value in wei" }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.from (enables simulation)" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base | ethereum | base-sepolia | chain id" }, { "name": "typed_data", "in": "query", "required": false, "schema": { "type": "string" }, "description": "EIP-712 JSON (URL-encoded)" }, { "name": "payment_required", "in": "query", "required": false, "schema": { "type": "string" }, "description": "x402 PAYMENT-REQUIRED header value" }, { "name": "payment_payload", "in": "query", "required": false, "schema": { "type": "string" }, "description": "x402 PAYMENT-SIGNATURE header value" } ], "responses": { "200": { "description": "Check result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 }, "kind": { "type": "string", "enum": [ "transaction", "typed_data", "eip7702_authorization", "x402_payment" ] }, "action": { "type": "string" }, "summary": { "type": "string" }, "chain": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } }, "flags": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "severity": { "type": "string", "enum": [ "critical", "high", "medium", "low", "info" ] }, "message": { "type": "string" } } } }, "counterparties": { "type": "array", "items": { "type": "object", "properties": { "address": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "label": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "eoa", "contract", "eip7702_delegated_eoa" ] }, "sanctioned": { "type": "object" } } } }, "decoded": { "type": "array" }, "x402": { "type": "object" }, "onchain": { "type": "object", "properties": { "available": { "type": "boolean" }, "block": { "type": [ "integer", "null" ] }, "tokens": { "type": "array" }, "simulation": { "type": [ "object", "null" ] }, "selector_names": { "type": [ "object", "null" ] } } }, "sanctions": { "type": "object" }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" }, "disclaimer": { "type": "string" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Body too large (never charged)" }, "503": { "description": "Chain RPC unavailable (never charged)" }, "504": { "description": "Timed out (never charged)" } } } }, "/signcheck/v1/preview": { "post": { "operationId": "preview_signature", "summary": "Free: offline verdict, summary and flag codes (10/min/IP)", "security": [], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "description": "base (default), ethereum, base-sepolia or a numeric chain id" }, "tx": { "type": "object", "properties": { "to": { "type": "string" }, "data": { "type": "string" }, "value": { "type": "string" }, "from": { "type": "string" } }, "required": [ "to" ] }, "typed_data": { "type": "object", "description": "EIP-712 {domain, types, primaryType, message}" }, "authorization": { "type": "object", "description": "EIP-7702 {address, chainId, nonce}" }, "payment_required": { "oneOf": [ { "type": "object" }, { "type": "string" } ], "description": "x402 PAYMENT-REQUIRED header (base64) or {accepts:[…]}" }, "payment_payload": { "oneOf": [ { "type": "object" }, { "type": "string" } ], "description": "x402 PAYMENT-SIGNATURE / X-PAYMENT (base64) or JSON" } } } } } }, "tags": [ "SignCheck" ] }, "get": { "operationId": "preview_signature_get", "summary": "Free: same as POST, query parameters", "security": [], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" } }, "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.to (or use POST for typed data / x402)" }, { "name": "data", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.data, 0x hex" }, { "name": "value", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.value in wei" }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" }, "description": "tx.from (enables simulation)" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" }, "description": "base | ethereum | base-sepolia | chain id" }, { "name": "typed_data", "in": "query", "required": false, "schema": { "type": "string" }, "description": "EIP-712 JSON (URL-encoded)" }, { "name": "payment_required", "in": "query", "required": false, "schema": { "type": "string" }, "description": "x402 PAYMENT-REQUIRED header value" }, { "name": "payment_payload", "in": "query", "required": false, "schema": { "type": "string" }, "description": "x402 PAYMENT-SIGNATURE header value" } ], "tags": [ "SignCheck" ] } }, "/counterpartycheck/v1/lite": { "get": { "operationId": "counterparty_lite", "summary": "Verdict (ok/caution/block) and reasons: OFAC SDN, ScamSniffer, x402 directory, labels, address type and activity ($0.005)", "tags": [ "CounterpartyCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Counterparty address: EVM 0x + 40 hex, or a Solana base58 address" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "description": "Chain of the payment (a base58 address implies solana)" }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" }, "description": "What you are about to do" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "intent": { "type": "string" }, "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "ok", "caution", "block" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "summary": { "type": "string" }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "facts": { "type": "object" }, "checks": { "type": "object" }, "sources": { "type": "object" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address, chain or intent (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Chain RPC unavailable (never charged)" } } }, "post": { "operationId": "counterparty_lite_post", "summary": "Same as GET, POST {\"address\": \"0x...\", \"chain\": \"base\", \"intent\": \"pay\"}", "tags": [ "CounterpartyCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "intent": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" } }, "required": [ "address" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "intent": { "type": "string" }, "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "ok", "caution", "block" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "summary": { "type": "string" }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "facts": { "type": "object" }, "checks": { "type": "object" }, "sources": { "type": "object" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address, chain or intent (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Chain RPC unavailable (never charged)" } } } }, "/counterpartycheck/v1/quick": { "get": { "operationId": "counterparty_quick", "summary": "Lite + contract verification and deployer, ENS / Basename, cross-chain presence, Safe / owner screening, explorer labels ($0.015)", "tags": [ "CounterpartyCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "15000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Counterparty address: EVM 0x + 40 hex, or a Solana base58 address" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "description": "Chain of the payment (a base58 address implies solana)" }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" }, "description": "What you are about to do" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "intent": { "type": "string" }, "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "ok", "caution", "block" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "summary": { "type": "string" }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "facts": { "type": "object" }, "checks": { "type": "object" }, "sources": { "type": "object" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address, chain or intent (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Chain RPC unavailable (never charged)" } } }, "post": { "operationId": "counterparty_quick_post", "summary": "Same as GET, POST {\"address\": \"0x...\", \"chain\": \"base\", \"intent\": \"pay\"}", "tags": [ "CounterpartyCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "15000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "intent": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" } }, "required": [ "address" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "intent": { "type": "string" }, "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "ok", "caution", "block" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "summary": { "type": "string" }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "facts": { "type": "object" }, "checks": { "type": "object" }, "sources": { "type": "object" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address, chain or intent (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Chain RPC unavailable (never charged)" } } } }, "/counterpartycheck/v1/full": { "get": { "operationId": "counterparty_full", "summary": "Quick + age, recent activity and exposure to listed addresses, recent approvals, TokenVerdict for Base tokens ($0.05)", "tags": [ "CounterpartyCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Counterparty address: EVM 0x + 40 hex, or a Solana base58 address" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "description": "Chain of the payment (a base58 address implies solana)" }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" }, "description": "What you are about to do" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "intent": { "type": "string" }, "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "ok", "caution", "block" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "summary": { "type": "string" }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "facts": { "type": "object" }, "checks": { "type": "object" }, "sources": { "type": "object" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address, chain or intent (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Chain RPC unavailable (never charged)" } } }, "post": { "operationId": "counterparty_full_post", "summary": "Same as GET, POST {\"address\": \"0x...\", \"chain\": \"base\", \"intent\": \"pay\"}", "tags": [ "CounterpartyCheck", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "intent": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" } }, "required": [ "address" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "intent": { "type": "string" }, "tier": { "type": "string" }, "verdict": { "type": "string", "enum": [ "ok", "caution", "block" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "summary": { "type": "string" }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "facts": { "type": "object" }, "checks": { "type": "object" }, "sources": { "type": "object" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address, chain or intent (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Chain RPC unavailable (never charged)" } } } }, "/counterpartycheck/v1/preview": { "get": { "operationId": "counterparty_preview", "summary": "Free: verdict, confidence, address kind and flag counts (no reasons), 10/min per IP", "security": [], "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Counterparty address: EVM 0x + 40 hex, or a Solana base58 address" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "base", "ethereum", "polygon", "arbitrum", "solana" ], "default": "base" }, "description": "Chain of the payment (a base58 address implies solana)" }, { "name": "intent", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pay", "approve", "interact" ], "default": "pay" }, "description": "What you are about to do" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "CounterpartyCheck" ] } }, "/x402fix/v1/lite": { "get": { "operationId": "x402fix_lite", "summary": "Grade and fix list for one paid x402 URL: transport (GET/HEAD/empty POST/CORS), v2 header, v1 body, accepts, multichain, Bazaar declaration ($0.005)", "tags": [ "x402fix", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" }, "description": "Full https URL of the paid x402 route (site: origin or API base URL)" }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "GET", "POST" ] }, "description": "Method your paid route uses (default from its Bazaar declaration)" }, { "name": "framework", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" }, "description": "Framework for the generated snippet (check tier)" } ], "responses": { "200": { "description": "Report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "tier": { "type": "string" }, "method": { "type": "string" }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "score": { "type": "integer" }, "status": { "type": "string", "enum": [ "pass", "ok_with_warnings", "fix_needed", "broken" ] }, "summary": { "type": "string" }, "counts": { "type": "object" }, "x402": { "type": "object" }, "probes": { "type": "object" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer" }, "severity": { "type": "string", "enum": [ "error", "warn" ] }, "id": { "type": "string" }, "problem": { "type": "string" }, "fix": { "type": "string" } } } }, "checks": { "type": "array", "items": { "type": "object" } }, "cdp": { "type": [ "object", "null" ] }, "generated": { "type": "object" }, "routes": { "type": "array" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid or private URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Check did not finish (never charged)" } } }, "post": { "operationId": "x402fix_lite_post", "summary": "Same as GET, POST {\"url\": \"https://api.example.com/v1/data\"}", "tags": [ "x402fix", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "method": { "type": "string", "enum": [ "GET", "POST" ] }, "framework": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "tier": { "type": "string" }, "method": { "type": "string" }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "score": { "type": "integer" }, "status": { "type": "string", "enum": [ "pass", "ok_with_warnings", "fix_needed", "broken" ] }, "summary": { "type": "string" }, "counts": { "type": "object" }, "x402": { "type": "object" }, "probes": { "type": "object" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer" }, "severity": { "type": "string", "enum": [ "error", "warn" ] }, "id": { "type": "string" }, "problem": { "type": "string" }, "fix": { "type": "string" } } } }, "checks": { "type": "array", "items": { "type": "object" } }, "cdp": { "type": [ "object", "null" ] }, "generated": { "type": "object" }, "routes": { "type": "array" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid or private URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Check did not finish (never charged)" } } } }, "/x402fix/v1/check": { "get": { "operationId": "x402fix_check", "summary": "Lite + CDP validate verdict and Bazaar index status, discovery docs, payee checks, generated extensions.bazaar block, multichain accepts and snippet ($0.02)", "tags": [ "x402fix", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" }, "description": "Full https URL of the paid x402 route (site: origin or API base URL)" }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "GET", "POST" ] }, "description": "Method your paid route uses (default from its Bazaar declaration)" }, { "name": "framework", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" }, "description": "Framework for the generated snippet (check tier)" } ], "responses": { "200": { "description": "Report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "tier": { "type": "string" }, "method": { "type": "string" }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "score": { "type": "integer" }, "status": { "type": "string", "enum": [ "pass", "ok_with_warnings", "fix_needed", "broken" ] }, "summary": { "type": "string" }, "counts": { "type": "object" }, "x402": { "type": "object" }, "probes": { "type": "object" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer" }, "severity": { "type": "string", "enum": [ "error", "warn" ] }, "id": { "type": "string" }, "problem": { "type": "string" }, "fix": { "type": "string" } } } }, "checks": { "type": "array", "items": { "type": "object" } }, "cdp": { "type": [ "object", "null" ] }, "generated": { "type": "object" }, "routes": { "type": "array" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid or private URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Check did not finish (never charged)" } } }, "post": { "operationId": "x402fix_check_post", "summary": "Same as GET, POST {\"url\": \"https://api.example.com/v1/data\"}", "tags": [ "x402fix", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "method": { "type": "string", "enum": [ "GET", "POST" ] }, "framework": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "tier": { "type": "string" }, "method": { "type": "string" }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "score": { "type": "integer" }, "status": { "type": "string", "enum": [ "pass", "ok_with_warnings", "fix_needed", "broken" ] }, "summary": { "type": "string" }, "counts": { "type": "object" }, "x402": { "type": "object" }, "probes": { "type": "object" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer" }, "severity": { "type": "string", "enum": [ "error", "warn" ] }, "id": { "type": "string" }, "problem": { "type": "string" }, "fix": { "type": "string" } } } }, "checks": { "type": "array", "items": { "type": "object" } }, "cdp": { "type": [ "object", "null" ] }, "generated": { "type": "object" }, "routes": { "type": "array" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid or private URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Check did not finish (never charged)" } } } }, "/x402fix/v1/site": { "get": { "operationId": "x402fix_site", "summary": "Whole origin: paid routes from /.well-known/x402 and /openapi.json (up to 8), grade and top fixes per route, discovery-doc drift ($0.05)", "tags": [ "x402fix", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" }, "description": "Full https URL of the paid x402 route (site: origin or API base URL)" }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "GET", "POST" ] }, "description": "Method your paid route uses (default from its Bazaar declaration)" }, { "name": "framework", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" }, "description": "Framework for the generated snippet (check tier)" } ], "responses": { "200": { "description": "Report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "tier": { "type": "string" }, "method": { "type": "string" }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "score": { "type": "integer" }, "status": { "type": "string", "enum": [ "pass", "ok_with_warnings", "fix_needed", "broken" ] }, "summary": { "type": "string" }, "counts": { "type": "object" }, "x402": { "type": "object" }, "probes": { "type": "object" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer" }, "severity": { "type": "string", "enum": [ "error", "warn" ] }, "id": { "type": "string" }, "problem": { "type": "string" }, "fix": { "type": "string" } } } }, "checks": { "type": "array", "items": { "type": "object" } }, "cdp": { "type": [ "object", "null" ] }, "generated": { "type": "object" }, "routes": { "type": "array" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid or private URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Check did not finish (never charged)" } } }, "post": { "operationId": "x402fix_site_post", "summary": "Same as GET, POST {\"url\": \"https://api.example.com/v1/data\"}", "tags": [ "x402fix", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "method": { "type": "string", "enum": [ "GET", "POST" ] }, "framework": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Report (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "tier": { "type": "string" }, "method": { "type": "string" }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "score": { "type": "integer" }, "status": { "type": "string", "enum": [ "pass", "ok_with_warnings", "fix_needed", "broken" ] }, "summary": { "type": "string" }, "counts": { "type": "object" }, "x402": { "type": "object" }, "probes": { "type": "object" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "n": { "type": "integer" }, "severity": { "type": "string", "enum": [ "error", "warn" ] }, "id": { "type": "string" }, "problem": { "type": "string" }, "fix": { "type": "string" } } } }, "checks": { "type": "array", "items": { "type": "object" } }, "cdp": { "type": [ "object", "null" ] }, "generated": { "type": "object" }, "routes": { "type": "array" }, "missing_data": { "type": "array", "items": { "type": "string" } }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid or private URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Check did not finish (never charged)" } } } }, "/x402fix/v1/preview": { "get": { "operationId": "x402fix_preview", "summary": "Free: grade, score, status and counts (no fixes), 10/min per IP", "security": [], "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" }, "description": "Full https URL of the paid x402 route (site: origin or API base URL)" }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "GET", "POST" ] }, "description": "Method your paid route uses (default from its Bazaar declaration)" }, { "name": "framework", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "hono", "express", "next" ], "default": "hono" }, "description": "Framework for the generated snippet (check tier)" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "x402fix" ] } }, "/solverdict/v1/lite": { "get": { "operationId": "solana_token_verdict_lite", "summary": "Verdict (SAFE/CAUTION/DANGER), score 0-100, reasons and key facts ($0.005)", "tags": [ "SolVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "mint", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$" }, "description": "Solana token mint address (base58), e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not an SPL / Token-2022 mint on Solana mainnet (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } }, "post": { "operationId": "solana_token_verdict_lite_post", "summary": "Same as GET, POST {\"mint\": \"\"}", "tags": [ "SolVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$" } }, "required": [ "mint" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not an SPL / Token-2022 mint on Solana mainnet (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } } }, "/solverdict/v1/check": { "get": { "operationId": "solana_token_verdict_check", "summary": "Full report: mint/freeze authority, Token-2022 extensions, metadata authority, pools, liquidity and 24 h sells, holders (wallets vs programs), age ($0.02)", "tags": [ "SolVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "mint", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$" }, "description": "Solana token mint address (base58), e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" } ], "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not an SPL / Token-2022 mint on Solana mainnet (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } }, "post": { "operationId": "solana_token_verdict_check_post", "summary": "Same as GET, POST {\"mint\": \"\"}", "tags": [ "SolVerdict", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$" } }, "required": [ "mint" ] } } } }, "responses": { "200": { "description": "Verdict (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "mint": { "type": "string" }, "chain": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "verdict": { "type": "string", "enum": [ "SAFE", "CAUTION", "DANGER" ] }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "reasons": { "type": "array", "items": { "type": "object", "properties": { "severity": { "type": "string", "enum": [ "danger", "warn", "info", "good" ] }, "code": { "type": "string" }, "text": { "type": "string" } } } }, "checks": { "type": "object" }, "limits": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid address (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Not an SPL / Token-2022 mint on Solana mainnet (never charged)" }, "503": { "description": "Data sources unavailable (never charged)" } } } }, "/solverdict/v1/preview": { "get": { "operationId": "solana_token_verdict_preview", "summary": "Free: verdict, score and flag counts (no reasons), 10/min per IP", "security": [], "parameters": [ { "name": "mint", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$" }, "description": "Solana token mint address (base58), e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid address" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "SolVerdict" ] } }, "/agentready/v1/lite": { "get": { "operationId": "agent_readiness_lite", "summary": "Score 0-100, grade, verdict, category scores, top 5 fixes, AI bots blocked ($0.005)", "tags": [ "AgentReady", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 }, "description": "Website URL or domain (public http/https), e.g. https://example.com or stripe.com" } ], "responses": { "200": { "description": "Audit (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "final_url": { "type": "string" }, "host": { "type": "string" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "verdict": { "type": "string", "enum": [ "agent_ready", "partially_ready", "not_ready" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "categories": { "type": "object" }, "counts": { "type": "object" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "category": { "type": "string" }, "status": { "type": "string", "enum": [ "pass", "warn", "fail", "unknown" ] }, "points": { "type": "number" }, "max": { "type": "number" }, "detail": { "type": "string" }, "evidence": { "type": "object" } } } }, "top_issues": { "type": "array" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "check": { "type": "string" }, "priority": { "type": "string", "enum": [ "high", "medium", "low" ] }, "points_gain": { "type": "number" }, "title": { "type": "string" }, "how": { "type": "string" }, "finding": { "type": "string" } } } }, "snippets": { "type": "object", "description": "llms_txt, robots_txt, json_ld, meta_tags, markdown, mcp_json, agent_card (only for checks that need them)" }, "robots": { "type": "object" }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid, private or internal URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Host does not resolve or resolves to a private address (never charged)" }, "503": { "description": "checks_incomplete: the site could not be fetched (never charged)" } } }, "post": { "operationId": "agent_readiness_lite_post", "summary": "Same as GET, POST {\"url\": \"https://example.com\"}", "tags": [ "AgentReady", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048 } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Audit (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "final_url": { "type": "string" }, "host": { "type": "string" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "verdict": { "type": "string", "enum": [ "agent_ready", "partially_ready", "not_ready" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "categories": { "type": "object" }, "counts": { "type": "object" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "category": { "type": "string" }, "status": { "type": "string", "enum": [ "pass", "warn", "fail", "unknown" ] }, "points": { "type": "number" }, "max": { "type": "number" }, "detail": { "type": "string" }, "evidence": { "type": "object" } } } }, "top_issues": { "type": "array" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "check": { "type": "string" }, "priority": { "type": "string", "enum": [ "high", "medium", "low" ] }, "points_gain": { "type": "number" }, "title": { "type": "string" }, "how": { "type": "string" }, "finding": { "type": "string" } } } }, "snippets": { "type": "object", "description": "llms_txt, robots_txt, json_ld, meta_tags, markdown, mcp_json, agent_card (only for checks that need them)" }, "robots": { "type": "object" }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid, private or internal URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Host does not resolve or resolves to a private address (never charged)" }, "503": { "description": "checks_incomplete: the site could not be fetched (never charged)" } } } }, "/agentready/v1/audit": { "get": { "operationId": "agent_readiness_audit", "summary": "Full audit: 23 checks with evidence, robots.txt matrix for 17 AI bots, prioritized fixes, ready-to-paste snippets (llms.txt draft, robots lines, JSON-LD, meta tags, mcp.json, agent card) ($0.03)", "tags": [ "AgentReady", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "30000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 }, "description": "Website URL or domain (public http/https), e.g. https://example.com or stripe.com" } ], "responses": { "200": { "description": "Audit (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "final_url": { "type": "string" }, "host": { "type": "string" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "verdict": { "type": "string", "enum": [ "agent_ready", "partially_ready", "not_ready" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "categories": { "type": "object" }, "counts": { "type": "object" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "category": { "type": "string" }, "status": { "type": "string", "enum": [ "pass", "warn", "fail", "unknown" ] }, "points": { "type": "number" }, "max": { "type": "number" }, "detail": { "type": "string" }, "evidence": { "type": "object" } } } }, "top_issues": { "type": "array" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "check": { "type": "string" }, "priority": { "type": "string", "enum": [ "high", "medium", "low" ] }, "points_gain": { "type": "number" }, "title": { "type": "string" }, "how": { "type": "string" }, "finding": { "type": "string" } } } }, "snippets": { "type": "object", "description": "llms_txt, robots_txt, json_ld, meta_tags, markdown, mcp_json, agent_card (only for checks that need them)" }, "robots": { "type": "object" }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid, private or internal URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Host does not resolve or resolves to a private address (never charged)" }, "503": { "description": "checks_incomplete: the site could not be fetched (never charged)" } } }, "post": { "operationId": "agent_readiness_audit_post", "summary": "Same as GET, POST {\"url\": \"https://example.com\"}", "tags": [ "AgentReady", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "30000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2048 } }, "required": [ "url" ] } } } }, "responses": { "200": { "description": "Audit (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "final_url": { "type": "string" }, "host": { "type": "string" }, "score": { "type": "integer", "minimum": 0, "maximum": 100 }, "grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "verdict": { "type": "string", "enum": [ "agent_ready", "partially_ready", "not_ready" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "categories": { "type": "object" }, "counts": { "type": "object" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "category": { "type": "string" }, "status": { "type": "string", "enum": [ "pass", "warn", "fail", "unknown" ] }, "points": { "type": "number" }, "max": { "type": "number" }, "detail": { "type": "string" }, "evidence": { "type": "object" } } } }, "top_issues": { "type": "array" }, "fixes": { "type": "array", "items": { "type": "object", "properties": { "check": { "type": "string" }, "priority": { "type": "string", "enum": [ "high", "medium", "low" ] }, "points_gain": { "type": "number" }, "title": { "type": "string" }, "how": { "type": "string" }, "finding": { "type": "string" } } } }, "snippets": { "type": "object", "description": "llms_txt, robots_txt, json_ld, meta_tags, markdown, mcp_json, agent_card (only for checks that need them)" }, "robots": { "type": "object" }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "warnings": { "type": "array", "items": { "type": "string" } }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid, private or internal URL (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "422": { "description": "Host does not resolve or resolves to a private address (never charged)" }, "503": { "description": "checks_incomplete: the site could not be fetched (never charged)" } } } }, "/agentready/v1/preview": { "get": { "operationId": "agent_readiness_preview", "summary": "Free: score, grade, category scores and counts (no findings or fixes), 10/min per IP", "security": [], "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2048 }, "description": "Website URL or domain (public http/https), e.g. https://example.com or stripe.com" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid URL" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "Site could not be fetched" } }, "tags": [ "AgentReady" ] } }, "/perpradar/v1/lite": { "get": { "operationId": "perp_funding_lite", "summary": "Funding rate (8h and APR) and open interest for one asset on every venue, cross-venue median, spread and positioning read ($0.005)", "description": "Perp funding rates for one asset across Hyperliquid, dYdX v4, Paradex and Aevo: per-venue funding normalized to 8h % and APR, open interest in USD, cross-venue median and OI-weighted funding, spread, cheapest venue to be long or short, and a positioning read (crowded long / long bias / neutral / short bias / crowded short). Fail-closed: failed venues are listed, never estimated. Not financial advice.", "tags": [ "PerpRadar", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" } ], "responses": { "200": { "description": "Per-venue funding (8h %, APR) and OI, median / OI-weighted funding, spread, cheapest venue for longs and shorts, positioning label, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "symbol": "BTC", "venues_ok": 4, "funding": { "median_apr_pct": 10.852, "median_8h_pct": 0.00991, "oi_weighted_apr_pct": 10.946, "min": { "venue": "aevo", "apr_pct": 5.256 }, "max": { "venue": "hyperliquid", "apr_pct": 10.95 }, "cross_venue_spread_apr_pct": 5.694, "cheapest_to_be_long": "aevo", "cheapest_to_be_short": "hyperliquid" }, "open_interest_usd_total": 3533643238, "positioning": "long_bias", "positioning_note": "Longs pay shorts: mild long bias.", "venues": [ { "venue": "hyperliquid", "market": "BTC", "funding_8h_pct": 0.01, "funding_apr_pct": 10.95, "funding_interval_hours": 1, "open_interest_usd": 3506609547 }, { "venue": "dydx", "market": "BTC-USD", "funding_8h_pct": 0.00983, "funding_apr_pct": 10.76, "funding_interval_hours": 1, "open_interest_usd": 17320891 } ], "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T18:52:54.632Z", "tier": "lite", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Read-only market analytics from public venue data at the time of the request; funding rates change every hour and can reverse. PerpRadar never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "perp_funding_lite_post", "summary": "Same as GET, POST {\"symbol\":\"BTC\"}", "tags": [ "PerpRadar", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" } }, "required": [ "symbol" ] } } } }, "responses": { "200": { "description": "Per-venue funding (8h %, APR) and OI, median / OI-weighted funding, spread, cheapest venue for longs and shorts, positioning label, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "symbol": "BTC", "venues_ok": 4, "funding": { "median_apr_pct": 10.852, "median_8h_pct": 0.00991, "oi_weighted_apr_pct": 10.946, "min": { "venue": "aevo", "apr_pct": 5.256 }, "max": { "venue": "hyperliquid", "apr_pct": 10.95 }, "cross_venue_spread_apr_pct": 5.694, "cheapest_to_be_long": "aevo", "cheapest_to_be_short": "hyperliquid" }, "open_interest_usd_total": 3533643238, "positioning": "long_bias", "positioning_note": "Longs pay shorts: mild long bias.", "venues": [ { "venue": "hyperliquid", "market": "BTC", "funding_8h_pct": 0.01, "funding_apr_pct": 10.95, "funding_interval_hours": 1, "open_interest_usd": 3506609547 }, { "venue": "dydx", "market": "BTC-USD", "funding_8h_pct": 0.00983, "funding_apr_pct": 10.76, "funding_interval_hours": 1, "open_interest_usd": 17320891 } ], "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T18:52:54.632Z", "tier": "lite", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Read-only market analytics from public venue data at the time of the request; funding rates change every hour and can reverse. PerpRadar never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/perpradar/v1/full": { "get": { "operationId": "perp_derivatives_full", "summary": "Full derivatives read: per-venue funding, OI, mark/index premium, 24h volume, 7-day funding history with z-score and percentile, regime, funding carry ($0.03)", "description": "Full perp derivatives snapshot for one asset across Hyperliquid, dYdX v4, Paradex and Aevo: funding (raw, 8h %, APR, interval), open interest, mark and index price, premium, 24h volume per venue; Hyperliquid 7-day and dYdX 100-hour funding history with mean, min, max, z-score and percentile of the latest rate; funding regime vs recent history; median premium read; annualized funding carry per venue; positioning read. Fail-closed. Not financial advice.", "tags": [ "PerpRadar", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "30000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" } ], "responses": { "200": { "description": "Everything in lite plus mark/index premium, 24h volume, funding history stats (mean, min, max, z-score, percentile), regime vs recent history, premium read and funding carry per venue. (payment settled)", "content": { "application/json": { "example": { "symbol": "ETH", "venues_ok": 4, "venues_listed": [ "hyperliquid", "dydx", "paradex", "aevo" ], "funding": { "median_apr_pct": 6.102, "median_8h_pct": 0.00557, "oi_weighted_apr_pct": 7.163, "min": { "venue": "dydx", "apr_pct": -14.247 }, "max": { "venue": "hyperliquid", "apr_pct": 7.303 }, "cross_venue_spread_apr_pct": 21.55, "cheapest_to_be_long": "dydx", "cheapest_to_be_short": "hyperliquid" }, "open_interest_usd_total": 2668271569, "positioning": "neutral", "positioning_note": "Funding is near zero: no strong positioning bias.", "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T18:52:56.021Z", "venues": [ { "venue": "hyperliquid", "market": "ETH", "funding_rate": 0.0000083364, "funding_interval_hours": 1, "funding_8h_pct": 0.00667, "funding_apr_pct": 7.303, "mark_price": 2385.2, "index_price": 2386.3, "premium_pct": -0.044, "open_interest": 1108650.3543999998, "open_interest_usd": 2644352825, "volume_24h_usd": 1010629837 }, { "venue": "dydx", "market": "ETH-USD", "funding_rate": -0.00001626415094339623, "funding_interval_hours": 1, "funding_8h_pct": -0.01301, "funding_apr_pct": -14.247, "mark_price": null, "index_price": 2382.782031, "premium_pct": null, "open_interest": 7116.24, "open_interest_usd": 16956449, "volume_24h_usd": 43372811 } ], "premium": { "median_pct": -0.044, "read": "perps trade near index" }, "history": { "hyperliquid_7d": { "samples": 168, "mean_apr_pct": 7.768, "min_apr_pct": -11.915, "max_apr_pct": 10.95, "latest_apr_pct": 7.575, "zscore_latest": -0.04, "percentile_latest": 31, "positive_share_pct": 90 }, "dydx_100h": { "samples": 100, "mean_apr_pct": 14.674, "min_apr_pct": -16.863, "max_apr_pct": 86.286, "latest_apr_pct": -2.299, "zscore_latest": -0.87, "percentile_latest": 13, "positive_share_pct": 55 } }, "regime": { "vs_recent": "funding within its recent range", "zscore": -0.04, "percentile": 31, "based_on": "hyperliquid_7d" }, "carry": [ { "venue": "hyperliquid", "short_perp_funding_apr_pct": 7.303, "note": "a short perp position currently receives funding" }, { "venue": "dydx", "short_perp_funding_apr_pct": -14.247, "note": "a short perp position currently pays funding" } ], "carry_note": "Funding carry is the annualized funding a delta-neutral short-perp / long-spot position would receive at the current rate, before fees, slippage and borrow. Rates change hourly; not a return forecast.", "tier": "full", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Read-only market analytics from public venue data at the time of the request; funding rates change every hour and can reverse. PerpRadar never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "perp_derivatives_full_post", "summary": "Same as GET, POST {\"symbol\":\"ETH\"}", "tags": [ "PerpRadar", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "30000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" } }, "required": [ "symbol" ] } } } }, "responses": { "200": { "description": "Everything in lite plus mark/index premium, 24h volume, funding history stats (mean, min, max, z-score, percentile), regime vs recent history, premium read and funding carry per venue. (payment settled)", "content": { "application/json": { "example": { "symbol": "ETH", "venues_ok": 4, "venues_listed": [ "hyperliquid", "dydx", "paradex", "aevo" ], "funding": { "median_apr_pct": 6.102, "median_8h_pct": 0.00557, "oi_weighted_apr_pct": 7.163, "min": { "venue": "dydx", "apr_pct": -14.247 }, "max": { "venue": "hyperliquid", "apr_pct": 7.303 }, "cross_venue_spread_apr_pct": 21.55, "cheapest_to_be_long": "dydx", "cheapest_to_be_short": "hyperliquid" }, "open_interest_usd_total": 2668271569, "positioning": "neutral", "positioning_note": "Funding is near zero: no strong positioning bias.", "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T18:52:56.021Z", "venues": [ { "venue": "hyperliquid", "market": "ETH", "funding_rate": 0.0000083364, "funding_interval_hours": 1, "funding_8h_pct": 0.00667, "funding_apr_pct": 7.303, "mark_price": 2385.2, "index_price": 2386.3, "premium_pct": -0.044, "open_interest": 1108650.3543999998, "open_interest_usd": 2644352825, "volume_24h_usd": 1010629837 }, { "venue": "dydx", "market": "ETH-USD", "funding_rate": -0.00001626415094339623, "funding_interval_hours": 1, "funding_8h_pct": -0.01301, "funding_apr_pct": -14.247, "mark_price": null, "index_price": 2382.782031, "premium_pct": null, "open_interest": 7116.24, "open_interest_usd": 16956449, "volume_24h_usd": 43372811 } ], "premium": { "median_pct": -0.044, "read": "perps trade near index" }, "history": { "hyperliquid_7d": { "samples": 168, "mean_apr_pct": 7.768, "min_apr_pct": -11.915, "max_apr_pct": 10.95, "latest_apr_pct": 7.575, "zscore_latest": -0.04, "percentile_latest": 31, "positive_share_pct": 90 }, "dydx_100h": { "samples": 100, "mean_apr_pct": 14.674, "min_apr_pct": -16.863, "max_apr_pct": 86.286, "latest_apr_pct": -2.299, "zscore_latest": -0.87, "percentile_latest": 13, "positive_share_pct": 55 } }, "regime": { "vs_recent": "funding within its recent range", "zscore": -0.04, "percentile": 31, "based_on": "hyperliquid_7d" }, "carry": [ { "venue": "hyperliquid", "short_perp_funding_apr_pct": 7.303, "note": "a short perp position currently receives funding" }, { "venue": "dydx", "short_perp_funding_apr_pct": -14.247, "note": "a short perp position currently pays funding" } ], "carry_note": "Funding carry is the annualized funding a delta-neutral short-perp / long-spot position would receive at the current rate, before fees, slippage and borrow. Rates change hourly; not a return forecast.", "tier": "full", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Read-only market analytics from public venue data at the time of the request; funding rates change every hour and can reverse. PerpRadar never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/perpradar/v1/scan": { "get": { "operationId": "perp_funding_scan", "summary": "Funding scan: a watchlist (symbols=BTC,ETH,SOL) or the whole universe (universe=all): highest and lowest funding, widest cross-venue spreads, market-wide OI-weighted funding ($0.02)", "description": "Cross-venue perp funding scan over Hyperliquid, dYdX v4 and Paradex: pass a watchlist (symbols=BTC,ETH,SOL, up to 25) or universe=all (every market above min_oi_usd, default $1M). Returns the highest and lowest funding (APR), the widest cross-venue funding spreads, the market-wide OI-weighted funding and share of markets with positive funding, with a per-asset positioning label. Fail-closed. Not financial advice.", "tags": [ "PerpRadar", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbols", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma-separated tickers (max 25), e.g. BTC,ETH,SOL. Either symbols or universe=all is required." }, { "name": "universe", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "all" ] }, "description": "all = scan every market above min_oi_usd" }, { "name": "min_oi_usd", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Universe mode: minimum open interest in USD per venue market (default 1000000)" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Rows per list, 1-25 (default 10)" } ], "responses": { "200": { "description": "Highest / lowest funding assets, widest cross-venue spreads, market-wide OI-weighted funding and positive-funding share, per-asset venues and positioning; watchlist rows when symbols is given. (payment settled)", "content": { "application/json": { "example": { "mode": "universe", "filters": { "min_oi_usd": 1000000 }, "venues_ok": [ "dydx", "hyperliquid", "paradex" ], "assets": 118, "market": { "oi_weighted_funding_apr_pct": 9.539, "positive_funding_share_pct": 86, "read": "neutral" }, "highest_funding": [ { "symbol": "XMR", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 93.971, "funding_8h_pct": 0.08582, "open_interest_usd": 106206803, "premium_pct": 0.2346 } ], "median_apr_pct": 93.971, "spread_apr_pct": null, "oi_usd_total": 106206803, "positioning": "crowded_long", "single_venue": true }, { "symbol": "APEX", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 33.591, "funding_8h_pct": 0.03068, "open_interest_usd": 1655347, "premium_pct": 0.1137 } ], "median_apr_pct": 33.591, "spread_apr_pct": null, "oi_usd_total": 1655347, "positioning": "crowded_long", "single_venue": true } ], "lowest_funding": [ { "symbol": "ALT", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": -2420.89, "funding_8h_pct": -2.21086, "open_interest_usd": 1809419, "premium_pct": -2.2973 } ], "median_apr_pct": -2420.89, "spread_apr_pct": null, "oi_usd_total": 1809419, "positioning": "crowded_short", "single_venue": true }, { "symbol": "ADA", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": -73.947, "funding_8h_pct": -0.06753, "open_interest_usd": 30379619, "premium_pct": -0.0915 } ], "median_apr_pct": -73.947, "spread_apr_pct": null, "oi_usd_total": 30379619, "positioning": "crowded_short", "single_venue": true } ], "widest_spreads": [ { "symbol": "ETH", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 7.303, "funding_8h_pct": 0.00667, "open_interest_usd": 2644352825, "premium_pct": -0.044 }, { "venue": "dydx", "funding_apr_pct": -14.247, "funding_8h_pct": -0.01301, "open_interest_usd": 16956449, "premium_pct": null }, { "venue": "paradex", "funding_apr_pct": 6.072, "funding_8h_pct": 0.00554, "open_interest_usd": 3010469, "premium_pct": 0.0326 } ], "median_apr_pct": 6.072, "spread_apr_pct": 21.55, "oi_usd_total": 2664319743, "positioning": "neutral", "single_venue": false }, { "symbol": "SOL", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 10.104, "funding_8h_pct": 0.00923, "open_interest_usd": 576024148, "premium_pct": -0.0527 }, { "venue": "dydx", "funding_apr_pct": 24.916, "funding_8h_pct": 0.02275, "open_interest_usd": 5692608, "premium_pct": null } ], "median_apr_pct": 17.51, "spread_apr_pct": 14.812, "oi_usd_total": 581716756, "positioning": "long_bias", "single_venue": false } ], "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T18:52:56.514Z", "tier": "scan", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Read-only market analytics from public venue data at the time of the request; funding rates change every hour and can reverse. PerpRadar never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "perp_funding_scan_post", "summary": "Same as GET, POST {\"universe\":\"all\"}", "tags": [ "PerpRadar", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbols": { "type": "string", "description": "Comma-separated tickers (max 25), e.g. BTC,ETH,SOL. Either symbols or universe=all is required." }, "universe": { "type": "string", "enum": [ "all" ], "description": "all = scan every market above min_oi_usd" }, "min_oi_usd": { "type": "number", "description": "Universe mode: minimum open interest in USD per venue market (default 1000000)" }, "limit": { "type": "integer", "description": "Rows per list, 1-25 (default 10)" } } } } } }, "responses": { "200": { "description": "Highest / lowest funding assets, widest cross-venue spreads, market-wide OI-weighted funding and positive-funding share, per-asset venues and positioning; watchlist rows when symbols is given. (payment settled)", "content": { "application/json": { "example": { "mode": "universe", "filters": { "min_oi_usd": 1000000 }, "venues_ok": [ "dydx", "hyperliquid", "paradex" ], "assets": 118, "market": { "oi_weighted_funding_apr_pct": 9.539, "positive_funding_share_pct": 86, "read": "neutral" }, "highest_funding": [ { "symbol": "XMR", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 93.971, "funding_8h_pct": 0.08582, "open_interest_usd": 106206803, "premium_pct": 0.2346 } ], "median_apr_pct": 93.971, "spread_apr_pct": null, "oi_usd_total": 106206803, "positioning": "crowded_long", "single_venue": true }, { "symbol": "APEX", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 33.591, "funding_8h_pct": 0.03068, "open_interest_usd": 1655347, "premium_pct": 0.1137 } ], "median_apr_pct": 33.591, "spread_apr_pct": null, "oi_usd_total": 1655347, "positioning": "crowded_long", "single_venue": true } ], "lowest_funding": [ { "symbol": "ALT", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": -2420.89, "funding_8h_pct": -2.21086, "open_interest_usd": 1809419, "premium_pct": -2.2973 } ], "median_apr_pct": -2420.89, "spread_apr_pct": null, "oi_usd_total": 1809419, "positioning": "crowded_short", "single_venue": true }, { "symbol": "ADA", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": -73.947, "funding_8h_pct": -0.06753, "open_interest_usd": 30379619, "premium_pct": -0.0915 } ], "median_apr_pct": -73.947, "spread_apr_pct": null, "oi_usd_total": 30379619, "positioning": "crowded_short", "single_venue": true } ], "widest_spreads": [ { "symbol": "ETH", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 7.303, "funding_8h_pct": 0.00667, "open_interest_usd": 2644352825, "premium_pct": -0.044 }, { "venue": "dydx", "funding_apr_pct": -14.247, "funding_8h_pct": -0.01301, "open_interest_usd": 16956449, "premium_pct": null }, { "venue": "paradex", "funding_apr_pct": 6.072, "funding_8h_pct": 0.00554, "open_interest_usd": 3010469, "premium_pct": 0.0326 } ], "median_apr_pct": 6.072, "spread_apr_pct": 21.55, "oi_usd_total": 2664319743, "positioning": "neutral", "single_venue": false }, { "symbol": "SOL", "venues": [ { "venue": "hyperliquid", "funding_apr_pct": 10.104, "funding_8h_pct": 0.00923, "open_interest_usd": 576024148, "premium_pct": -0.0527 }, { "venue": "dydx", "funding_apr_pct": 24.916, "funding_8h_pct": 0.02275, "open_interest_usd": 5692608, "premium_pct": null } ], "median_apr_pct": 17.51, "spread_apr_pct": 14.812, "oi_usd_total": 581716756, "positioning": "long_bias", "single_venue": false } ], "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T18:52:56.514Z", "tier": "scan", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Read-only market analytics from public venue data at the time of the request; funding rates change every hour and can reverse. PerpRadar never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/perpradar/v1/preview": { "get": { "operationId": "perpradar_preview", "summary": "Free: positioning label, venues listing the asset, confidence and sources_failed (no rates), 10/min per IP", "security": [], "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "Data sources unavailable" } }, "tags": [ "PerpRadar" ] } }, "/tasignal/v1/lite": { "get": { "operationId": "ta_indicators_lite", "summary": "Indicator snapshot + technical bias: RSI, MACD, EMA 20/50/200, Bollinger, ATR, ADX, stochastic, realized vol, trend and regime ($0.005)", "description": "Technical indicators for any crypto asset on closed 15m/1h/4h/1d candles: RSI 14, MACD 12/26/9 with cross, EMA 20/50/200, SMA 20, Bollinger Bands 20/2 (%b, bandwidth), ATR 14 and ATR %, ADX 14 with +DI/-DI, stochastic %K, annualized realized volatility, volume vs 20-bar average, 20-bar high/low; plus a descriptive technical bias score (-100..100) with components, trend (up/down/mixed) and regime (trending/ranging). Candles from Hyperliquid, dYdX v4 fallback. Not financial advice.", "tags": [ "TASignal", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ] }, "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" } ], "responses": { "200": { "description": "Indicators (RSI, MACD, EMAs, Bollinger, ATR, ADX, stochastic, realized vol), technical bias score with components, trend, regime, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "symbol": "BTC", "timeframe": "1h", "source": "hyperliquid", "market": "BTC", "candles_used": 300, "last_closed_at": "2026-10-22T19:00:00.000Z", "last_price": 81399, "indicators": { "close": 81381, "ema_20": 82179.416, "ema_50": 82607.493, "ema_200": 82541.062, "sma_20": 82305.95, "rsi_14": 30.65, "macd": { "line": -550.39178, "signal": -449.65055, "histogram": -100.74123, "cross": "none" }, "bollinger_20_2": { "upper": 83991.316, "middle": 82305.95, "lower": 80620.584, "percent_b": 0.226, "bandwidth_pct": 4.095 }, "atr_14": 443.84296, "atr_pct": 0.545, "adx_14": { "adx": 46.16, "plus_di": 8.15, "minus_di": 35.13 }, "stochastic_k_14": 22.64, "realized_vol_annual_pct": 30.4, "volume_vs_20_avg": 0.926, "change_pct": { "bars_1": 0.22, "bars_24": -3.554 }, "high_20": 84459, "low_20": 80911, "notes": [] }, "signal": { "bias": "strong_bearish", "score": -84, "trend": "mixed", "regime": "trending", "components": [ { "name": "ema_20_vs_50", "points": -20, "why": "EMA20 below EMA50" }, { "name": "price_vs_ema_200", "points": -20, "why": "price below EMA200" }, { "name": "macd_histogram", "points": -15, "why": "MACD below signal" }, { "name": "rsi_14", "points": -10, "why": "RSI below 50" }, { "name": "adx_direction", "points": -15, "why": "trend strength ADX 46.16 (-DI leads)" }, { "name": "bollinger_percent_b", "points": 0, "why": "inside the bands" } ], "note": "Descriptive summary of the indicators above on closed candles; not a prediction or a recommendation to trade." }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T19:00:54.379Z", "tier": "lite", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Technical indicators, risk metrics and backtests describe historical prices only; they are not predictions or trade recommendations. TASignal never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "ta_indicators_lite_post", "summary": "Same as GET, POST {\"symbol\":\"BTC\",\"timeframe\":\"1h\"}", "tags": [ "TASignal", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, "timeframe": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ], "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" } }, "required": [ "symbol" ] } } } }, "responses": { "200": { "description": "Indicators (RSI, MACD, EMAs, Bollinger, ATR, ADX, stochastic, realized vol), technical bias score with components, trend, regime, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "symbol": "BTC", "timeframe": "1h", "source": "hyperliquid", "market": "BTC", "candles_used": 300, "last_closed_at": "2026-10-22T19:00:00.000Z", "last_price": 81399, "indicators": { "close": 81381, "ema_20": 82179.416, "ema_50": 82607.493, "ema_200": 82541.062, "sma_20": 82305.95, "rsi_14": 30.65, "macd": { "line": -550.39178, "signal": -449.65055, "histogram": -100.74123, "cross": "none" }, "bollinger_20_2": { "upper": 83991.316, "middle": 82305.95, "lower": 80620.584, "percent_b": 0.226, "bandwidth_pct": 4.095 }, "atr_14": 443.84296, "atr_pct": 0.545, "adx_14": { "adx": 46.16, "plus_di": 8.15, "minus_di": 35.13 }, "stochastic_k_14": 22.64, "realized_vol_annual_pct": 30.4, "volume_vs_20_avg": 0.926, "change_pct": { "bars_1": 0.22, "bars_24": -3.554 }, "high_20": 84459, "low_20": 80911, "notes": [] }, "signal": { "bias": "strong_bearish", "score": -84, "trend": "mixed", "regime": "trending", "components": [ { "name": "ema_20_vs_50", "points": -20, "why": "EMA20 below EMA50" }, { "name": "price_vs_ema_200", "points": -20, "why": "price below EMA200" }, { "name": "macd_histogram", "points": -15, "why": "MACD below signal" }, { "name": "rsi_14", "points": -10, "why": "RSI below 50" }, { "name": "adx_direction", "points": -15, "why": "trend strength ADX 46.16 (-DI leads)" }, { "name": "bollinger_percent_b", "points": 0, "why": "inside the bands" } ], "note": "Descriptive summary of the indicators above on closed candles; not a prediction or a recommendation to trade." }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T19:00:54.379Z", "tier": "lite", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Technical indicators, risk metrics and backtests describe historical prices only; they are not predictions or trade recommendations. TASignal never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/tasignal/v1/risk": { "get": { "operationId": "ta_risk_position_size", "summary": "Risk analytics + position sizing: historical VaR/CVaR 95/99, max and current drawdown, volatility, Sharpe/Sortino, ATR stop, units, notional, leverage ($0.02)", "description": "Risk analytics and position sizing for a crypto asset: historical VaR and CVaR at 95/99% per bar and per day, annualized volatility, max drawdown and current drawdown from the high, Sharpe and Sortino, worst/best bar over up to 1000 closed candles; ATR(14)-based stop (or your stop), risk per unit and, with account_usd and risk_pct, the position size in units and USD notional, implied leverage and 2R/3R levels. Not financial advice.", "tags": [ "TASignal", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ] }, "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" }, { "name": "account_usd", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Account size in USD (optional; enables units, notional, leverage)" }, { "name": "risk_pct", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Percent of the account risked if the stop is hit (default 1)" }, { "name": "side", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "long", "short" ] }, "description": "Position side (default long)" }, { "name": "stop_atr", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Stop distance in ATR(14) multiples when no stop is given (default 2)" }, { "name": "entry", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Entry price (default: last price)" }, { "name": "stop", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Stop price (optional; overrides stop_atr)" }, { "name": "bars", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Candles for risk metrics, 50-1000 (default 500)" } ], "responses": { "200": { "description": "VaR/CVaR, volatility, drawdowns, Sharpe/Sortino, ATR, stop price and distance, units, notional, implied leverage, 2R/3R levels. (payment settled)", "content": { "application/json": { "example": { "symbol": "ETH", "timeframe": "4h", "source": "hyperliquid", "market": "ETH", "candles_used": 500, "last_price": 2383.6, "atr_14": 36.160089, "atr_pct": 1.517, "risk": { "bars": 499, "period_return_pct": 27.347, "volatility_annual_pct": 49.18, "sharpe_annual": 2.4, "sortino_annual": 3.914, "max_drawdown_pct": -15.882, "current_drawdown_from_high_pct": -13.65, "var_95_per_bar_pct": 1.394, "var_99_per_bar_pct": 2.972, "cvar_95_per_bar_pct": 2.237, "cvar_99_per_bar_pct": 3.406, "var_95_1d_pct": 3.415, "var_99_1d_pct": 7.281, "worst_bar_pct": -4.03, "best_bar_pct": 8.496, "method": "historical simulation on closed-candle simple returns; 1-day VaR scaled by sqrt(time); Sharpe/Sortino use a 0% risk-free rate" }, "position_sizing": { "side": "long", "entry": 2383.6, "stop": 2311.2798, "stop_method": "2 x ATR(14) from entry", "stop_distance_pct": 3.034, "risk_per_unit": 72.320178, "risk_pct_of_account": 1, "account_usd": 10000, "risk_usd": 100, "units": 1.38274, "notional_usd": 3295.9, "implied_leverage": 0.33, "take_profit_2r": 2528.2404, "take_profit_3r": 2600.5605 }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T19:00:54.578Z", "tier": "risk", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Technical indicators, risk metrics and backtests describe historical prices only; they are not predictions or trade recommendations. TASignal never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "ta_risk_position_size_post", "summary": "Same as GET, POST {\"symbol\":\"ETH\",\"timeframe\":\"4h\",\"account_usd\":10000,\"risk_pct\":1,\"side\":\"long\"}", "tags": [ "TASignal", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, "timeframe": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ], "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" }, "account_usd": { "type": "number", "description": "Account size in USD (optional; enables units, notional, leverage)" }, "risk_pct": { "type": "number", "description": "Percent of the account risked if the stop is hit (default 1)" }, "side": { "type": "string", "enum": [ "long", "short" ], "description": "Position side (default long)" }, "stop_atr": { "type": "number", "description": "Stop distance in ATR(14) multiples when no stop is given (default 2)" }, "entry": { "type": "number", "description": "Entry price (default: last price)" }, "stop": { "type": "number", "description": "Stop price (optional; overrides stop_atr)" }, "bars": { "type": "integer", "description": "Candles for risk metrics, 50-1000 (default 500)" } }, "required": [ "symbol" ] } } } }, "responses": { "200": { "description": "VaR/CVaR, volatility, drawdowns, Sharpe/Sortino, ATR, stop price and distance, units, notional, implied leverage, 2R/3R levels. (payment settled)", "content": { "application/json": { "example": { "symbol": "ETH", "timeframe": "4h", "source": "hyperliquid", "market": "ETH", "candles_used": 500, "last_price": 2383.6, "atr_14": 36.160089, "atr_pct": 1.517, "risk": { "bars": 499, "period_return_pct": 27.347, "volatility_annual_pct": 49.18, "sharpe_annual": 2.4, "sortino_annual": 3.914, "max_drawdown_pct": -15.882, "current_drawdown_from_high_pct": -13.65, "var_95_per_bar_pct": 1.394, "var_99_per_bar_pct": 2.972, "cvar_95_per_bar_pct": 2.237, "cvar_99_per_bar_pct": 3.406, "var_95_1d_pct": 3.415, "var_99_1d_pct": 7.281, "worst_bar_pct": -4.03, "best_bar_pct": 8.496, "method": "historical simulation on closed-candle simple returns; 1-day VaR scaled by sqrt(time); Sharpe/Sortino use a 0% risk-free rate" }, "position_sizing": { "side": "long", "entry": 2383.6, "stop": 2311.2798, "stop_method": "2 x ATR(14) from entry", "stop_distance_pct": 3.034, "risk_per_unit": 72.320178, "risk_pct_of_account": 1, "account_usd": 10000, "risk_usd": 100, "units": 1.38274, "notional_usd": 3295.9, "implied_leverage": 0.33, "take_profit_2r": 2528.2404, "take_profit_3r": 2600.5605 }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T19:00:54.578Z", "tier": "risk", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Technical indicators, risk metrics and backtests describe historical prices only; they are not predictions or trade recommendations. TASignal never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/tasignal/v1/backtest": { "get": { "operationId": "ta_backtest", "summary": "Rule backtest: SMA/EMA cross, RSI reversion, Donchian breakout or MACD cross on up to 2000 candles with fees; return vs buy-and-hold, drawdown, Sharpe, win rate, profit factor, trades, equity curve ($0.05)", "description": "Backtest a rule-based strategy (sma_cross, ema_cross, rsi_reversion, breakout, macd_cross) on up to 2000 closed candles of any crypto asset: signals on close, next-open fills, fees per side, long-only or long/short. Returns total and annualized return vs buy-and-hold, max drawdown, Sharpe, trades, win rate, profit factor, average trade, exposure, the last 20 trades and a 50-point equity curve. Historical simulation only. Not financial advice. Past performance does not guarantee future results.", "tags": [ "TASignal", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ] }, "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" }, { "name": "strategy", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "sma_cross", "ema_cross", "rsi_reversion", "breakout", "macd_cross" ] }, "description": "Strategy rule" }, { "name": "fast", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Fast period (sma_cross/ema_cross default 20, macd_cross 12)" }, { "name": "slow", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Slow period (sma_cross/ema_cross default 50, macd_cross 26)" }, { "name": "signal", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "MACD signal period (default 9)" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "RSI period (default 14) or breakout lookback (default 20)" }, { "name": "lower", "in": "query", "required": false, "schema": { "type": "number" }, "description": "RSI entry level for longs (default 30)" }, { "name": "upper", "in": "query", "required": false, "schema": { "type": "number" }, "description": "RSI entry level for shorts / exit (default 70)" }, { "name": "direction", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "long_only", "long_short" ] }, "description": "default long_only" }, { "name": "fee_bps", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Fee per side in basis points (default 5)" }, { "name": "bars", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Candles to test, 100-2000 (default 500)" } ], "responses": { "200": { "description": "Total / annualized return, vs buy-and-hold, max drawdown, Sharpe, trades, win rate, profit factor, exposure, last 20 trades, equity curve, current position. (payment settled)", "content": { "application/json": { "example": { "symbol": "SOL", "timeframe": "4h", "source": "hyperliquid", "market": "SOL", "candles_used": 500, "strategy": { "name": "ema_cross", "params": { "fast": 20, "slow": 50 }, "direction": "long_only" }, "result": { "period": { "from": "2026-08-08T16:00:00.000Z", "to": "2026-10-22T16:00:00.000Z", "bars": 450 }, "total_return_pct": 42.693, "buy_and_hold_return_pct": 36.933, "excess_vs_buy_and_hold_pct": 5.759, "annualized_return_pct": 464.18, "max_drawdown_pct": -10.327, "sharpe_annual": 3.869, "trades": 2, "win_rate_pct": 100, "profit_factor": null, "avg_trade_pct": 19.972, "exposure_pct": 69.78, "fees_bps_per_side": 5, "last_trades": [ { "side": "long", "entry_time": "2026-08-08T16:00:00.000Z", "entry": 76.373, "exit_time": "2026-09-10T16:00:00.000Z", "exit": 99.676, "return_pct": 30.447 }, { "side": "long", "entry_time": "2026-09-18T12:00:00.000Z", "entry": 105.74, "exit_time": "2026-10-07T20:00:00.000Z", "exit": 115.84, "return_pct": 9.497 } ], "equity_curve": [ [ "2026-08-08T16:00:00.000Z", 0.99632 ], [ "2026-08-23T16:00:00.000Z", 1.24486 ], [ "2026-09-07T16:00:00.000Z", 1.36524 ], [ "2026-09-22T16:00:00.000Z", 1.45808 ], [ "2026-10-07T16:00:00.000Z", 1.42764 ], [ "2026-10-22T12:00:00.000Z", 1.42693 ] ], "current_position": "flat", "assumptions": "Signals on candle close, fills at the next candle open, fees per side as set; no slippage, funding, borrow or liquidity limits; position size 100% of equity, no leverage." }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T19:00:54.904Z", "tier": "backtest", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Technical indicators, risk metrics and backtests describe historical prices only; they are not predictions or trade recommendations. TASignal never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "ta_backtest_post", "summary": "Same as GET, POST {\"symbol\":\"SOL\",\"timeframe\":\"4h\",\"strategy\":\"ema_cross\",\"fast\":20,\"slow\":50}", "tags": [ "TASignal", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "50000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, "timeframe": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ], "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" }, "strategy": { "type": "string", "enum": [ "sma_cross", "ema_cross", "rsi_reversion", "breakout", "macd_cross" ], "description": "Strategy rule" }, "fast": { "type": "integer", "description": "Fast period (sma_cross/ema_cross default 20, macd_cross 12)" }, "slow": { "type": "integer", "description": "Slow period (sma_cross/ema_cross default 50, macd_cross 26)" }, "signal": { "type": "integer", "description": "MACD signal period (default 9)" }, "period": { "type": "integer", "description": "RSI period (default 14) or breakout lookback (default 20)" }, "lower": { "type": "number", "description": "RSI entry level for longs (default 30)" }, "upper": { "type": "number", "description": "RSI entry level for shorts / exit (default 70)" }, "direction": { "type": "string", "enum": [ "long_only", "long_short" ], "description": "default long_only" }, "fee_bps": { "type": "number", "description": "Fee per side in basis points (default 5)" }, "bars": { "type": "integer", "description": "Candles to test, 100-2000 (default 500)" } }, "required": [ "symbol", "strategy" ] } } } }, "responses": { "200": { "description": "Total / annualized return, vs buy-and-hold, max drawdown, Sharpe, trades, win rate, profit factor, exposure, last 20 trades, equity curve, current position. (payment settled)", "content": { "application/json": { "example": { "symbol": "SOL", "timeframe": "4h", "source": "hyperliquid", "market": "SOL", "candles_used": 500, "strategy": { "name": "ema_cross", "params": { "fast": 20, "slow": 50 }, "direction": "long_only" }, "result": { "period": { "from": "2026-08-08T16:00:00.000Z", "to": "2026-10-22T16:00:00.000Z", "bars": 450 }, "total_return_pct": 42.693, "buy_and_hold_return_pct": 36.933, "excess_vs_buy_and_hold_pct": 5.759, "annualized_return_pct": 464.18, "max_drawdown_pct": -10.327, "sharpe_annual": 3.869, "trades": 2, "win_rate_pct": 100, "profit_factor": null, "avg_trade_pct": 19.972, "exposure_pct": 69.78, "fees_bps_per_side": 5, "last_trades": [ { "side": "long", "entry_time": "2026-08-08T16:00:00.000Z", "entry": 76.373, "exit_time": "2026-09-10T16:00:00.000Z", "exit": 99.676, "return_pct": 30.447 }, { "side": "long", "entry_time": "2026-09-18T12:00:00.000Z", "entry": 105.74, "exit_time": "2026-10-07T20:00:00.000Z", "exit": 115.84, "return_pct": 9.497 } ], "equity_curve": [ [ "2026-08-08T16:00:00.000Z", 0.99632 ], [ "2026-08-23T16:00:00.000Z", 1.24486 ], [ "2026-09-07T16:00:00.000Z", 1.36524 ], [ "2026-09-22T16:00:00.000Z", 1.45808 ], [ "2026-10-07T16:00:00.000Z", 1.42764 ], [ "2026-10-22T12:00:00.000Z", 1.42693 ] ], "current_position": "flat", "assumptions": "Signals on candle close, fills at the next candle open, fees per side as set; no slippage, funding, borrow or liquidity limits; position size 100% of equity, no leverage." }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-22T19:00:54.904Z", "tier": "backtest", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Technical indicators, risk metrics and backtests describe historical prices only; they are not predictions or trade recommendations. TASignal never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/tasignal/v1/preview": { "get": { "operationId": "tasignal_preview", "summary": "Free: technical bias label, trend and regime, confidence (no indicator values), 10/min per IP", "security": [], "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Base asset ticker, e.g. BTC, ETH, SOL, HYPE (BTC-PERP, ETH-USD and SOLUSDT are accepted too)" }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "15m", "1h", "4h", "1d" ] }, "description": "Candle timeframe: 15m, 1h, 4h or 1d (default 1h; risk default 4h)" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "Data sources unavailable" } }, "tags": [ "TASignal" ] } }, "/leakguard/v1/lite": { "get": { "operationId": "leak_scan_lite", "summary": "Find and redact secrets, wallet keys and PII in text (<= 32 KB): verdict, findings with masked previews and remediation, redacted text ($0.005)", "tags": [ "LeakGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "text", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 8192 }, "description": "Text to check (prefer POST for anything sensitive or long)" }, { "name": "style", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "label", "mask" ] }, "description": "label: [REDACTED:type] (default); mask: keep last 4 digits / email domain for PII" }, { "name": "types", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma-separated finding types or categories (wallet_key, secret, pii, email, ...)" }, { "name": "min_severity", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] } } ], "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string", "enum": [ "WALLET_KEY_EXPOSED", "SECRETS_FOUND", "PII_FOUND", "CLEAN" ] }, "safe_to_send": { "type": "boolean" }, "max_severity": { "type": "string" }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "counts": { "type": "object" }, "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "category": { "type": "string", "enum": [ "wallet_key", "secret", "pii" ] }, "severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] }, "confidence": { "type": "number" }, "validator": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "preview": { "type": "string", "description": "masked; never the secret" }, "path": { "type": "string", "description": "JSON path (scan, json input)" }, "remediation": { "type": "string" } } } }, "redacted": { "type": "string" }, "redacted_json": { "description": "scan with json input: same shape, secrets replaced" }, "exposure": { "type": "object", "description": "scan: status funds_at_risk | unknown | used_empty | no_funds_found | not_checked | not_applicable; addresses[] with balances per chain" }, "actions": { "type": "array", "items": { "type": "string" } }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Input larger than the tier limit (never charged)" }, "503": { "description": "checks_incomplete (never charged)" } } }, "post": { "operationId": "leak_scan_lite_post", "summary": "Same as GET; POST {\"text\": \"...\"} or a text/plain body", "tags": [ "LeakGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "style": { "type": "string", "enum": [ "label", "mask" ] }, "types": { "type": "array", "items": { "type": "string" } }, "min_severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] } }, "required": [ "text" ] } }, "text/plain": { "schema": { "type": "string" } } } }, "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string", "enum": [ "WALLET_KEY_EXPOSED", "SECRETS_FOUND", "PII_FOUND", "CLEAN" ] }, "safe_to_send": { "type": "boolean" }, "max_severity": { "type": "string" }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "counts": { "type": "object" }, "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "category": { "type": "string", "enum": [ "wallet_key", "secret", "pii" ] }, "severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] }, "confidence": { "type": "number" }, "validator": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "preview": { "type": "string", "description": "masked; never the secret" }, "path": { "type": "string", "description": "JSON path (scan, json input)" }, "remediation": { "type": "string" } } } }, "redacted": { "type": "string" }, "redacted_json": { "description": "scan with json input: same shape, secrets replaced" }, "exposure": { "type": "object", "description": "scan: status funds_at_risk | unknown | used_empty | no_funds_found | not_checked | not_applicable; addresses[] with balances per chain" }, "actions": { "type": "array", "items": { "type": "string" } }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Input larger than the tier limit (never charged)" }, "503": { "description": "checks_incomplete (never charged)" } } } }, "/leakguard/v1/scan": { "get": { "operationId": "leak_scan_deep", "summary": "Deep scan of text or JSON (<= 256 KB): findings by JSON path, redacted JSON, leaked-wallet exposure (derived addresses + native/USDC balances on Base, Ethereum, Polygon, Arbitrum One, Solana), ordered actions ($0.02)", "tags": [ "LeakGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "text", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 8192 }, "description": "Text to check (prefer POST for anything sensitive or long)" }, { "name": "style", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "label", "mask" ] }, "description": "label: [REDACTED:type] (default); mask: keep last 4 digits / email domain for PII" }, { "name": "types", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Comma-separated finding types or categories (wallet_key, secret, pii, email, ...)" }, { "name": "min_severity", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] } } ], "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string", "enum": [ "WALLET_KEY_EXPOSED", "SECRETS_FOUND", "PII_FOUND", "CLEAN" ] }, "safe_to_send": { "type": "boolean" }, "max_severity": { "type": "string" }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "counts": { "type": "object" }, "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "category": { "type": "string", "enum": [ "wallet_key", "secret", "pii" ] }, "severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] }, "confidence": { "type": "number" }, "validator": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "preview": { "type": "string", "description": "masked; never the secret" }, "path": { "type": "string", "description": "JSON path (scan, json input)" }, "remediation": { "type": "string" } } } }, "redacted": { "type": "string" }, "redacted_json": { "description": "scan with json input: same shape, secrets replaced" }, "exposure": { "type": "object", "description": "scan: status funds_at_risk | unknown | used_empty | no_funds_found | not_checked | not_applicable; addresses[] with balances per chain" }, "actions": { "type": "array", "items": { "type": "string" } }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Input larger than the tier limit (never charged)" }, "503": { "description": "checks_incomplete (never charged)" } } }, "post": { "operationId": "leak_scan_deep_post", "summary": "Same as GET; POST {\"text\": \"...\"} or {\"json\": {...}} or a text/plain body", "tags": [ "LeakGuard", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "json": { "description": "Any JSON payload (object, array or value); scanned string by string, keys included" }, "style": { "type": "string", "enum": [ "label", "mask" ] }, "types": { "type": "array", "items": { "type": "string" } }, "min_severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] } }, "oneOf": [ { "required": [ "text" ] }, { "required": [ "json" ] } ] } }, "text/plain": { "schema": { "type": "string" } } } }, "responses": { "200": { "description": "Scan result (payment settled)", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string", "enum": [ "WALLET_KEY_EXPOSED", "SECRETS_FOUND", "PII_FOUND", "CLEAN" ] }, "safe_to_send": { "type": "boolean" }, "max_severity": { "type": "string" }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "counts": { "type": "object" }, "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "category": { "type": "string", "enum": [ "wallet_key", "secret", "pii" ] }, "severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] }, "confidence": { "type": "number" }, "validator": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" }, "preview": { "type": "string", "description": "masked; never the secret" }, "path": { "type": "string", "description": "JSON path (scan, json input)" }, "remediation": { "type": "string" } } } }, "redacted": { "type": "string" }, "redacted_json": { "description": "scan with json input: same shape, secrets replaced" }, "exposure": { "type": "object", "description": "scan: status funds_at_risk | unknown | used_empty | no_funds_found | not_checked | not_applicable; addresses[] with balances per chain" }, "actions": { "type": "array", "items": { "type": "string" } }, "sources_failed": { "type": "array", "items": { "type": "string" } }, "engine": { "type": "string" }, "checked_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "413": { "description": "Input larger than the tier limit (never charged)" }, "503": { "description": "checks_incomplete (never charged)" } } } }, "/leakguard/v1/preview": { "get": { "operationId": "leak_scan_preview", "summary": "Free: verdict, safe_to_send, max severity and counts by type (no positions or redacted text), text <= 8 KB, 10/min per IP", "security": [], "parameters": [ { "name": "text", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 8192 }, "description": "Text to check (prefer POST for anything sensitive or long)" } ], "responses": { "200": { "description": "verdict, safe_to_send, max_severity, counts" }, "400": { "description": "Invalid input" }, "413": { "description": "Text over 8 KB" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "LeakGuard" ] }, "post": { "operationId": "leak_scan_preview_post", "summary": "Free preview, POST {\"text\": \"...\"} or text/plain", "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "style": { "type": "string", "enum": [ "label", "mask" ] }, "types": { "type": "array", "items": { "type": "string" } }, "min_severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ] } }, "required": [ "text" ] } }, "text/plain": { "schema": { "type": "string" } } } }, "responses": { "200": { "description": "verdict, safe_to_send, max_severity, counts" }, "400": { "description": "Invalid input" }, "413": { "description": "Text over 8 KB" }, "429": { "description": "Free tier rate limit" } }, "tags": [ "LeakGuard" ] } }, "/smartperps/v1/lite": { "get": { "operationId": "smart_money_lite", "summary": "Smart-money bias for one Hyperliquid coin: cohort traders long vs short, long/short/net notional, bias label, 1h and 24h net flow ($0.003)", "description": "Smart-money positioning for one Hyperliquid perp: how a rules-based cohort of the 120 Hyperliquid accounts with the highest 30-day PnL (public leaderboard) is positioned right now: traders long vs short, long/short/net notional in USD, bias (strong long / lean long / mixed / lean short / strong short), 1h and 24h net notional flow, snapshot age, cohort coverage. Fail-closed: stale or low-coverage snapshots are refused (503, not charged). Not financial advice.", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)" } ], "responses": { "200": { "description": "Cohort traders long/short, long/short/net notional, long share by notional and by traders, bias label, 1h/24h net flow, mark price, snapshot age, coverage, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "symbol": "BTC", "bias": "strong_short", "bias_note": "Most of the cohort's notional and most cohort traders in this coin are short.", "traders_long": 8, "traders_short": 37, "long_notional_usd": 23033122, "short_notional_usd": 843673444, "net_notional_usd": -820640322, "long_share_notional_pct": 2.7, "long_share_traders_pct": 17.8, "mark_price": 81380, "flow_1h_net_usd": null, "flow_24h_net_usd": null, "snapshot_at": "2026-10-23T01:08:26.080Z", "snapshot_age_s": 4, "cohort": { "size": 120, "covered": 120, "coverage_pct": 100, "cohort_refreshed_at": "2026-10-23T01:08:26.080Z" }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T01:08:30.196Z", "tier": "lite", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "smart_money_lite_post", "summary": "Same as GET, POST {\"symbol\":\"BTC\"}", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)" } }, "required": [ "symbol" ] } } } }, "responses": { "200": { "description": "Cohort traders long/short, long/short/net notional, long share by notional and by traders, bias label, 1h/24h net flow, mark price, snapshot age, coverage, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "symbol": "BTC", "bias": "strong_short", "bias_note": "Most of the cohort's notional and most cohort traders in this coin are short.", "traders_long": 8, "traders_short": 37, "long_notional_usd": 23033122, "short_notional_usd": 843673444, "net_notional_usd": -820640322, "long_share_notional_pct": 2.7, "long_share_traders_pct": 17.8, "mark_price": 81380, "flow_1h_net_usd": null, "flow_24h_net_usd": null, "snapshot_at": "2026-10-23T01:08:26.080Z", "snapshot_age_s": 4, "cohort": { "size": 120, "covered": 120, "coverage_pct": 100, "cohort_refreshed_at": "2026-10-23T01:08:26.080Z" }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T01:08:30.196Z", "tier": "lite", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/smartperps/v1/coin": { "get": { "operationId": "smart_money_coin", "summary": "Full smart-money read for one coin: bias, 1h/4h/24h flows, average entry vs mark, leverage, unrealized PnL, liquidation price bands, top 10 cohort positions (addresses truncated) ($0.02)", "description": "Full smart-money positioning for one Hyperliquid perp from the top-120 30-day-PnL cohort: lite plus 1h/4h/24h flows, average entry per side vs mark, average leverage, uPnL per side, concentration, liquidation price bands by distance from mark (count and notional per band, never per account) and the 10 largest cohort positions (truncated addresses, no liquidation price). Public on-chain data only. Fail-closed. Not financial advice. Past performance does not guarantee future results.", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)" } ], "responses": { "200": { "description": "Lite fields plus flows 1h/4h/24h, avg entry long/short and distance to mark, avg leverage, uPnL per side, concentration, liquidation price bands per side (count + notional), top 10 positions with truncated address and trader rank. (payment settled)", "content": { "application/json": { "example": { "symbol": "ETH", "bias": "strong_short", "bias_note": "Most of the cohort's notional and most cohort traders in this coin are short.", "traders_long": 10, "traders_short": 40, "long_notional_usd": 62204218, "short_notional_usd": 817401626, "net_notional_usd": -755197408, "long_share_notional_pct": 7.1, "long_share_traders_pct": 20, "mark_price": 2389, "avg_entry_long": 2454.489627, "avg_entry_short": 2381.656074, "entry_vs_mark_long_pct": -2.67, "entry_vs_mark_short_pct": -0.31, "avg_leverage": 12.84, "unrealized_pnl_long_usd": -1704791, "unrealized_pnl_short_usd": -2516812, "largest_position_share_pct": 28.9, "concentration_note": null, "flows": { "1h": null, "4h": null, "24h": null }, "liquidation_clusters": { "longs": [ { "within_pct": "0-2", "price_from": 2341, "price_to": 2389, "notional_usd": 0, "positions": 0 }, { "within_pct": "2-5", "price_from": 2270, "price_to": 2341, "notional_usd": 0, "positions": 0 }, { "within_pct": "5-10", "price_from": 2150, "price_to": 2270, "notional_usd": 0, "positions": 0 } ], "shorts": [ { "within_pct": "0-2", "price_from": 2389, "price_to": 2437, "notional_usd": 0, "positions": 0 }, { "within_pct": "2-5", "price_from": 2437, "price_to": 2508, "notional_usd": 0, "positions": 0 }, { "within_pct": "5-10", "price_from": 2508, "price_to": 2628, "notional_usd": null, "positions": 2, "notional_withheld": "fewer than 3 positions" } ], "no_liquidation_price_usd": 4577002, "bands_note": "Bands by distance of the liquidation price from mark (longs below, shorts above). Notional is withheld for bands with fewer than 3 positions so no band maps to one account." }, "top_positions": [ { "address": "0x5b5d…c060", "side": "short", "size": 106464.1028, "notional_usd": 254342742, "entry_price": 2322.73, "leverage": 5, "margin": "cross", "unrealized_pnl_usd": -7054831, "cohort_rank_30d_pnl": 1, "trader_30d_pnl_usd": 114316598 }, { "address": "0xb83d…6e36", "side": "short", "size": 66302.7619, "notional_usd": 158397298, "entry_price": 2375.32, "leverage": 5, "margin": "cross", "unrealized_pnl_usd": -906592, "cohort_rank_30d_pnl": 2, "trader_30d_pnl_usd": 102801123 } ], "snapshot_at": "2026-10-23T01:08:26.080Z", "snapshot_age_s": 4, "cohort": { "size": 120, "covered": 120, "coverage_pct": 100, "cohort_refreshed_at": "2026-10-23T01:08:26.080Z" }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T01:08:30.196Z", "tier": "coin", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "smart_money_coin_post", "summary": "Same as GET, POST {\"symbol\":\"ETH\"}", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)" } }, "required": [ "symbol" ] } } } }, "responses": { "200": { "description": "Lite fields plus flows 1h/4h/24h, avg entry long/short and distance to mark, avg leverage, uPnL per side, concentration, liquidation price bands per side (count + notional), top 10 positions with truncated address and trader rank. (payment settled)", "content": { "application/json": { "example": { "symbol": "ETH", "bias": "strong_short", "bias_note": "Most of the cohort's notional and most cohort traders in this coin are short.", "traders_long": 10, "traders_short": 40, "long_notional_usd": 62204218, "short_notional_usd": 817401626, "net_notional_usd": -755197408, "long_share_notional_pct": 7.1, "long_share_traders_pct": 20, "mark_price": 2389, "avg_entry_long": 2454.489627, "avg_entry_short": 2381.656074, "entry_vs_mark_long_pct": -2.67, "entry_vs_mark_short_pct": -0.31, "avg_leverage": 12.84, "unrealized_pnl_long_usd": -1704791, "unrealized_pnl_short_usd": -2516812, "largest_position_share_pct": 28.9, "concentration_note": null, "flows": { "1h": null, "4h": null, "24h": null }, "liquidation_clusters": { "longs": [ { "within_pct": "0-2", "price_from": 2341, "price_to": 2389, "notional_usd": 0, "positions": 0 }, { "within_pct": "2-5", "price_from": 2270, "price_to": 2341, "notional_usd": 0, "positions": 0 }, { "within_pct": "5-10", "price_from": 2150, "price_to": 2270, "notional_usd": 0, "positions": 0 } ], "shorts": [ { "within_pct": "0-2", "price_from": 2389, "price_to": 2437, "notional_usd": 0, "positions": 0 }, { "within_pct": "2-5", "price_from": 2437, "price_to": 2508, "notional_usd": 0, "positions": 0 }, { "within_pct": "5-10", "price_from": 2508, "price_to": 2628, "notional_usd": null, "positions": 2, "notional_withheld": "fewer than 3 positions" } ], "no_liquidation_price_usd": 4577002, "bands_note": "Bands by distance of the liquidation price from mark (longs below, shorts above). Notional is withheld for bands with fewer than 3 positions so no band maps to one account." }, "top_positions": [ { "address": "0x5b5d…c060", "side": "short", "size": 106464.1028, "notional_usd": 254342742, "entry_price": 2322.73, "leverage": 5, "margin": "cross", "unrealized_pnl_usd": -7054831, "cohort_rank_30d_pnl": 1, "trader_30d_pnl_usd": 114316598 }, { "address": "0xb83d…6e36", "side": "short", "size": 66302.7619, "notional_usd": 158397298, "entry_price": 2375.32, "leverage": 5, "margin": "cross", "unrealized_pnl_usd": -906592, "cohort_rank_30d_pnl": 2, "trader_30d_pnl_usd": 102801123 } ], "snapshot_at": "2026-10-23T01:08:26.080Z", "snapshot_age_s": 4, "cohort": { "size": 120, "covered": 120, "coverage_pct": 100, "cohort_refreshed_at": "2026-10-23T01:08:26.080Z" }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T01:08:30.196Z", "tier": "coin", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/smartperps/v1/scan": { "get": { "operationId": "smart_money_scan", "summary": "Market-wide smart-money scan: coins the cohort is most net long, most net short and most one-sided on, biggest 24h buying and selling, cohort gross book ($0.03)", "description": "Market-wide smart-money scan over every Hyperliquid perp held by the top-120 30-day-PnL cohort: the cohort gross long/short book and net exposure, and ranked lists of the coins it is most net long, most net short and most one-sided on (by trader count), plus the biggest 24h net buying and selling by notional, each with bias, trader counts, net notional and flows. limit 1-25 rows per list, min_traders 2-50 (default 3). Fail-closed. Not financial advice.", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "30000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Rows per list, 1-25 (default 10)" }, { "name": "min_traders", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Only rank coins held by at least this many cohort accounts, 2-50 (default 3)" } ], "responses": { "200": { "description": "Cohort book (gross long/short, net, long share, accounts with positions, equity) and lists most_net_long, most_net_short, most_one_sided, biggest_24h_buying, biggest_24h_selling. (payment settled)", "content": { "application/json": { "example": { "mode": "cohort", "coins_held": 178, "coins_ranked": 146, "min_traders": 3, "cohort_book": { "gross_long_usd": 206948229, "gross_short_usd": 2898762302, "net_usd": -2691814073, "long_share_pct": 6.7, "accounts_with_positions": 83, "equity_usd": 702970565 }, "most_net_long": [ { "symbol": "AAVE", "bias": "mixed", "traders_long": 5, "traders_short": 13, "net_notional_usd": 1003728, "long_share_notional_pct": 52.5, "flow_1h_net_usd": null, "flow_24h_net_usd": null }, { "symbol": "ATOM", "bias": "strong_long", "traders_long": 5, "traders_short": 1, "net_notional_usd": 972941, "long_share_notional_pct": 96, "flow_1h_net_usd": null, "flow_24h_net_usd": null } ], "most_net_short": [ { "symbol": "BTC", "bias": "strong_short", "traders_long": 8, "traders_short": 37, "net_notional_usd": -820640322, "long_share_notional_pct": 2.7, "flow_1h_net_usd": null, "flow_24h_net_usd": null }, { "symbol": "ETH", "bias": "strong_short", "traders_long": 10, "traders_short": 40, "net_notional_usd": -755197408, "long_share_notional_pct": 7.1, "flow_1h_net_usd": null, "flow_24h_net_usd": null } ], "most_one_sided": [ { "symbol": "XPL", "bias": "strong_short", "traders_long": 0, "traders_short": 20, "net_notional_usd": -14667723, "long_share_notional_pct": 0, "flow_1h_net_usd": null, "flow_24h_net_usd": null }, { "symbol": "AERO", "bias": "strong_short", "traders_long": 0, "traders_short": 12, "net_notional_usd": -2620964, "long_share_notional_pct": 0, "flow_1h_net_usd": null, "flow_24h_net_usd": null } ], "biggest_24h_buying": [], "biggest_24h_selling": [], "flows_note": "Flow history builds up over the first 24 hours after launch; flow lists are empty until a 24h-old snapshot exists.", "snapshot_at": "2026-10-23T01:08:26.080Z", "snapshot_age_s": 4, "cohort": { "size": 120, "covered": 120, "coverage_pct": 100, "cohort_refreshed_at": "2026-10-23T01:08:26.080Z" }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T01:08:30.196Z", "tier": "scan", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "smart_money_scan_post", "summary": "Same as GET, POST {\"limit\":10}", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.03" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "30000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Rows per list, 1-25 (default 10)" }, "min_traders": { "type": "integer", "description": "Only rank coins held by at least this many cohort accounts, 2-50 (default 3)" } } } } } }, "responses": { "200": { "description": "Cohort book (gross long/short, net, long share, accounts with positions, equity) and lists most_net_long, most_net_short, most_one_sided, biggest_24h_buying, biggest_24h_selling. (payment settled)", "content": { "application/json": { "example": { "mode": "cohort", "coins_held": 178, "coins_ranked": 146, "min_traders": 3, "cohort_book": { "gross_long_usd": 206948229, "gross_short_usd": 2898762302, "net_usd": -2691814073, "long_share_pct": 6.7, "accounts_with_positions": 83, "equity_usd": 702970565 }, "most_net_long": [ { "symbol": "AAVE", "bias": "mixed", "traders_long": 5, "traders_short": 13, "net_notional_usd": 1003728, "long_share_notional_pct": 52.5, "flow_1h_net_usd": null, "flow_24h_net_usd": null }, { "symbol": "ATOM", "bias": "strong_long", "traders_long": 5, "traders_short": 1, "net_notional_usd": 972941, "long_share_notional_pct": 96, "flow_1h_net_usd": null, "flow_24h_net_usd": null } ], "most_net_short": [ { "symbol": "BTC", "bias": "strong_short", "traders_long": 8, "traders_short": 37, "net_notional_usd": -820640322, "long_share_notional_pct": 2.7, "flow_1h_net_usd": null, "flow_24h_net_usd": null }, { "symbol": "ETH", "bias": "strong_short", "traders_long": 10, "traders_short": 40, "net_notional_usd": -755197408, "long_share_notional_pct": 7.1, "flow_1h_net_usd": null, "flow_24h_net_usd": null } ], "most_one_sided": [ { "symbol": "XPL", "bias": "strong_short", "traders_long": 0, "traders_short": 20, "net_notional_usd": -14667723, "long_share_notional_pct": 0, "flow_1h_net_usd": null, "flow_24h_net_usd": null }, { "symbol": "AERO", "bias": "strong_short", "traders_long": 0, "traders_short": 12, "net_notional_usd": -2620964, "long_share_notional_pct": 0, "flow_1h_net_usd": null, "flow_24h_net_usd": null } ], "biggest_24h_buying": [], "biggest_24h_selling": [], "flows_note": "Flow history builds up over the first 24 hours after launch; flow lists are empty until a 24h-old snapshot exists.", "snapshot_at": "2026-10-23T01:08:26.080Z", "snapshot_age_s": 4, "cohort": { "size": 120, "covered": 120, "coverage_pct": 100, "cohort_refreshed_at": "2026-10-23T01:08:26.080Z" }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T01:08:30.196Z", "tier": "scan", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/smartperps/v1/wallet": { "get": { "operationId": "hyperliquid_wallet_profile", "summary": "Live profile of a Hyperliquid account you supply: equity, leverage, margin usage, open positions with distance to liquidation (whole %), 30-day fills (volume, realized PnL, fees, win rate), cohort rank. Public on-chain data only ($0.01)", "description": "Live profile of the Hyperliquid account (0x address) you supply: account value, notional, effective leverage, margin usage, long/short/net book, up to 25 open positions (size, entry, leverage, distance to liquidation in whole percent, uPnL; no liquidation prices), 30-day fills summary and top-120 cohort rank. Public on-chain data only; must not be used to target or harass account holders. Fail-closed. Not financial advice. Past performance does not guarantee future results.", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "10000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Hyperliquid account address (0x + 40 hex)" } ], "responses": { "200": { "description": "Equity, notional, leverage, margin usage, book, open positions with distance to liquidation (whole %), 30-day fills summary, cohort membership and rank, data_note, confidence, sources_failed. Public on-chain data only; not for targeting or harassing account holders. (payment settled)", "content": { "application/json": { "example": { "address": "0x0000000000000000000000000000000000000001", "account_value_usd": 151226719, "total_notional_usd": 700946583, "margin_used_usd": 148682072, "margin_usage_pct": 98.3, "effective_leverage": 4.64, "open_positions": 19, "book": { "long_notional_usd": 0, "short_notional_usd": 700946583, "net_usd": -700946583 }, "positions": [ { "symbol": "ETH", "side": "short", "size": 106464.1028, "notional_usd": 254365099, "entry_price": 2322.73, "leverage": 5, "margin": "cross", "liquidation_distance_pct": 74, "unrealized_pnl_usd": -7077189 }, { "symbol": "BTC", "side": "short", "size": 2637.9539, "notional_usd": 214683283, "entry_price": 76327.4, "leverage": 5, "margin": "cross", "liquidation_distance_pct": 88, "unrealized_pnl_usd": -13335028 } ], "last_30d": { "window_days": 30, "fills": 2000, "truncated": true, "volume_usd": 763893, "realized_pnl_usd": -7535, "fees_usd": 73, "closing_fills": 64, "winning_closes_pct": 76.6, "most_traded": [ { "symbol": "xyz:META", "volume_usd": 453357 }, { "symbol": "HYPE", "volume_usd": 165242 } ] }, "in_smart_money_cohort": true, "cohort_entry": { "rank_30d_pnl": 1, "pnl_30d_usd": 114316598, "pnl_all_time_usd": 179019894, "roi_30d": 0.6858, "display_name": null }, "confidence": "high", "sources_failed": [], "data_note": "Public on-chain Hyperliquid data only. Liquidation is shown as distance from mark in whole percent, not as a price. Do not use this data to target, front-run liquidations of, or harass account holders.", "checked_at": "2026-10-23T01:08:30.196Z", "tier": "wallet", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } }, "post": { "operationId": "hyperliquid_wallet_profile_post", "summary": "Same as GET, POST {\"address\":\"0x0000000000000000000000000000000000000001\"}", "tags": [ "SmartPerps", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "10000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string", "description": "Hyperliquid account address (0x + 40 hex)" } }, "required": [ "address" ] } } } }, "responses": { "200": { "description": "Equity, notional, leverage, margin usage, book, open positions with distance to liquidation (whole %), 30-day fills summary, cohort membership and rank, data_note, confidence, sources_failed. Public on-chain data only; not for targeting or harassing account holders. (payment settled)", "content": { "application/json": { "example": { "address": "0x0000000000000000000000000000000000000001", "account_value_usd": 151226719, "total_notional_usd": 700946583, "margin_used_usd": 148682072, "margin_usage_pct": 98.3, "effective_leverage": 4.64, "open_positions": 19, "book": { "long_notional_usd": 0, "short_notional_usd": 700946583, "net_usd": -700946583 }, "positions": [ { "symbol": "ETH", "side": "short", "size": 106464.1028, "notional_usd": 254365099, "entry_price": 2322.73, "leverage": 5, "margin": "cross", "liquidation_distance_pct": 74, "unrealized_pnl_usd": -7077189 }, { "symbol": "BTC", "side": "short", "size": 2637.9539, "notional_usd": 214683283, "entry_price": 76327.4, "leverage": 5, "margin": "cross", "liquidation_distance_pct": 88, "unrealized_pnl_usd": -13335028 } ], "last_30d": { "window_days": 30, "fills": 2000, "truncated": true, "volume_usd": 763893, "realized_pnl_usd": -7535, "fees_usd": 73, "closing_fills": 64, "winning_closes_pct": 76.6, "most_traded": [ { "symbol": "xyz:META", "volume_usd": 453357 }, { "symbol": "HYPE", "volume_usd": 165242 } ] }, "in_smart_money_cohort": true, "cohort_entry": { "rank_30d_pnl": 1, "pnl_30d_usd": 114316598, "pnl_all_time_usd": 179019894, "roi_30d": 0.6858, "display_name": null }, "confidence": "high", "sources_failed": [], "data_note": "Public on-chain Hyperliquid data only. Liquidation is shown as distance from mark in whole percent, not as a price. Do not use this data to target, front-run liquidations of, or harass account holders.", "checked_at": "2026-10-23T01:08:30.196Z", "tier": "wallet", "disclaimer": "Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "Symbol not listed (never charged)" }, "503": { "description": "Data sources unavailable: upstream_unavailable with sources_failed (never charged)" } } } }, "/smartperps/v1/preview": { "get": { "operationId": "smartperps_preview", "summary": "Free: bias label, cohort traders long/short, snapshot age, coverage, confidence (no notional, flows or positions), 10/min per IP", "security": [], "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "Data sources unavailable" } }, "tags": [ "SmartPerps" ] } }, "/toolpick/v1/lite": { "get": { "operationId": "find_paid_api_lite", "summary": "Top 5 paid x402 APIs for a task, ranked by relevance, 30-day payers/calls, recency and price (from the index, no live check) ($0.003)", "description": "Find the paid x402 API for a task: top 5 resources from the merged public x402 discovery indexes, ranked by relevance to your need, index-reported 30-day payers and calls, recency and price. Each result: service, resource URL, method, description, USDC price, networks, 30-day calls and payers, repeat_buyers, last called time. Filters: max_price, network, min_payers. No live check (use /v1/pick). No matches: 404, never charged.", "tags": [ "ToolPick", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "need", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars)" }, { "name": "max_price", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Only resources priced at or below this many USD per call, e.g. 0.01" }, { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ] }, "description": "Only resources payable on this network (default any)" }, { "name": "min_payers", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Only resources with at least this many unique payers in the last 30 days (default 0)" } ], "responses": { "200": { "description": "Top 5 resources (service, URL, method, price, networks, 30-day calls/payers, repeat_buyers, last called), match and host counts, index age, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "need": "solana token safety", "filters": { "max_price": null, "network": "any", "min_payers": 0 }, "terms": [ "solana", "token", "safety" ], "index": { "refreshed_at": "2026-10-23T12:59:10.247Z", "age_s": 600, "stale": false }, "matches": 610, "hosts": 151, "results": [ { "rank": 1, "service": "Solana token risk check", "host": "agent402.tools", "resource": "https://agent402.tools/api/sol-token-safety", "method": "POST", "description": "Safety verdict for one Solana token mint: a graded risk score with the concrete reasons be", "price_usd": 0.005, "networks": [ "base", "polygon", "arbitrum", "avalanche", "optimism", "solana" ], "calls_30d": 230, "payers_30d": 6, "repeat_buyers": true, "last_called_at": "2026-10-23T09:12:46.000Z", "indexed_on": [ "cdp" ], "relevance": 1, "score": 3.298 }, { "rank": 2, "service": "Token Safety Check", "host": "chain.tollkit.dev", "resource": "https://chain.tollkit.dev/chain/check", "method": "POST", "description": "Token safety check (rug check) for AI agents before buying, sending or accepting a crypto ", "price_usd": 0.004, "networks": [ "base", "solana" ], "calls_30d": 9, "payers_30d": 6, "repeat_buyers": true, "last_called_at": "2026-10-15T07:15:50.000Z", "indexed_on": [ "cdp" ], "relevance": 0.9, "score": 1.986 } ], "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T13:09:10.247Z", "tier": "lite", "disclaimer": "Rankings use public x402 index metadata and the index-reported 30-day call and payer counts; listings are self-described by sellers and are not endorsements. A live check only shows that an endpoint answers with x402 payment terms right now, not that its data is good or that the seller is safe. Check terms before paying. ToolPick never pays, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "No x402 resources match the need and filters (never charged)" }, "503": { "description": "Index missing, older than 72 hours or store unavailable, with sources_failed (never charged)" } } }, "post": { "operationId": "find_paid_api_lite_post", "summary": "Same as GET, POST {\"need\":\"solana token safety\"}", "tags": [ "ToolPick", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "3000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "need": { "type": "string", "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars)" }, "max_price": { "type": "number", "description": "Only resources priced at or below this many USD per call, e.g. 0.01" }, "network": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ], "description": "Only resources payable on this network (default any)" }, "min_payers": { "type": "integer", "description": "Only resources with at least this many unique payers in the last 30 days (default 0)" } }, "required": [ "need" ] } } } }, "responses": { "200": { "description": "Top 5 resources (service, URL, method, price, networks, 30-day calls/payers, repeat_buyers, last called), match and host counts, index age, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "need": "solana token safety", "filters": { "max_price": null, "network": "any", "min_payers": 0 }, "terms": [ "solana", "token", "safety" ], "index": { "refreshed_at": "2026-10-23T12:59:10.247Z", "age_s": 600, "stale": false }, "matches": 610, "hosts": 151, "results": [ { "rank": 1, "service": "Solana token risk check", "host": "agent402.tools", "resource": "https://agent402.tools/api/sol-token-safety", "method": "POST", "description": "Safety verdict for one Solana token mint: a graded risk score with the concrete reasons be", "price_usd": 0.005, "networks": [ "base", "polygon", "arbitrum", "avalanche", "optimism", "solana" ], "calls_30d": 230, "payers_30d": 6, "repeat_buyers": true, "last_called_at": "2026-10-23T09:12:46.000Z", "indexed_on": [ "cdp" ], "relevance": 1, "score": 3.298 }, { "rank": 2, "service": "Token Safety Check", "host": "chain.tollkit.dev", "resource": "https://chain.tollkit.dev/chain/check", "method": "POST", "description": "Token safety check (rug check) for AI agents before buying, sending or accepting a crypto ", "price_usd": 0.004, "networks": [ "base", "solana" ], "calls_30d": 9, "payers_30d": 6, "repeat_buyers": true, "last_called_at": "2026-10-15T07:15:50.000Z", "indexed_on": [ "cdp" ], "relevance": 0.9, "score": 1.986 } ], "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T13:09:10.247Z", "tier": "lite", "disclaimer": "Rankings use public x402 index metadata and the index-reported 30-day call and payer counts; listings are self-described by sellers and are not endorsements. A live check only shows that an endpoint answers with x402 payment terms right now, not that its data is good or that the seller is safe. Check terms before paying. ToolPick never pays, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "No x402 resources match the need and filters (never charged)" }, "503": { "description": "Index missing, older than 72 hours or store unavailable, with sources_failed (never charged)" } } } }, "/toolpick/v1/pick": { "get": { "operationId": "pick_paid_api", "summary": "Top 10 paid x402 APIs for a task with live 402 checks of the top 5, a best verified pick, cheaper alternatives and the category price range ($0.01)", "description": "Pick the paid x402 API to call: top 10 ranked resources for your need (relevance, 30-day payers and calls, recency, price; filters), a live check of the top 5 (one unpaid request each, 3 s timeout: 402 with x402 terms, live price and networks, matches the listing?), the best verified pick, the cheapest verified alternative and category price stats. Fail-closed: a failed check is never called verified; none verified means best_pick null, low confidence.", "tags": [ "ToolPick", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "10000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "need", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars)" }, { "name": "max_price", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Only resources priced at or below this many USD per call, e.g. 0.01" }, { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ] }, "description": "Only resources payable on this network (default any)" }, { "name": "min_payers", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Only resources with at least this many unique payers in the last 30 days (default 0)" } ], "responses": { "200": { "description": "best_pick, cheapest_verified, top 10 results with live check for the top 5, category stats, index age, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "need": "web search", "filters": { "max_price": 0.02, "network": "any", "min_payers": 0 }, "terms": [ "web", "search" ], "index": { "refreshed_at": "2026-10-23T12:59:10.247Z", "age_s": 600, "stale": false }, "matches": 700, "hosts": 236, "results": [ { "rank": 1, "service": "Exa", "host": "api.exa.ai", "resource": "https://api.exa.ai/search", "method": "POST", "description": "Exa /search endpoint", "price_usd": 0.007, "networks": [ "base", "solana" ], "calls_30d": 6614, "payers_30d": 92, "repeat_buyers": true, "last_called_at": "2026-10-23T11:14:01.000Z", "indexed_on": [ "cdp" ], "relevance": 0.85, "score": 4.843, "live_check": { "status": "live", "x402_version": 2, "http_status": 402, "ms": 363, "live_price_usd": 0.007, "live_networks": [ "base", "solana" ], "price_matches_index": true }, "verified_live": true }, { "rank": 2, "service": "Pocket Network", "host": "agent.pocket.network", "resource": "https://agent.pocket.network/v1/agentsearch-web-search-v1", "method": "POST", "description": "Web search built for agents, served over Pocket Ne", "price_usd": 0.005, "networks": [ "base" ], "calls_30d": 2843, "payers_30d": 13, "repeat_buyers": true, "last_called_at": "2026-10-23T12:06:00.000Z", "indexed_on": [ "cdp" ], "relevance": 1, "score": 4.215, "live_check": { "status": "live", "x402_version": 2, "http_status": 402, "ms": 510, "live_price_usd": 0.005, "live_networks": [ "base" ], "price_matches_index": true }, "verified_live": true } ], "best_pick": { "rank": 1, "service": "Exa", "resource": "https://api.exa.ai/search", "method": "POST", "price_usd": 0.007, "networks": [ "base", "solana" ], "payers_30d": 92, "why": "highest-ranked candidate that answered 402 with matching x402 terms in the live check" }, "cheapest_verified": { "rank": 5, "service": "web-news", "resource": "https://api.agentstools.dev/search/news", "price_usd": 0.003 }, "stats": { "resources": 700, "hosts": 236, "hosts_with_3plus_payers": 125, "priced_resources": 700, "price_usd": { "min": 0.001, "p25": 0.003, "median": 0.01, "p75": 0.01, "max": 0.02 }, "price_with_buyers_usd": { "p25": 0.003, "median": 0.00625, "p75": 0.01, "payer_weighted_median": 0.01 }, "calls_30d": 64331, "est_revenue_30d_usd": 555.82 }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T13:09:10.247Z", "tier": "pick", "disclaimer": "Rankings use public x402 index metadata and the index-reported 30-day call and payer counts; listings are self-described by sellers and are not endorsements. A live check only shows that an endpoint answers with x402 payment terms right now, not that its data is good or that the seller is safe. Check terms before paying. ToolPick never pays, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "No x402 resources match the need and filters (never charged)" }, "503": { "description": "Index missing, older than 72 hours or store unavailable, with sources_failed (never charged)" } } }, "post": { "operationId": "pick_paid_api_post", "summary": "Same as GET, POST {\"need\":\"web search\",\"max_price\":0.02}", "tags": [ "ToolPick", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.01" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "10000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "need": { "type": "string", "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars)" }, "max_price": { "type": "number", "description": "Only resources priced at or below this many USD per call, e.g. 0.01" }, "network": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ], "description": "Only resources payable on this network (default any)" }, "min_payers": { "type": "integer", "description": "Only resources with at least this many unique payers in the last 30 days (default 0)" } }, "required": [ "need" ] } } } }, "responses": { "200": { "description": "best_pick, cheapest_verified, top 10 results with live check for the top 5, category stats, index age, confidence, sources_failed. (payment settled)", "content": { "application/json": { "example": { "need": "web search", "filters": { "max_price": 0.02, "network": "any", "min_payers": 0 }, "terms": [ "web", "search" ], "index": { "refreshed_at": "2026-10-23T12:59:10.247Z", "age_s": 600, "stale": false }, "matches": 700, "hosts": 236, "results": [ { "rank": 1, "service": "Exa", "host": "api.exa.ai", "resource": "https://api.exa.ai/search", "method": "POST", "description": "Exa /search endpoint", "price_usd": 0.007, "networks": [ "base", "solana" ], "calls_30d": 6614, "payers_30d": 92, "repeat_buyers": true, "last_called_at": "2026-10-23T11:14:01.000Z", "indexed_on": [ "cdp" ], "relevance": 0.85, "score": 4.843, "live_check": { "status": "live", "x402_version": 2, "http_status": 402, "ms": 363, "live_price_usd": 0.007, "live_networks": [ "base", "solana" ], "price_matches_index": true }, "verified_live": true }, { "rank": 2, "service": "Pocket Network", "host": "agent.pocket.network", "resource": "https://agent.pocket.network/v1/agentsearch-web-search-v1", "method": "POST", "description": "Web search built for agents, served over Pocket Ne", "price_usd": 0.005, "networks": [ "base" ], "calls_30d": 2843, "payers_30d": 13, "repeat_buyers": true, "last_called_at": "2026-10-23T12:06:00.000Z", "indexed_on": [ "cdp" ], "relevance": 1, "score": 4.215, "live_check": { "status": "live", "x402_version": 2, "http_status": 402, "ms": 510, "live_price_usd": 0.005, "live_networks": [ "base" ], "price_matches_index": true }, "verified_live": true } ], "best_pick": { "rank": 1, "service": "Exa", "resource": "https://api.exa.ai/search", "method": "POST", "price_usd": 0.007, "networks": [ "base", "solana" ], "payers_30d": 92, "why": "highest-ranked candidate that answered 402 with matching x402 terms in the live check" }, "cheapest_verified": { "rank": 5, "service": "web-news", "resource": "https://api.agentstools.dev/search/news", "price_usd": 0.003 }, "stats": { "resources": 700, "hosts": 236, "hosts_with_3plus_payers": 125, "priced_resources": 700, "price_usd": { "min": 0.001, "p25": 0.003, "median": 0.01, "p75": 0.01, "max": 0.02 }, "price_with_buyers_usd": { "p25": 0.003, "median": 0.00625, "p75": 0.01, "payer_weighted_median": 0.01 }, "calls_30d": 64331, "est_revenue_30d_usd": 555.82 }, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T13:09:10.247Z", "tier": "pick", "disclaimer": "Rankings use public x402 index metadata and the index-reported 30-day call and payer counts; listings are self-described by sellers and are not endorsements. A live check only shows that an endpoint answers with x402 payment terms right now, not that its data is good or that the seller is safe. Check terms before paying. ToolPick never pays, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "No x402 resources match the need and filters (never charged)" }, "503": { "description": "Index missing, older than 72 hours or store unavailable, with sources_failed (never charged)" } } } }, "/toolpick/v1/market": { "get": { "operationId": "x402_market_report", "summary": "x402 market report for a category (or the whole index): competition, price quartiles, payer-weighted price, demand, top sellers by estimated revenue ($0.02)", "description": "Market report for sellers and builders: for a category (need, e.g. token safety) or the whole x402 index, resource and seller-host counts, hosts with 3+ payers, listed price quartiles, the price where buyers are (payer-weighted median), 30-day calls, estimated 30-day revenue (calls x price, an upper bound), top sellers and the resources with most payers. Use it to price a new endpoint or test a niche for paying demand. limit 1-25 (default 10).", "tags": [ "ToolPick", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "parameters": [ { "name": "need", "in": "query", "required": false, "schema": { "type": "string" }, "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars); omit for the whole index" }, { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ] }, "description": "Only resources payable on this network (default any)" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Rows per list, 1-25 (default 10)" } ], "responses": { "200": { "description": "Category stats (resources, hosts, price quartiles, buyer price quartiles, payer-weighted median, calls, est. revenue), top sellers, top resources by payers, index age, confidence. (payment settled)", "content": { "application/json": { "example": { "need": "token safety", "filters": { "network": "any" }, "terms": [ "token", "safety" ], "index": { "refreshed_at": "2026-10-23T12:59:10.247Z", "age_s": 600, "stale": false }, "stats": { "resources": 287, "hosts": 87, "hosts_with_3plus_payers": 34, "priced_resources": 287, "price_usd": { "min": 0.001, "p25": 0.01, "median": 0.01, "p75": 0.02, "max": 1 }, "price_with_buyers_usd": { "p25": 0.005, "median": 0.01, "p75": 0.015, "payer_weighted_median": 0.01 }, "calls_30d": 2646, "est_revenue_30d_usd": 52.57, "est_revenue_note": "calls x listed price; an upper bound (includes sellers testing their own endpoints and crawler payments; resources priced $5+ excluded)" }, "top_sellers": [ { "host": "api.losbeto.xyz", "service": "Losbeto Market Intelligence", "resources": 1, "calls_30d": 69, "payers_30d_max": 1, "est_revenue_30d_usd": 13.8, "price_range_usd": [ 0.2, 0.2 ] }, { "host": "oracle.cyberwarex.com", "service": "DeFi Safety Oracle", "resources": 19, "calls_30d": 279, "payers_30d_max": 5, "est_revenue_30d_usd": 9.81, "price_range_usd": [ 0.001, 1 ] } ], "top_resources_by_payers": [ { "rank": 1, "service": "api.x402node.dev", "host": "api.x402node.dev", "resource": "https://api.x402node.dev/chain/token-tax", "method": "GET", "description": "Inspect an ERC20 token contract for buy/sell tax fields, owner renouncement and basic hone", "price_usd": 0.006, "networks": [ "base", "solana" ], "calls_30d": 99, "payers_30d": 20, "repeat_buyers": true, "last_called_at": "2026-10-23T06:30:19.000Z", "indexed_on": [ "cdp" ], "relevance": 0.44, "score": 1.727 } ], "total_sellers": 87, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T13:09:10.247Z", "tier": "market", "disclaimer": "Rankings use public x402 index metadata and the index-reported 30-day call and payer counts; listings are self-described by sellers and are not endorsements. A live check only shows that an endpoint answers with x402 payment terms right now, not that its data is good or that the seller is safe. Check terms before paying. ToolPick never pays, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "No x402 resources match the need and filters (never charged)" }, "503": { "description": "Index missing, older than 72 hours or store unavailable, with sources_failed (never charged)" } } }, "post": { "operationId": "x402_market_report_post", "summary": "Same as GET, POST {\"need\":\"token safety\"}", "tags": [ "ToolPick", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.02" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "20000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "need": { "type": "string", "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars); omit for the whole index" }, "network": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ], "description": "Only resources payable on this network (default any)" }, "limit": { "type": "integer", "description": "Rows per list, 1-25 (default 10)" } } } } } }, "responses": { "200": { "description": "Category stats (resources, hosts, price quartiles, buyer price quartiles, payer-weighted median, calls, est. revenue), top sellers, top resources by payers, index age, confidence. (payment settled)", "content": { "application/json": { "example": { "need": "token safety", "filters": { "network": "any" }, "terms": [ "token", "safety" ], "index": { "refreshed_at": "2026-10-23T12:59:10.247Z", "age_s": 600, "stale": false }, "stats": { "resources": 287, "hosts": 87, "hosts_with_3plus_payers": 34, "priced_resources": 287, "price_usd": { "min": 0.001, "p25": 0.01, "median": 0.01, "p75": 0.02, "max": 1 }, "price_with_buyers_usd": { "p25": 0.005, "median": 0.01, "p75": 0.015, "payer_weighted_median": 0.01 }, "calls_30d": 2646, "est_revenue_30d_usd": 52.57, "est_revenue_note": "calls x listed price; an upper bound (includes sellers testing their own endpoints and crawler payments; resources priced $5+ excluded)" }, "top_sellers": [ { "host": "api.losbeto.xyz", "service": "Losbeto Market Intelligence", "resources": 1, "calls_30d": 69, "payers_30d_max": 1, "est_revenue_30d_usd": 13.8, "price_range_usd": [ 0.2, 0.2 ] }, { "host": "oracle.cyberwarex.com", "service": "DeFi Safety Oracle", "resources": 19, "calls_30d": 279, "payers_30d_max": 5, "est_revenue_30d_usd": 9.81, "price_range_usd": [ 0.001, 1 ] } ], "top_resources_by_payers": [ { "rank": 1, "service": "api.x402node.dev", "host": "api.x402node.dev", "resource": "https://api.x402node.dev/chain/token-tax", "method": "GET", "description": "Inspect an ERC20 token contract for buy/sell tax fields, owner renouncement and basic hone", "price_usd": 0.006, "networks": [ "base", "solana" ], "calls_30d": 99, "payers_30d": 20, "repeat_buyers": true, "last_called_at": "2026-10-23T06:30:19.000Z", "indexed_on": [ "cdp" ], "relevance": 0.44, "score": 1.727 } ], "total_sellers": 87, "confidence": "high", "sources_failed": [], "checked_at": "2026-10-23T13:09:10.247Z", "tier": "market", "disclaimer": "Rankings use public x402 index metadata and the index-reported 30-day call and payer counts; listings are self-described by sellers and are not endorsements. A live check only shows that an endpoint answers with x402 payment terms right now, not that its data is good or that the seller is safe. Check terms before paying. ToolPick never pays, holds funds or keys." } } } }, "400": { "description": "Invalid input (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "404": { "description": "No x402 resources match the need and filters (never charged)" }, "503": { "description": "Index missing, older than 72 hours or store unavailable, with sources_failed (never charged)" } } } }, "/toolpick/v1/preview": { "get": { "operationId": "toolpick_preview", "summary": "Free: match count and the top 3 service names with price, networks and 30-day payers (no URLs, no live checks), 10/min per IP", "security": [], "parameters": [ { "name": "need", "in": "query", "required": true, "schema": { "type": "string" }, "description": "The capability you need, in plain words, e.g. \"solana token safety\", \"web search\", \"pdf to text\", \"hyperliquid funding rates\" (2-200 chars)" }, { "name": "max_price", "in": "query", "required": false, "schema": { "type": "number" }, "description": "Only resources priced at or below this many USD per call, e.g. 0.01" }, { "name": "network", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "any", "base", "solana", "polygon", "arbitrum", "optimism", "ethereum", "avalanche" ] }, "description": "Only resources payable on this network (default any)" } ], "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid input" }, "429": { "description": "Free tier rate limit" }, "503": { "description": "Data sources unavailable" } }, "tags": [ "ToolPick" ] } }, "/x402-template/download": { "get": { "operationId": "download_template", "summary": "Download the x402 Proxy Template (zip)", "description": "Download the x402 Proxy Template v1.0.0 (zip, MIT): a Cloudflare Worker that puts an x402 paywall (USDC on Base, x402 v2 + v1) in front of any HTTP API from one config file, with Bazaar discovery metadata, OpenAPI, remote + stdio MCP, OpenAPI importer, mock API, smoke test, 11 tests, quickstart and deploy guide.", "x-payment-info": { "protocols": [ "x402" ], "price": "$19", "amount": "19000000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "network": "eip155:8453", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "pricingMode": "fixed" }, "responses": { "200": { "description": "The template zip", "content": { "application/zip": { "schema": { "type": "string", "format": "binary" } } } }, "402": { "description": "Payment required (x402 v2 PAYMENT-REQUIRED header, v1 JSON body)" } }, "tags": [ "x402 Proxy Template" ] } }, "/x402-template/": { "get": { "operationId": "preview", "summary": "Free preview: README, file list, price, how to pay", "responses": { "200": { "description": "JSON (or HTML for browsers)" } }, "tags": [ "x402 Proxy Template" ] } }, "/x402-template/files": { "get": { "operationId": "files", "summary": "Free: file list with sizes, zip sha256", "responses": { "200": { "description": "JSON" } }, "tags": [ "x402 Proxy Template" ] } }, "/x402-template/readme": { "get": { "operationId": "readme", "summary": "Free: README.md", "responses": { "200": { "description": "text/markdown" } }, "tags": [ "x402 Proxy Template" ] } }, "/credits/v1/pack/sample": { "get": { "operationId": "buy_pack_sample", "summary": "Sample pack: $0.005 of credits (try the flow end to end): mints a new API key (shown once)", "tags": [ "Credits (prepaid packs)", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "pattern": "^yatc_[A-Za-z0-9_-]{43}$" }, "shown_once": { "type": "boolean" }, "pack": { "type": "string" }, "paid_usd": { "type": "string" }, "credited_usd": { "type": "string" }, "bonus_usd": { "type": "string" }, "balance_usd": { "type": "string" }, "use": { "type": "object" }, "balance": { "type": "string" }, "topup": { "type": "object" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } }, "post": { "operationId": "buy_pack_sample_post", "summary": "Sample pack: $0.005 of credits (try the flow end to end): mints a new API key (shown once)", "tags": [ "Credits (prepaid packs)", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "pattern": "^yatc_[A-Za-z0-9_-]{43}$" }, "shown_once": { "type": "boolean" }, "pack": { "type": "string" }, "paid_usd": { "type": "string" }, "credited_usd": { "type": "string" }, "bonus_usd": { "type": "string" }, "balance_usd": { "type": "string" }, "use": { "type": "object" }, "balance": { "type": "string" }, "topup": { "type": "object" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/credits/v1/pack/1": { "get": { "operationId": "buy_pack_1", "summary": "$1 pack: $1.00 of credits: mints a new API key (shown once)", "tags": [ "Credits (prepaid packs)", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "pattern": "^yatc_[A-Za-z0-9_-]{43}$" }, "shown_once": { "type": "boolean" }, "pack": { "type": "string" }, "paid_usd": { "type": "string" }, "credited_usd": { "type": "string" }, "bonus_usd": { "type": "string" }, "balance_usd": { "type": "string" }, "use": { "type": "object" }, "balance": { "type": "string" }, "topup": { "type": "object" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } }, "post": { "operationId": "buy_pack_1_post", "summary": "$1 pack: $1.00 of credits: mints a new API key (shown once)", "tags": [ "Credits (prepaid packs)", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "pattern": "^yatc_[A-Za-z0-9_-]{43}$" }, "shown_once": { "type": "boolean" }, "pack": { "type": "string" }, "paid_usd": { "type": "string" }, "credited_usd": { "type": "string" }, "bonus_usd": { "type": "string" }, "balance_usd": { "type": "string" }, "use": { "type": "object" }, "balance": { "type": "string" }, "topup": { "type": "object" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/credits/v1/pack/5": { "get": { "operationId": "buy_pack_5", "summary": "$5 pack: $5.50 of credits (10% bonus): mints a new API key (shown once)", "tags": [ "Credits (prepaid packs)", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "5.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "pattern": "^yatc_[A-Za-z0-9_-]{43}$" }, "shown_once": { "type": "boolean" }, "pack": { "type": "string" }, "paid_usd": { "type": "string" }, "credited_usd": { "type": "string" }, "bonus_usd": { "type": "string" }, "balance_usd": { "type": "string" }, "use": { "type": "object" }, "balance": { "type": "string" }, "topup": { "type": "object" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } }, "post": { "operationId": "buy_pack_5_post", "summary": "$5 pack: $5.50 of credits (10% bonus): mints a new API key (shown once)", "tags": [ "Credits (prepaid packs)", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "5.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "pattern": "^yatc_[A-Za-z0-9_-]{43}$" }, "shown_once": { "type": "boolean" }, "pack": { "type": "string" }, "paid_usd": { "type": "string" }, "credited_usd": { "type": "string" }, "bonus_usd": { "type": "string" }, "balance_usd": { "type": "string" }, "use": { "type": "object" }, "balance": { "type": "string" }, "topup": { "type": "object" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/credits/v1/topup/1": { "get": { "operationId": "topup_1", "summary": "Top up an existing key by $1.00 of credits", "tags": [ "Credits (prepaid packs)", "paid" ], "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Bearer yatc_... (your credits key); X-Credits-Key also works" } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "topped_up": { "type": "boolean" }, "pack": { "type": "string" }, "credited_usd": { "type": "string" }, "balance_usd": { "type": "string" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } }, "post": { "operationId": "topup_1_post", "summary": "Top up an existing key by $1.00 of credits", "tags": [ "Credits (prepaid packs)", "paid" ], "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Bearer yatc_... (your credits key); X-Credits-Key also works" } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "1000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "topped_up": { "type": "boolean" }, "pack": { "type": "string" }, "credited_usd": { "type": "string" }, "balance_usd": { "type": "string" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/credits/v1/topup/5": { "get": { "operationId": "topup_5", "summary": "Top up an existing key by $5.50 of credits", "tags": [ "Credits (prepaid packs)", "paid" ], "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Bearer yatc_... (your credits key); X-Credits-Key also works" } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "5.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "topped_up": { "type": "boolean" }, "pack": { "type": "string" }, "credited_usd": { "type": "string" }, "balance_usd": { "type": "string" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } }, "post": { "operationId": "topup_5_post", "summary": "Top up an existing key by $5.50 of credits", "tags": [ "Credits (prepaid packs)", "paid" ], "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Bearer yatc_... (your credits key); X-Credits-Key also works" } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "5.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "5000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "responses": { "200": { "description": "Paid and settled", "content": { "application/json": { "schema": { "type": "object", "properties": { "topped_up": { "type": "boolean" }, "pack": { "type": "string" }, "credited_usd": { "type": "string" }, "balance_usd": { "type": "string" } } } } } }, "400": { "description": "Invalid or missing key (never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/credits/v1/balance": { "get": { "operationId": "credits_balance", "summary": "Balance, spend per tool and recent calls of a key (free)", "security": [], "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or malformed key" }, "404": { "description": "Unknown key" }, "429": { "description": "Rate limited" } }, "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Bearer yatc_... (your credits key); X-Credits-Key also works" } ], "tags": [ "Credits (prepaid packs)" ] } }, "/credits/v1/key/rotate": { "post": { "operationId": "rotate_key", "summary": "Move the balance to a new key; the old key stops working (free)", "security": [], "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or malformed key" }, "404": { "description": "Unknown key" }, "429": { "description": "Rate limited" } }, "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" }, "description": "Bearer yatc_... (your credits key); X-Credits-Key also works" } ], "tags": [ "Credits (prepaid packs)" ] } }, "/credits/v1/preview": { "get": { "operationId": "credits_quote", "summary": "Free: what a pack buys at today's prices", "security": [], "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or malformed key" }, "404": { "description": "Unknown key" }, "429": { "description": "Rate limited" } }, "parameters": [ { "name": "pack", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "1", "5", "sample" ] } } ], "tags": [ "Credits (prepaid packs)" ] } }, "/credits/v1/claim": { "post": { "operationId": "claim_direct_transfer", "summary": "Free: get the key for a pack paid with a plain USDC transfer made from the credits page (Base, Polygon or Arbitrum One; the transfer carries a sha256 claim-code commitment). 202 = not confirmed yet, 409 = already claimed", "security": [], "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or malformed key" }, "404": { "description": "Unknown key" }, "429": { "description": "Rate limited" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "chain", "txHash", "secret" ], "properties": { "chain": { "type": "string", "enum": [ "base", "polygon", "arbitrum" ] }, "txHash": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" }, "secret": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } } } } }, "tags": [ "Credits (prepaid packs)" ] } }, "/credits/v1/prices": { "get": { "operationId": "credits_prices", "summary": "Free: per-route prices of every tool that accepts credits", "security": [], "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or malformed key" }, "404": { "description": "Unknown key" }, "429": { "description": "Rate limited" } }, "tags": [ "Credits (prepaid packs)" ] } }, "/listing/v1/fast-track": { "post": { "operationId": "listing_fast_track", "summary": "Fast-track review: 19.00 USDC", "description": "Your tool is reviewed within 24 hours of payment (the free queue is reviewed in the normal daily run) and, if approved, published on youraitools.co. Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises.", "tags": [ "YourAITools Listings", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "19.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "19000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "tool_url", "name", "contact_email", "category" ], "additionalProperties": true, "properties": { "tool_url": { "type": "string", "format": "uri", "maxLength": 500, "description": "Public https URL of the tool, API or its docs", "example": "https://example.com" }, "name": { "type": "string", "minLength": 2, "maxLength": 80, "example": "Example Tool" }, "contact_email": { "type": "string", "format": "email", "maxLength": 254, "description": "Only used to contact you about this submission; never shown publicly", "example": "you@example.com" }, "category": { "type": "string", "minLength": 2, "maxLength": 48, "example": "x402 API" }, "description": { "type": "string", "maxLength": 600, "description": "Optional: one or two sentences on what it does" }, "notes": { "type": "string", "maxLength": 1000, "description": "Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)" } } } } } }, "responses": { "200": { "description": "Paid and settled: submission received", "content": { "application/json": { "schema": { "type": "object", "properties": { "ref": { "type": "string", "pattern": "^LST-[0-9A-HJKMNP-TV-Z]{10}$" }, "status": { "type": "string", "enum": [ "received" ] }, "tier": { "type": "string" }, "review_by": { "type": "string", "format": "date-time" }, "status_url": { "type": "string" }, "payment": { "type": "object" }, "terms": { "type": "string" } } } } } }, "400": { "description": "Invalid body (checked before payment, so no 402 and never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/listing/v1/launch": { "post": { "operationId": "listing_launch", "summary": "Launch bundle: 49.00 USDC", "description": "Fast-track review within 24 hours, plus 30 days of Featured placement on youraitools.co once approved, plus one line in the YourAITools newsletter once it has subscribers (it has none yet). Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises.", "tags": [ "YourAITools Listings", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "49.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "49000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "tool_url", "name", "contact_email", "category" ], "additionalProperties": true, "properties": { "tool_url": { "type": "string", "format": "uri", "maxLength": 500, "description": "Public https URL of the tool, API or its docs", "example": "https://example.com" }, "name": { "type": "string", "minLength": 2, "maxLength": 80, "example": "Example Tool" }, "contact_email": { "type": "string", "format": "email", "maxLength": 254, "description": "Only used to contact you about this submission; never shown publicly", "example": "you@example.com" }, "category": { "type": "string", "minLength": 2, "maxLength": 48, "example": "x402 API" }, "description": { "type": "string", "maxLength": 600, "description": "Optional: one or two sentences on what it does" }, "notes": { "type": "string", "maxLength": 1000, "description": "Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)" } } } } } }, "responses": { "200": { "description": "Paid and settled: submission received", "content": { "application/json": { "schema": { "type": "object", "properties": { "ref": { "type": "string", "pattern": "^LST-[0-9A-HJKMNP-TV-Z]{10}$" }, "status": { "type": "string", "enum": [ "received" ] }, "tier": { "type": "string" }, "review_by": { "type": "string", "format": "date-time" }, "status_url": { "type": "string" }, "payment": { "type": "object" }, "terms": { "type": "string" } } } } } }, "400": { "description": "Invalid body (checked before payment, so no 402 and never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/listing/v1/featured": { "post": { "operationId": "listing_featured", "summary": "Featured, 30 days: 29.00 USDC", "description": "Reviewed within 48 hours of payment (tools not yet listed are reviewed first) and, if approved, shown as Featured (badge, pinned in its category, marked as paid placement) on youraitools.co for 30 days. Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises.", "tags": [ "YourAITools Listings", "paid" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "29.00" }, "protocols": [ { "x402": {} } ] }, "x-x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F", "amount": "29000000", "assetSymbol": "USDC", "x402Versions": [ 2, 1 ], "networks": [ { "network": "eip155:8453", "name": "Base", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:137", "name": "Polygon", "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "eip155:42161", "name": "Arbitrum One", "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "symbol": "USDC", "payTo": "0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F" }, { "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "name": "Solana", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "symbol": "USDC", "payTo": "FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte" } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "tool_url", "name", "contact_email", "category" ], "additionalProperties": true, "properties": { "tool_url": { "type": "string", "format": "uri", "maxLength": 500, "description": "Public https URL of the tool, API or its docs", "example": "https://example.com" }, "name": { "type": "string", "minLength": 2, "maxLength": 80, "example": "Example Tool" }, "contact_email": { "type": "string", "format": "email", "maxLength": 254, "description": "Only used to contact you about this submission; never shown publicly", "example": "you@example.com" }, "category": { "type": "string", "minLength": 2, "maxLength": 48, "example": "x402 API" }, "description": { "type": "string", "maxLength": 600, "description": "Optional: one or two sentences on what it does" }, "notes": { "type": "string", "maxLength": 1000, "description": "Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)" } } } } } }, "responses": { "200": { "description": "Paid and settled: submission received", "content": { "application/json": { "schema": { "type": "object", "properties": { "ref": { "type": "string", "pattern": "^LST-[0-9A-HJKMNP-TV-Z]{10}$" }, "status": { "type": "string", "enum": [ "received" ] }, "tier": { "type": "string" }, "review_by": { "type": "string", "format": "date-time" }, "status_url": { "type": "string" }, "payment": { "type": "object" }, "terms": { "type": "string" } } } } } }, "400": { "description": "Invalid body (checked before payment, so no 402 and never charged)" }, "402": { "description": "Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}" }, "503": { "description": "Storage unavailable (never charged)" } } } }, "/listing/v1/status/{ref}": { "get": { "operationId": "listing_status", "summary": "Free: status of a paid submission (no email shown)", "security": [], "parameters": [ { "name": "ref", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^LST-[0-9A-HJKMNP-TV-Z]{10}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "ref": { "type": "string" }, "status": { "type": "string", "enum": [ "received", "approved", "rejected", "refund_pending", "refunded" ] }, "tier": { "type": "string" }, "name": { "type": "string" }, "tool_url": { "type": "string" }, "category": { "type": "string" }, "received_at": { "type": "string" }, "review_by": { "type": "string" }, "decided_at": { "type": [ "string", "null" ] }, "featured_from": { "type": "string" }, "featured_until": { "type": "string" }, "payment": { "type": [ "object", "null" ] }, "refund": { "type": "object" } } } } } }, "404": { "description": "Unknown ref" }, "429": { "description": "Rate limited" } }, "tags": [ "YourAITools Listings" ] } }, "/listing/v1/tiers": { "get": { "operationId": "listing_tiers", "summary": "Free: tiers, prices and terms", "security": [], "responses": { "200": { "description": "OK" } }, "tags": [ "YourAITools Listings" ] } } }, "components": { "securitySchemes": { "creditsKey": { "type": "http", "scheme": "bearer", "description": "yatc_... credits key" } } } }