{ "openapi": "3.1.0", "info": { "title": "Polyform — machine-payable data APIs", "version": "1.0.0", "description": "Pay-per-call data endpoints for AI agents. USDC on Base via x402. No account, no API key — one micropayment per call.", "x-guidance": "Polyform sells single-answer data lookups priced per call. GET the catalog at / for the full list. Categories: vehicle (VIN decode, recalls, deal verdict, fuel economy), domain & email intelligence, SEC/EDGAR company facts & filing search, FDA recalls & drug labels, US weather (forecast, hourly, alerts, aviation METAR, travel-risk), geocoding, IP network & threat reputation, World Bank indicators, and an LLM inference gateway. Each call returns a 402 with x402 payment requirements; pay in USDC on Base and retry. All data derives from public/government sources or first-party telemetry." }, "servers": [ { "url": "https://polyform.polyform-org.workers.dev" } ], "paths": { "/v1/vehicle/vin/{vin}": { "get": { "operationId": "v1_vehicle_vin_vin", "summary": "VIN decode + open recalls (NHTSA) — Decode any US-market VIN to full vehicle specs and list open safety recalls. Source: US NHTSA (federal, authoritative). JSON.", "tags": [ "vehicle" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "vehicle": { "type": "object" }, "recalls": { "type": "array", "items": {} } } }, "example": { "vehicle": { "make": "HONDA", "model": "Accord", "year": "2003" }, "recalls": [ { "campaign": "03V123000", "component": "AIR BAGS" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "vin", "in": "path", "required": true, "description": "17-character VIN, e.g. 1HGCM82633A004352", "schema": { "type": "string" } } ] } }, "/v1/vehicle/deal-check": { "get": { "operationId": "v1_vehicle_deal_check", "summary": "Used-car deal check verdict — Given vin, asking price and miles: decoded specs, open recall count, fuel-cost estimate, and a buy/caution/walk verdict with reasoning. All public federal data.", "tags": [ "vehicle" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" }, "reasons": { "type": "array", "items": {} }, "vehicle": { "type": "object" } } }, "example": { "verdict": "CAUTION", "reasons": [ "2 open recalls" ], "vehicle": { "year": "2015", "make": "FORD" } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "vin", "in": "query", "required": true, "description": "17-char VIN", "schema": { "type": "string" } }, { "name": "price", "in": "query", "required": true, "description": "asking price USD", "schema": { "type": "string" } }, { "name": "miles", "in": "query", "required": true, "description": "odometer miles", "schema": { "type": "string" } } ] } }, "/v1/vehicle/fuel-economy": { "get": { "operationId": "v1_vehicle_fuel_economy", "summary": "Fuel economy lookup (EPA) — EPA MPG figures and estimated annual fuel cost for a year/make/model. Source: fueleconomy.gov. JSON.", "tags": [ "vehicle" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "matches": { "type": "array", "items": {} } } }, "example": { "matches": [ { "id": "36154", "trim": "Auto (S6), 4 cyl, 2.4 L", "cityMpg": 27 } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "year", "in": "query", "required": true, "description": "model year", "schema": { "type": "string" } }, { "name": "make", "in": "query", "required": true, "description": "manufacturer", "schema": { "type": "string" } }, { "name": "model", "in": "query", "required": true, "description": "model name", "schema": { "type": "string" } } ] } }, "/v1/domain/{domain}": { "get": { "operationId": "v1_domain_domain", "summary": "Domain intelligence (RDAP) — Registration intelligence for any domain: creation/expiry dates, age in days, registrar, statuses, nameservers. Source: registry RDAP. JSON.", "tags": [ "domain" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "created": { "type": "string" }, "ageDays": { "type": "number" }, "registrar": { "type": "string" }, "nameservers": { "type": "array", "items": {} } } }, "example": { "domain": "example.com", "created": "1995-08-14", "ageDays": 11334, "registrar": "RESERVED", "nameservers": [ "A.IANA-SERVERS.NET" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "domain", "in": "path", "required": true, "description": "domain name, e.g. example.com", "schema": { "type": "string" } } ] } }, "/v1/email/domain-check": { "get": { "operationId": "v1_email_domain_check", "summary": "Email domain deliverability check — Can this domain receive mail, and is it configured seriously? MX, SPF and DMARC via DNS-over-HTTPS with a deliverability summary. JSON.", "tags": [ "email" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "canReceive": { "type": "boolean" }, "mx": { "type": "array", "items": {} }, "spf": { "type": "boolean" }, "dmarc": { "type": "string" } } }, "example": { "domain": "gmail.com", "canReceive": true, "mx": [ "gmail-smtp-in.l.google.com" ], "spf": true, "dmarc": "reject" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "domain to check, e.g. gmail.com", "schema": { "type": "string" } } ] } }, "/v1/sec/company/{id}": { "get": { "operationId": "v1_sec_company_id", "summary": "SEC company facts (EDGAR) — Latest key financial facts for a US public company by ticker or CIK: revenue, net income, assets, EPS from XBRL filings. Source: SEC EDGAR. JSON.", "tags": [ "sec" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "cik": { "type": "string" }, "facts": { "type": "object" } } }, "example": { "name": "Apple Inc.", "cik": "0000320193", "facts": { "Revenues": { "val": 391035000000, "fy": 2024 } } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "ticker (AAPL) or CIK number", "schema": { "type": "string" } } ] } }, "/v1/fda/recalls": { "get": { "operationId": "v1_fda_recalls", "summary": "FDA recall search (openFDA) — Search US FDA enforcement recalls for drugs, food, or devices by free-text query. Source: openFDA. JSON.", "tags": [ "fda" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "number" }, "recalls": { "type": "array", "items": {} } } }, "example": { "count": 2, "recalls": [ { "product": "…", "reason": "…", "classification": "Class I", "date": "2026-04-01" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "type", "in": "query", "required": true, "description": "drug | food | device", "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "description": "search terms", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "1-25 (default 5)", "schema": { "type": "string" } } ] } }, "/v1/ai/chat": { "post": { "operationId": "v1_ai_chat", "summary": "Inference gateway (Llama on Workers AI) — Pay-per-call LLM completion. POST {messages:[{role,content},...]} (OpenAI-style), returns {reply}. No account, no API key — one x402 payment per call.", "tags": [ "ai" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "reply": { "type": "string" }, "model": { "type": "string" } } }, "example": { "reply": "…", "model": "llama-3.1-8b-instruct" } } } }, "402": { "description": "Payment Required" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "messages": { "type": "array", "description": "OpenAI-style messages array", "items": { "type": "object" } } }, "required": [ "messages" ] } } } } } }, "/v1/weather/forecast": { "get": { "operationId": "v1_weather_forecast", "summary": "US weather forecast (NWS) — 7-day forecast for any US coordinate: periods with temperature, wind, precipitation chance, narrative. Source: National Weather Service. JSON.", "tags": [ "weather" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "type": "string" }, "periods": { "type": "array", "items": {} } } }, "example": { "location": "Nashville, TN", "periods": [ { "name": "Tonight", "temperature": 71, "shortForecast": "Partly Cloudy" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "latitude e.g. 36.16", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude e.g. -86.78", "schema": { "type": "string" } } ] } }, "/v1/weather/alerts": { "get": { "operationId": "v1_weather_alerts", "summary": "Active US weather alerts (NWS) — Active watches/warnings/advisories for a US state or coordinate: event type, severity, headline, timing. Source: National Weather Service. JSON.", "tags": [ "weather" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "number" }, "alerts": { "type": "array", "items": {} } } }, "example": { "count": 1, "alerts": [ { "event": "Severe Thunderstorm Warning", "severity": "Severe", "headline": "…", "expires": "…" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "state", "in": "query", "required": true, "description": "2-letter state e.g. TN (or use lat+lon)", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "description": "optional latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": false, "description": "optional longitude", "schema": { "type": "string" } } ] } }, "/v1/weather/hourly": { "get": { "operationId": "v1_weather_hourly", "summary": "US hourly forecast (NWS) — Hour-by-hour forecast for any US coordinate: temperature, precipitation chance, wind, conditions for the next 48 hours. Source: National Weather Service. JSON.", "tags": [ "weather" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "type": "string" }, "hours": { "type": "array", "items": {} } } }, "example": { "location": "Nashville, TN", "hours": [ { "time": "…", "temperature": 74, "precipChancePct": 20, "shortForecast": "Partly Cloudy" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude", "schema": { "type": "string" } }, { "name": "hours", "in": "query", "required": false, "description": "1-48 (default 24)", "schema": { "type": "string" } } ] } }, "/v1/weather/current": { "get": { "operationId": "v1_weather_current", "summary": "US current conditions (NWS) — Latest observed conditions near a US coordinate: temperature, wind, humidity, visibility, pressure from the nearest weather station. Source: National Weather Service. JSON.", "tags": [ "weather" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "station": { "type": "string" }, "tempF": { "type": "number" }, "humidityPct": { "type": "number" }, "windMph": { "type": "number" }, "conditions": { "type": "string" } } }, "example": { "station": "KBNA", "tempF": 88, "humidityPct": 54, "windMph": 8, "conditions": "Mostly Cloudy" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude", "schema": { "type": "string" } } ] } }, "/v1/weather/metar": { "get": { "operationId": "v1_weather_metar", "summary": "Aviation weather METAR/TAF (NOAA) — Raw and decoded METAR (and optional TAF) for any airport ICAO code. Source: NOAA Aviation Weather Center. JSON.", "tags": [ "weather" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "station": { "type": "string" }, "rawMetar": { "type": "string" }, "tempC": { "type": "number" }, "windKt": { "type": "number" }, "flightCategory": { "type": "string" } } }, "example": { "station": "KBNA", "rawMetar": "KBNA 260753Z ...", "tempC": 24, "windKt": 6, "flightCategory": "VFR" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "station", "in": "query", "required": true, "description": "ICAO code e.g. KBNA", "schema": { "type": "string" } }, { "name": "taf", "in": "query", "required": true, "description": "true to include TAF", "schema": { "type": "string" } } ] } }, "/v1/weather/travel-risk": { "get": { "operationId": "v1_weather_travel_risk", "summary": "US weather travel-risk verdict — Judgment call for a US coordinate and date (within 7 days): LOW/MODERATE/HIGH/SEVERE weather risk with reasons, built from NWS forecast plus active alerts. JSON.", "tags": [ "weather" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.015000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "risk": { "type": "string" }, "reasons": { "type": "array", "items": {} }, "date": { "type": "string" } } }, "example": { "risk": "HIGH", "reasons": [ "Severe Thunderstorm Watch active", "80% precip" ], "date": "2026-08-27" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude", "schema": { "type": "string" } }, { "name": "date", "in": "query", "required": false, "description": "YYYY-MM-DD within 7 days (default today)", "schema": { "type": "string" } } ] } }, "/v1/geo/geocode": { "get": { "operationId": "v1_geo_geocode", "summary": "US address geocoding (Census) — US street address to coordinates plus matched/normalized address. Source: US Census Bureau geocoder. JSON.", "tags": [ "geo" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "matched": { "type": "string" }, "lat": { "type": "number" }, "lon": { "type": "number" } } }, "example": { "matched": "4600 SILVER HILL RD, WASHINGTON, DC, 20233", "lat": 38.845985, "lon": -76.9274 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "one-line US address", "schema": { "type": "string" } } ] } }, "/v1/geo/reverse": { "get": { "operationId": "v1_geo_reverse", "summary": "US reverse geocoding (Census) — Coordinates to US state, county, tract and block geography. Source: US Census Bureau. JSON.", "tags": [ "geo" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "string" }, "county": { "type": "string" }, "tract": { "type": "string" } } }, "example": { "state": "Tennessee", "county": "Davidson County", "tract": "016300" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "lat", "in": "query", "required": true, "description": "latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude", "schema": { "type": "string" } } ] } }, "/v1/sec/filings/search": { "get": { "operationId": "v1_sec_filings_search", "summary": "SEC filings full-text search (EDGAR) — Full-text search across SEC filings; filter by form type. Returns filing metadata and links. Source: SEC EDGAR full-text search. JSON.", "tags": [ "sec" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "number" }, "filings": { "type": "array", "items": {} } } }, "example": { "total": 152, "filings": [ { "company": "…", "form": "8-K", "filed": "2026-05-01", "url": "…" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "q", "in": "query", "required": true, "description": "search phrase", "schema": { "type": "string" } }, { "name": "form", "in": "query", "required": false, "description": "optional form type e.g. 10-K, 8-K", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "1-20 (default 5)", "schema": { "type": "string" } } ] } }, "/v1/fda/drug-label": { "get": { "operationId": "v1_fda_drug_label", "summary": "FDA drug label lookup (openFDA) — Official FDA label data for a drug by brand or generic name: indications, warnings, dosage. Source: openFDA. JSON.", "tags": [ "fda" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "brand": { "type": "string" }, "generic": { "type": "string" }, "indications": { "type": "string" }, "warnings": { "type": "string" } } }, "example": { "brand": "Advil", "generic": "ibuprofen", "indications": "…", "warnings": "…" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "brand or generic drug name", "schema": { "type": "string" } } ] } }, "/v1/ip/{ip}": { "get": { "operationId": "v1_ip_ip", "summary": "IP network intelligence (RDAP) — Who operates an IP: registry, network range, organization, country. Source: RIR RDAP. JSON.", "tags": [ "ip" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "ip": { "type": "string" }, "org": { "type": "string" }, "range": { "type": "string" }, "registry": { "type": "string" }, "country": { "type": "string" } } }, "example": { "ip": "8.8.8.8", "org": "GOGL", "range": "8.8.8.0/24", "registry": "ARIN", "country": "US" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "ip", "in": "path", "required": true, "description": "IPv4 or IPv6 address", "schema": { "type": "string" } } ] } }, "/v1/threat/ip": { "get": { "operationId": "v1_threat_ip", "summary": "IP threat / abuse reputation — Is this IP hostile? Reputation verdict for an IPv4 from public abuse feeds (blocklist.de, Spamhaus DROP) plus Polyform's own observed scanner traffic. Returns malicious flag, 0-100 score, and which sources flagged it. For bot filtering, fraud and firewall automation. J", "tags": [ "threat" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "ip": { "type": "string" }, "malicious": { "type": "boolean" }, "score": { "type": "number" }, "sources": { "type": "array", "items": {} }, "observedByPolyform": { "type": "boolean" } } }, "example": { "ip": "45.134.26.5", "malicious": true, "score": 90, "sources": [ "blocklist.de", "polyform-observed" ], "observedByPolyform": true } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "ip", "in": "query", "required": true, "description": "IPv4 address to check", "schema": { "type": "string" } } ] } }, "/v1/threat/scanners": { "get": { "operationId": "v1_threat_scanners", "summary": "Polyform observed-scanner feed — Recent IPs caught probing Polyform's honeypot paths (credential/vuln scanners) — Polyform's own first-party telemetry, not a repackaged public list. Returns up to 500 most-recent scanner IPs with first-seen. For blocklists and threat research. JSON.", "tags": [ "threat" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "number" }, "scanners": { "type": "array", "items": {} } } }, "example": { "count": 200, "scanners": [ { "ip": "45.134.26.5", "firstSeen": "2026-08-25T04:00:00Z", "probe": "/.env" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "1-500 (default 200)", "schema": { "type": "string" } } ] } }, "/v1/econ/worldbank": { "get": { "operationId": "v1_econ_worldbank", "summary": "World Bank indicator lookup — Latest value of any World Bank indicator for a country (GDP, inflation, population...). Source: World Bank API. JSON.", "tags": [ "econ" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "country": { "type": "string" }, "indicator": { "type": "string" }, "value": { "type": "number" }, "year": { "type": "number" } } }, "example": { "country": "United States", "indicator": "GDP (current US$)", "value": 29000000000000, "year": 2025 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO2/ISO3 code e.g. US", "schema": { "type": "string" } }, { "name": "indicator", "in": "query", "required": true, "description": "e.g. NY.GDP.MKTP.CD", "schema": { "type": "string" } } ] } }, "/v1/time/business-days": { "get": { "operationId": "v1_time_business_days", "summary": "US business-days calculator — Business days between two dates (exclusive of end), skipping weekends and US federal holidays; also returns the holiday list in range. Pure computation. JSON.", "tags": [ "time" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "businessDays": { "type": "number" }, "holidays": { "type": "array", "items": {} } } }, "example": { "start": "2026-01-01", "end": "2026-02-01", "businessDays": 20, "holidays": [ "2026-01-01", "2026-01-19" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "start", "in": "query", "required": true, "description": "YYYY-MM-DD", "schema": { "type": "string" } }, { "name": "end", "in": "query", "required": true, "description": "YYYY-MM-DD", "schema": { "type": "string" } } ] } }, "/v1/vehicle/report": { "get": { "operationId": "v1_vehicle_report", "summary": "Vehicle full report (bundle) — One call: decoded VIN specs + all open safety recalls + EPA fuel economy & annual cost + a buy/caution/walk verdict with reasoning. Fuses multiple NHTSA & EPA sources. JSON.", "tags": [ "vehicle" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "vehicle": { "type": "object" }, "recallCount": { "type": "number" }, "fuelEconomy": { "type": "object" }, "verdict": { "type": "string" } } }, "example": { "vehicle": { "year": "2015", "make": "FORD" }, "recallCount": 2, "fuelEconomy": { "combinedMpg": 26 }, "verdict": "CAUTION" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "vin", "in": "query", "required": true, "description": "17-char VIN", "schema": { "type": "string" } }, { "name": "price", "in": "query", "required": false, "description": "asking price USD (optional, enables verdict)", "schema": { "type": "string" } }, { "name": "miles", "in": "query", "required": false, "description": "odometer miles (optional)", "schema": { "type": "string" } } ] } }, "/v1/domain/due-diligence": { "get": { "operationId": "v1_domain_due_diligence", "summary": "Domain due-diligence (bundle) — One call to vet a domain: registration/RDAP intel (age, registrar, status) + email deliverability (MX/SPF/DMARC) + threat reputation of the domain's hosting IP. For counterparties, sellers, links. JSON.", "tags": [ "domain" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "registration": { "type": "object" }, "email": { "type": "object" }, "hosting": { "type": "object" } } }, "example": { "domain": "example.com", "registration": { "ageDays": 11334 }, "email": { "canReceive": true }, "hosting": { "ip": "…", "malicious": false } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "domain name to vet", "schema": { "type": "string" } } ] } }, "/v1/geo/location-brief": { "get": { "operationId": "v1_geo_location_brief", "summary": "Location brief (bundle) — One call for a US place — pass an address OR lat+lon: normalized address + county/state + current conditions + active weather alerts. JSON.", "tags": [ "geo" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "location": { "type": "string" }, "county": { "type": "string" }, "current": { "type": "object" }, "activeAlerts": { "type": "number" } } }, "example": { "location": "Nashville, TN", "county": "Davidson County", "current": { "tempF": 72 }, "activeAlerts": 0 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "US address (or use lat+lon)", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "description": "optional latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": false, "description": "optional longitude", "schema": { "type": "string" } } ] } }, "/v1/sec/company-snapshot": { "get": { "operationId": "v1_sec_company_snapshot", "summary": "Company snapshot (bundle) — One call: SEC company facts (revenue, net income, assets, EPS) + the company's most recent filings. Ticker or CIK. JSON.", "tags": [ "sec" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "facts": { "type": "object" }, "recentFilings": { "type": "array", "items": {} } } }, "example": { "name": "Apple Inc.", "facts": { "revenue": {} }, "recentFilings": [ { "form": "10-K", "filed": "2024-11-01" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "ticker (AAPL) or CIK", "schema": { "type": "string" } } ] } }, "/v1/finance/health-scan": { "get": { "operationId": "v1_finance_health_scan", "summary": "Company financial-health scan (bundle) — One call: a public company's revenue & margin trend, current ratio, profitability and recent material filings (8-K/10-K/10-Q) fused into a healthy/watch/distress verdict. Ticker or CIK. SEC EDGAR. JSON.", "tags": [ "finance" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "verdict": { "type": "string" }, "metrics": { "type": "object" }, "eightKLast90Days": { "type": "number" } } }, "example": { "name": "Apple Inc.", "verdict": "HEALTHY", "metrics": { "netMarginPct": 25, "currentRatio": 1.1, "revenueYoYPct": 2 }, "eightKLast90Days": 3 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "ticker (AAPL) or 10-digit CIK", "schema": { "type": "string" } } ] } }, "/v1/realestate/site-risk": { "get": { "operationId": "v1_realestate_site_risk", "summary": "Property site-risk brief (bundle) — One call for a US property — pass an address OR lat+lon: FEMA flood-zone determination (SFHA yes/no), county/state, current conditions and active weather alerts, fused into a site-risk verdict. For lending, insurance, diligence. JSON.", "tags": [ "realestate" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "flood": { "type": "object" }, "riskLevel": { "type": "string" }, "activeAlerts": { "type": "number" } } }, "example": { "query": "Miami, FL", "flood": { "zone": "AE", "sfha": true }, "riskLevel": "HIGH", "activeAlerts": 0 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "US address (or use lat+lon)", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "description": "optional latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": false, "description": "optional longitude", "schema": { "type": "string" } } ] } }, "/v1/logistics/route-brief": { "get": { "operationId": "v1_logistics_route_brief", "summary": "Route & shipment brief (bundle) — One call: driving distance and time between two US points (addresses or lat,lon), an estimated fuel cost, and weather + active alerts at both ends, fused into a go/caution verdict. JSON.", "tags": [ "logistics" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "distanceMiles": { "type": "number" }, "driveTime": { "type": "string" }, "fuelCostEstimate": { "type": "number" }, "verdict": { "type": "string" } } }, "example": { "distanceMiles": 412, "driveTime": "6h 10m", "fuelCostEstimate": 66, "verdict": "CLEAR" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "origin", "in": "query", "required": true, "description": "origin address or 'lat,lon'", "schema": { "type": "string" } }, { "name": "dest", "in": "query", "required": true, "description": "destination address or 'lat,lon'", "schema": { "type": "string" } }, { "name": "mpg", "in": "query", "required": false, "description": "optional vehicle MPG (default 25)", "schema": { "type": "string" } } ] } }, "/v1/crypto/token-report": { "get": { "operationId": "v1_crypto_token_report", "summary": "Token due-diligence (bundle) — One call to vet an ERC-20 token on Base or Ethereum: live USD price, holder count, and security signals (honeypot, mintable, open-source, buy/sell tax, owner & holder concentration) fused into a risk verdict. JSON.", "tags": [ "crypto" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string" }, "priceUsd": { "type": "number" }, "security": { "type": "object" }, "riskLevel": { "type": "string" } } }, "example": { "symbol": "TKN", "priceUsd": 0.0021, "security": { "honeypot": false, "mintable": false }, "riskLevel": "LOW" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "token contract address (0x…)", "schema": { "type": "string" } }, { "name": "chain", "in": "query", "required": false, "description": "base or ethereum (default base)", "schema": { "type": "string" } } ] } }, "/v1/health/drug-brief": { "get": { "operationId": "v1_health_drug_brief", "summary": "Drug safety brief (bundle) — One call for a medication: RxNorm identity, FDA label safety text (boxed warning, warnings, interactions, contraindications) and the most-reported real-world adverse reactions (FDA FAERS). Reference data, not medical advice. JSON.", "tags": [ "health" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "generic": { "type": "string" }, "rxcui": { "type": "string" }, "topAdverseReactions": { "type": "array", "items": {} } } }, "example": { "generic": "atorvastatin", "rxcui": "83367", "topAdverseReactions": [ { "term": "FATIGUE", "reports": 14405 } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "drug brand or generic name", "schema": { "type": "string" } } ] } }, "/v1/legal/sanctions-screen": { "get": { "operationId": "v1_legal_sanctions_screen", "summary": "Sanctions & watchlist screen (bundle) — One call to screen a person or company name against the US Consolidated Screening List — OFAC SDN + Consolidated, BIS Entity/Denied/Unverified, State Dept debarred — with aliases: match/no-match, which list, programs, and a clear/review/hit verdict. For KYC an", "tags": [ "legal" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "verdict": { "type": "string" }, "matchCount": { "type": "number" }, "matches": { "type": "array", "items": {} } } }, "example": { "query": "…", "verdict": "CLEAR", "matchCount": 0, "matches": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "person or entity name to screen", "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "description": "optional: individual or entity", "schema": { "type": "string" } } ] } }, "/v1/finance/insider-activity": { "get": { "operationId": "v1_finance_insider_activity", "summary": "Insider trading activity (bundle) — One call: recent SEC Form 4 insider transactions for a public company — who bought/sold, share counts and dollar value over the last ~120 days, netted into a bullish/bearish/neutral insider signal. Ticker or CIK. SEC EDGAR. JSON.", "tags": [ "finance" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "signal": { "type": "string" }, "window": { "type": "string" }, "buys": { "type": "number" }, "sells": { "type": "number" }, "netValueUSD": { "type": "number" }, "transactions": { "type": "array", "items": {} } } }, "example": { "name": "Apple Inc.", "signal": "NET SELLING", "window": "120d", "buys": 1, "sells": 4, "netValueUSD": -2100000, "transactions": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "ticker (AAPL) or 10-digit CIK", "schema": { "type": "string" } } ] } }, "/v1/crypto/protocol": { "get": { "operationId": "v1_crypto_protocol", "summary": "DeFi protocol brief (bundle) — One call for a DeFi protocol by slug: total value locked (USD), category, chains it runs on with per-chain TVL, audit status and a one-line description. From DefiLlama. JSON.", "tags": [ "crypto" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "category": { "type": "string" }, "tvlUsd": { "type": "number" }, "chains": { "type": "array", "items": {} }, "audited": { "type": "boolean" } } }, "example": { "name": "Aave", "category": "Lending", "tvlUsd": 43700000000, "chains": [ { "chain": "Ethereum", "tvlUsd": 20000000000 } ], "audited": true } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "slug", "in": "query", "required": true, "description": "protocol slug, e.g. aave, uniswap, lido", "schema": { "type": "string" } } ] } }, "/v1/legal/reg-watch": { "get": { "operationId": "v1_legal_reg_watch", "summary": "Regulatory watch (bundle) — One call: the most recent US Federal Register documents (rules, proposed rules, notices) matching a topic — with agency, type, date, and abstract. Optional agency filter. For compliance monitoring. JSON.", "tags": [ "legal" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "topic": { "type": "string" }, "count": { "type": "number" }, "documents": { "type": "array", "items": {} } } }, "example": { "topic": "stablecoin", "count": 12, "documents": [ { "title": "…", "type": "Proposed Rule", "agency": "SEC", "date": "2026-08-21" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "description": "search topic, e.g. 'stablecoin' or 'PFAS'", "schema": { "type": "string" } }, { "name": "agency", "in": "query", "required": false, "description": "optional agency slug, e.g. securities-and-exchange-commission", "schema": { "type": "string" } } ] } }, "/v1/finance/company-360": { "get": { "operationId": "v1_finance_company_360", "summary": "Company 360 report (bundle) — One premium call: a public company's financial-health verdict (margins, current ratio, revenue trend), insider-trading signal (Form 4 buys/sells), SEC facts and recent filings — the full equity picture. Ticker or CIK. JSON.", "tags": [ "finance" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.200000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "financialHealth": { "type": "object" }, "insider": { "type": "object" }, "recentFilings": { "type": "array", "items": {} } } }, "example": { "name": "Apple Inc.", "financialHealth": { "verdict": "HEALTHY" }, "insider": { "signal": "NEUTRAL" }, "recentFilings": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "ticker (AAPL) or 10-digit CIK", "schema": { "type": "string" } } ] } }, "/v1/business/vet": { "get": { "operationId": "v1_business_vet", "summary": "Business counterparty vet / KYB (bundle) — One premium call to vet a business before onboarding: OFAC/Consolidated sanctions screen of the name + domain due-diligence (registration age, email posture, hosting-IP threat reputation) fused into an overall risk verdict with flags. Name and/or domain. JS", "tags": [ "business" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "overallRisk": { "type": "string" }, "sanctions": { "type": "object" }, "domain": { "type": "object" }, "flags": { "type": "array", "items": {} } } }, "example": { "overallRisk": "LOW", "sanctions": { "verdict": "CLEAR" }, "domain": { "registration": { "ageDays": 4200 } }, "flags": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": false, "description": "business or person name (optional if domain given)", "schema": { "type": "string" } }, { "name": "domain", "in": "query", "required": false, "description": "company domain (optional if name given)", "schema": { "type": "string" } } ] } }, "/v1/health/clinical-trials": { "get": { "operationId": "v1_health_clinical_trials", "summary": "Clinical trials search (bundle) — One call: recent clinical trials for a condition and/or intervention — NCT id, title, status, phase, sponsor and last-update date. From ClinicalTrials.gov. For pharma, research, diligence. JSON.", "tags": [ "health" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "total": { "type": "number" }, "trials": { "type": "array", "items": {} } } }, "example": { "total": 1240, "trials": [ { "nctId": "NCT01234567", "status": "RECRUITING", "phase": "PHASE3", "sponsor": "…" } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "condition", "in": "query", "required": false, "description": "disease/condition (optional if intervention given)", "schema": { "type": "string" } }, { "name": "intervention", "in": "query", "required": false, "description": "drug/intervention (optional if condition given)", "schema": { "type": "string" } } ] } }, "/v1/geo/earthquakes": { "get": { "operationId": "v1_geo_earthquakes", "summary": "Seismic risk brief (bundle) — One call for a US point (address or lat+lon): recent earthquakes within a radius — count, largest magnitude, list, and a seismic-risk level. For insurance, siting, diligence. USGS. JSON.", "tags": [ "geo" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "count": { "type": "number" }, "maxMagnitude": { "type": "number" }, "seismicRisk": { "type": "string" }, "quakes": { "type": "array", "items": {} } } }, "example": { "query": "Los Angeles, CA", "count": 12, "maxMagnitude": 4.2, "seismicRisk": "MODERATE", "quakes": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "address (or use lat+lon)", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "description": "optional latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": false, "description": "optional longitude", "schema": { "type": "string" } }, { "name": "radiusKm", "in": "query", "required": false, "description": "optional radius km (default 250)", "schema": { "type": "string" } }, { "name": "days", "in": "query", "required": false, "description": "optional lookback days (default 90)", "schema": { "type": "string" } } ] } }, "/v1/realestate/property-report": { "get": { "operationId": "v1_realestate_property_report", "summary": "Property hazard report (bundle) — One premium call for a US property — address or lat+lon: FEMA flood-zone determination + USGS seismic history (1yr) + current weather and active alerts, fused into an overall hazard verdict with factors. For insurance, lending, siting. JSON.", "tags": [ "realestate" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "overallHazard": { "type": "string" }, "flood": { "type": "object" }, "seismic": { "type": "object" }, "factors": { "type": "array", "items": {} } } }, "example": { "query": "Miami, FL", "overallHazard": "HIGH", "flood": { "zone": "AE", "sfha": true }, "seismic": { "risk": "MINIMAL" }, "factors": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "US address (or use lat+lon)", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "description": "optional latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": false, "description": "optional longitude", "schema": { "type": "string" } } ] } }, "/v1/domain/brand-protection": { "get": { "operationId": "v1_domain_brand_protection", "summary": "Brand-protection typosquat scan (bundle) — One call to find look-alike / typosquat domains impersonating a brand: generates common misspellings, character swaps, homoglyphs and alternate TLDs of your domain, checks which are actually registered/live via DNS, and flags those configured for mail (phis", "tags": [ "domain" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "candidatesTested": { "type": "number" }, "registeredLookalikes": { "type": "number" }, "mailCapable": { "type": "number" }, "threatLevel": { "type": "string" }, "lookalikes": { "type": "array", "items": {} } } }, "example": { "domain": "example.com", "candidatesTested": 38, "registeredLookalikes": 6, "mailCapable": 2, "threatLevel": "ELEVATED", "lookalikes": [ { "domain": "examp1e.com", "live": true, "mailCapable": true, "ageDays": 120 } ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "your brand's domain, e.g. example.com", "schema": { "type": "string" } }, { "name": "tlds", "in": "query", "required": false, "description": "optional comma-separated extra TLDs to test, e.g. 'shop,app'", "schema": { "type": "string" } } ] } }, "/v1/finance/peer-compare": { "get": { "operationId": "v1_finance_peer_compare", "summary": "Company peer comparison (bundle) — One premium call comparing two public companies head-to-head: revenue, net income, net margin, YoY growth, current ratio and financial-health verdict side by side, with per-metric winners and a data-backed 'stronger financial profile' call. Two tickers or CIKs. SEC", "tags": [ "finance" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.200000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "a": { "type": "object" }, "b": { "type": "object" }, "stronger": { "type": "string" }, "winners": { "type": "object" } } }, "example": { "a": { "name": "Coca-Cola", "verdict": "HEALTHY" }, "b": { "name": "PepsiCo", "verdict": "HEALTHY" }, "stronger": "KO", "winners": { "netMarginPct": "KO", "revenueYoYPct": "PEP" } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "a", "in": "query", "required": true, "description": "first company ticker or CIK, e.g. KO", "schema": { "type": "string" } }, { "name": "b", "in": "query", "required": true, "description": "second company ticker or CIK, e.g. PEP", "schema": { "type": "string" } } ] } }, "/v1/trade/party-screen": { "get": { "operationId": "v1_trade_party_screen", "summary": "Trade-compliance party screen (bundle) — One premium call for import/export compliance: screens a counterparty name against the US Consolidated Screening List (OFAC + BIS + State) AND pulls recent US Federal Register actions on the commodity/topic (export controls, tariffs, rules), fused into a clea", "tags": [ "trade" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.200000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "party": { "type": "string" }, "commodity": { "type": "string" }, "tradeVerdict": { "type": "string" }, "sanctions": { "type": "object" }, "regulatory": { "type": "object" }, "flags": { "type": "array", "items": {} } } }, "example": { "party": "…", "commodity": "semiconductors", "tradeVerdict": "REVIEW", "sanctions": { "verdict": "CLEAR" }, "regulatory": { "count": 4 }, "flags": [] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "counterparty / party name to screen", "schema": { "type": "string" } }, { "name": "commodity", "in": "query", "required": false, "description": "optional commodity or topic, e.g. 'semiconductors'", "schema": { "type": "string" } }, { "name": "agency", "in": "query", "required": false, "description": "optional agency slug, e.g. bureau-of-industry-and-security", "schema": { "type": "string" } } ] } }, "/v1/dns/lookup": { "get": { "operationId": "v1_dns_lookup", "summary": "DNS record lookup — Resolve any DNS record type (A, AAAA, MX, TXT, NS, CNAME, SOA, CAA) for a hostname via DNS-over-HTTPS. JSON.", "tags": [ "dns" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "records": { "type": "array", "items": {} } } }, "example": { "name": "example.com", "type": "A", "records": [ "93.184.216.34" ] } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "hostname e.g. example.com", "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "description": "record type: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA (default A)", "schema": { "type": "string" } } ] } }, "/v1/crypto/gas": { "get": { "operationId": "v1_crypto_gas", "summary": "EVM gas price — Current gas price for Base or Ethereum mainnet, in gwei and wei. Source: public RPC. JSON.", "tags": [ "crypto" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string" }, "gasPriceGwei": { "type": "number" }, "gasPriceWei": { "type": "string" } } }, "example": { "chain": "base", "gasPriceGwei": 0.006, "gasPriceWei": "6000000" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "chain", "in": "query", "required": false, "description": "base | ethereum (default base)", "schema": { "type": "string" } } ] } }, "/v1/crypto/balance": { "get": { "operationId": "v1_crypto_balance", "summary": "Wallet balance (Base) — Native ETH + USDC balance for any address on Base mainnet. Source: public RPC. JSON.", "tags": [ "crypto" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "address": { "type": "string" }, "eth": { "type": "number" }, "usdc": { "type": "number" }, "chain": { "type": "string" } } }, "example": { "address": "0x…", "eth": 0.5, "usdc": 1200.5, "chain": "base" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "0x wallet address", "schema": { "type": "string" } } ] } }, "/v1/wiki/summary": { "get": { "operationId": "v1_wiki_summary", "summary": "Wikipedia summary — Concise summary/extract for any Wikipedia topic, with the canonical URL. Source: Wikimedia REST API. JSON.", "tags": [ "wiki" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string" }, "extract": { "type": "string" }, "url": { "type": "string" } } }, "example": { "title": "Ethereum", "extract": "Ethereum is a decentralized…", "url": "https://en.wikipedia.org/wiki/Ethereum" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "description": "article title or search term", "schema": { "type": "string" } } ] } }, "/v1/url/check": { "get": { "operationId": "v1_url_check", "summary": "URL status & redirect check — HTTP status, final URL after redirects, content-type and key response headers for a URL — without downloading the body. For link vetting and uptime checks. JSON.", "tags": [ "url" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "status": { "type": "number" }, "finalUrl": { "type": "string" }, "redirected": { "type": "boolean" }, "contentType": { "type": "string" } } }, "example": { "url": "http://example.com", "status": 200, "finalUrl": "https://example.com/", "redirected": true, "contentType": "text/html" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": true, "description": "http(s) URL to check", "schema": { "type": "string" } } ] } }, "/v1/text/summarize": { "post": { "operationId": "v1_text_summarize", "summary": "Text summarizer (Workers AI) — Summarize arbitrary text into a concise summary. POST {text, sentences?}. Runs Llama on Workers AI. JSON.", "tags": [ "text" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.008000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string" }, "model": { "type": "string" } } }, "example": { "summary": "…", "model": "llama-3.3-70b" } } } }, "402": { "description": "Payment Required" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "description": "text to summarize" }, "sentences": { "type": "string", "description": "optional target sentence count (default 3)" } }, "required": [ "text", "sentences" ] } } } } } }, "/v1/business/onboard-decision": { "get": { "operationId": "v1_business_onboard_decision", "summary": "Onboarding decision (bundle) — One call: APPROVE/REVIEW/REJECT onboarding gate + 0-100 risk score, fusing KYB counterparty vet, OFAC/CSL sanctions screening, and adverse US regulatory actions.", "tags": [ "business" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.500000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "decision": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "decision": "REVIEW", "riskScore": 42 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "business or counterparty name to screen", "schema": { "type": "string" } }, { "name": "domain", "in": "query", "required": false, "description": "business domain (optional)", "schema": { "type": "string" } } ] } }, "/v1/finance/diligence-brief": { "get": { "operationId": "v1_finance_diligence_brief", "summary": "Investment diligence brief (bundle) — One call: CONSTRUCTIVE/NEUTRAL/CAUTION posture on a public company, fusing financial-health + insider activity (SEC EDGAR), optional peer comparison, and issuer sanctions screening.", "tags": [ "finance" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.500000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "posture": { "type": "string" } } }, "example": { "posture": "NEUTRAL" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "ticker or CIK of the public company", "schema": { "type": "string" } }, { "name": "peer", "in": "query", "required": false, "description": "optional peer ticker or CIK to compare against", "schema": { "type": "string" } } ] } }, "/v1/trade/shipment-clearance": { "get": { "operationId": "v1_trade_shipment_clearance", "summary": "Shipment clearance (bundle) — One call: CLEAR/REVIEW/HOLD export/import pre-screen — screens the counterparty (US CSL), checks the destination against US embargo lists, and flags export-controlled commodities.", "tags": [ "trade" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.450000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" } } }, "example": { "verdict": "REVIEW" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "name", "in": "query", "required": true, "description": "counterparty/party name to screen", "schema": { "type": "string" } }, { "name": "party", "in": "query", "required": true, "description": "counterparty name (alias of name)", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": true, "description": "destination country", "schema": { "type": "string" } }, { "name": "destination", "in": "query", "required": true, "description": "destination country (alias of country)", "schema": { "type": "string" } }, { "name": "commodity", "in": "query", "required": true, "description": "commodity or topic for export-control check", "schema": { "type": "string" } } ] } }, "/v1/realestate/underwrite": { "get": { "operationId": "v1_realestate_underwrite", "summary": "Property underwriting (bundle) — One call: STANDARD/SURCHARGE/REFER hazard-underwriting posture for a US address, fusing FEMA flood zone, USGS seismic history, and active NWS weather alerts.", "tags": [ "realestate" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.400000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "posture": { "type": "string" } } }, "example": { "posture": "STANDARD" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "address", "in": "query", "required": true, "description": "US property address (or use lat+lon)", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": true, "description": "latitude", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude", "schema": { "type": "string" } } ] } }, "/v1/ip/intelligence": { "get": { "operationId": "v1_ip_intelligence", "summary": "IP intelligence report (bundle) — One call: ALLOW/REVIEW/BLOCK connection-risk verdict + 0-100 score for an IP — fuses RDAP ownership/registry, reverse-DNS (PTR), abuse-feed & first-party honeypot threat reputation, and datacenter/residential classification.", "tags": [ "ip" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "verdict": "ALLOW", "riskScore": 0 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "ip", "in": "query", "required": true, "description": "IPv4 or IPv6 address to assess", "schema": { "type": "string" } } ] } }, "/v1/url/safety": { "get": { "operationId": "v1_url_safety", "summary": "URL / link safety check (bundle) — One call: SAFE/CAUTION/DANGER verdict for a URL — checks reachability & redirects, destination domain age, and hosting-IP reputation before an agent follows the link.", "tags": [ "url" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "verdict": "SAFE", "riskScore": 0 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "url", "in": "query", "required": true, "description": "http(s) URL to check", "schema": { "type": "string" } } ] } }, "/v1/email/sender-trust": { "get": { "operationId": "v1_email_sender_trust", "summary": "Email sender trust (bundle) — One call: TRUST / REVIEW / REJECT verdict + 0-100 risk for an email address or sending domain — fuses SPF/DMARC enforcement, domain age (RDAP), and the sending domain's hosting-IP threat reputation. For agents filtering inbound mail, leads and senders before acting.", "tags": [ "email" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "verdict": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "domain": "example.com", "verdict": "REVIEW", "riskScore": 35 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "email", "in": "query", "required": true, "description": "email address to assess (or use domain)", "schema": { "type": "string" } }, { "name": "domain", "in": "query", "required": true, "description": "sending domain (alternative to email)", "schema": { "type": "string" } } ] } }, "/v1/domain/dns-hygiene": { "get": { "operationId": "v1_domain_dns_hygiene", "summary": "DNS / email security posture (bundle) — One call: PASS / WEAK / FAIL security-posture audit for a domain — checks SPF, DMARC policy strength, MX, CAA, DNSSEC and nameserver redundancy, with a prioritized fix list. For security, deliverability and compliance automation.", "tags": [ "domain" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.040000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "verdict": { "type": "string" }, "checks": { "type": "object" } } }, "example": { "domain": "example.com", "verdict": "WEAK", "checks": { "spf": true, "dmarc": "none", "dnssec": false, "caa": false } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "domain to audit", "schema": { "type": "string" } } ] } }, "/v1/security/phishing-triage": { "get": { "operationId": "v1_security_phishing_triage", "summary": "Phishing triage (bundle) — One call: SAFE / SUSPICIOUS / PHISHING verdict + 0-100 risk for an inbound message — fuses sender-domain authentication (SPF/DMARC + age + hosting), destination-link safety (redirects, domain age, hosting reputation), and optional source-IP reputation. For agents screening", "tags": [ "security" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "verdict": "SUSPICIOUS", "riskScore": 40 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "email", "in": "query", "required": true, "description": "sender email address (or sender)", "schema": { "type": "string" } }, { "name": "url", "in": "query", "required": true, "description": "link/URL found in the message (or link)", "schema": { "type": "string" } }, { "name": "ip", "in": "query", "required": false, "description": "optional source IPv4", "schema": { "type": "string" } } ] } }, "/v1/econ/country-snapshot": { "get": { "operationId": "v1_econ_country_snapshot", "summary": "Country economic snapshot (bundle) — One call: a country's key economic indicators fused into one response — GDP, GDP per capita, GDP growth, inflation, population and unemployment (latest available). Source: World Bank Open Data. Pass an ISO country code.", "tags": [ "econ" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "country": { "type": "string" }, "indicators": { "type": "object" } } }, "example": { "country": "United States", "indicators": { "gdpUSD": { "value": 0, "year": 2024 } } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO2 or ISO3 country code, e.g. US or USA", "schema": { "type": "string" } } ] } }, "/v1/health/drug-safety-compare": { "get": { "operationId": "v1_health_drug_safety_compare", "summary": "Drug safety compare (bundle) — One call: side-by-side FDA label safety for two drugs — brand/generic identity, indications and warnings for each, flagged if they share a generic. Reference data from openFDA. NOT medical advice or a drug-interaction analysis.", "tags": [ "health" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.060000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "a": { "type": "object" }, "b": { "type": "object" } } }, "example": { "a": { "generic": "ibuprofen" }, "b": { "generic": "naproxen" } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "a", "in": "query", "required": true, "description": "first drug (brand or generic)", "schema": { "type": "string" } }, { "name": "b", "in": "query", "required": true, "description": "second drug (brand or generic)", "schema": { "type": "string" } } ] } }, "/v1/security/domain-threat-report": { "get": { "operationId": "v1_security_domain_threat_report", "summary": "Domain threat report (bundle) — One call: HEALTHY / NEEDS ATTENTION / HIGH RISK security posture for a domain — fuses DNS & email hardening (SPF, DMARC strength, DNSSEC, CAA, nameservers) with sender authentication, domain age and hosting-IP reputation, into one grade plus a consolidated findings & ", "tags": [ "security" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "grade": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "domain": "example.com", "grade": "NEEDS ATTENTION", "riskScore": 30 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "domain to assess", "schema": { "type": "string" } } ] } }, "/v1/geo/severe-weather-scan": { "get": { "operationId": "v1_geo_severe_weather_scan", "summary": "Severe weather scan (bundle) — One call: active NWS watches/warnings/advisories for a US state or point, summarized by severity with a CLEAR / MONITOR / CAUTION / AVOID operations verdict and the highest active event. For logistics, field ops and travel automation. Pass state (e.g. TN) or lat+lon.", "tags": [ "geo" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" }, "activeAlerts": { "type": "number" }, "highestSeverity": { "type": "string" } } }, "example": { "verdict": "MONITOR", "activeAlerts": 2, "highestSeverity": "Moderate" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "state", "in": "query", "required": true, "description": "US state code, e.g. TN", "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": true, "description": "latitude (alternative to state)", "schema": { "type": "string" } }, { "name": "lon", "in": "query", "required": true, "description": "longitude (alternative to state)", "schema": { "type": "string" } } ] } }, "/v1/econ/compare-countries": { "get": { "operationId": "v1_econ_compare_countries", "summary": "Compare countries (bundle) — One call: two countries' key economics side by side — GDP, GDP per capita, GDP growth, inflation and population, each with which country's figure is higher. Source: World Bank Open Data. Pass two ISO country codes.", "tags": [ "econ" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.040000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "a": { "type": "object" }, "b": { "type": "object" }, "comparison": { "type": "object" } } }, "example": { "a": { "iso": "US" }, "b": { "iso": "CN" }, "comparison": {} } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "a", "in": "query", "required": true, "description": "first ISO country code, e.g. US", "schema": { "type": "string" } }, { "name": "b", "in": "query", "required": true, "description": "second ISO country code, e.g. CN", "schema": { "type": "string" } } ] } }, "/v1/security/threat-lookup": { "get": { "operationId": "v1_security_threat_lookup", "summary": "Unified threat lookup (bundle) — One call, any indicator: pass an IP, a domain, or a URL and it auto-detects the type, routes to the right analysis (IP intelligence / domain threat report / URL safety) and returns a normalized CLEAR / SUSPICIOUS / MALICIOUS verdict + risk score + full details. The s", "tags": [ "security" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "indicator": { "type": "string" }, "type": { "type": "string" }, "normalizedVerdict": { "type": "string" } } }, "example": { "indicator": "1.2.3.4", "type": "ip", "normalizedVerdict": "CLEAR" } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "indicator", "in": "query", "required": true, "description": "an IP, domain, or URL to check", "schema": { "type": "string" } } ] } }, "/v1/security/bulk-ip-screen": { "get": { "operationId": "v1_security_bulk_ip_screen", "summary": "Bulk IP screen (bundle) — One call: screen up to 10 IPs at once for reputation/risk, each with ALLOW / REVIEW / BLOCK + score, plus an overall summary (counts and worst verdict). For firewall rules, log triage and connection batches.", "tags": [ "security" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.080000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "screened": { "type": "number" }, "summary": { "type": "object" } } }, "example": { "screened": 3, "summary": { "ALLOW": 2, "BLOCK": 1, "overall": "BLOCK" } } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "ips", "in": "query", "required": true, "description": "comma-separated IPv4/IPv6 list, up to 10", "schema": { "type": "string" } } ] } }, "/v1/security/inbound-request-screen": { "get": { "operationId": "v1_security_inbound_request_screen", "summary": "Inbound request screen (bundle) — One call: ALLOW / CHALLENGE / BLOCK verdict for an inbound HTTP request — fuses source-IP reputation, referer/link safety, and a user-agent bot/scanner heuristic. For WAF, gateway and bot-defense automation.", "tags": [ "security" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "verdict": { "type": "string" }, "riskScore": { "type": "number" } } }, "example": { "verdict": "CHALLENGE", "riskScore": 35 } } } }, "402": { "description": "Payment Required" } }, "parameters": [ { "name": "ip", "in": "query", "required": true, "description": "source IPv4/IPv6 (required)", "schema": { "type": "string" } }, { "name": "url", "in": "query", "required": false, "description": "referer or link in the request (optional)", "schema": { "type": "string" } }, { "name": "ua", "in": "query", "required": false, "description": "user-agent string (optional)", "schema": { "type": "string" } } ] } } } }