{"openapi":"3.1.0","info":{"title":"SNTL DePIN RF Telemetry & Yield Loss Oracle","version":"4.0.0","description":"Deterministic machine-to-machine intelligence oracle for DePIN infrastructure. Tiered pay-per-record access ($0.01 - $1.00 USDC) via x402 (Solana mainnet). Strict LIMIT 1 enforced on all paid queries. Free surfaces: /api/v2/stats, /api/v2/ledger/{wallet}, /health.","x-guidance":"Discover endpoints in this spec. Paid routes return HTTP 402 with x402 payment requirements (exact scheme, USDC on Solana mainnet) — pay and retry to receive data. GET menu routes accept ?limit (capped at 1). POST /api/v2/query runs a single read-only SELECT (LIMIT 1). Free routes need no payment.","contact":{"email":"slcutpc@gmail.com"}},"servers":[{"url":"https://pop-os.tail08831d.ts.net"}],"paths":{"/api/v2/rf/violations":{"get":{"operationId":"rf-physics-violations","summary":"RF Physics Violations","description":"FSPL vs RSSI deltas, deterministic signal spoofing detection. $1.00 USDC/call.","tags":["rf-telemetry"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]}}},"/api/v2/rf/phantoms":{"get":{"operationId":"phantom-devices","summary":"Phantom Devices","description":"Entity registrations lacking H3 geospatial coordinates. $1.00 USDC/call.","tags":["rf-telemetry"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]}}},"/api/v2/threats/treasury":{"get":{"operationId":"treasury-anomalies","summary":"Treasury Anomalies","description":"Unscheduled >100k token movements. $1.00 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]}}},"/api/v2/rf/hivemapper":{"get":{"operationId":"hivemapper-anomalies","summary":"Hivemapper Anomalies","description":"Spatial/region physics violations. $1.00 USDC/call.","tags":["rf-telemetry"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]}}},"/api/v2/threats/critical":{"get":{"operationId":"threats-critical","summary":"Critical threats","description":"Enriched DePIN events classified CRITICAL threat. $1.00 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]}}},"/api/v2/threats/high":{"get":{"operationId":"threats-high","summary":"High threats","description":"Enriched events classified HIGH threat. $0.75 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.750000"},"protocols":[{"x402":{}}]}}},"/api/v2/chronicle":{"get":{"operationId":"world-state-chronicle","summary":"World-state chronicle","description":"Time / space / power dimensional event chains. $0.75 USDC/call.","tags":["forensic"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.750000"},"protocols":[{"x402":{}}]}}},"/api/v2/geo":{"get":{"operationId":"geo-hotspots","summary":"Geo hotspots (H3)","description":"H3 geospatial hotspot resolution. $0.75 USDC/call.","tags":["forensic"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.750000"},"protocols":[{"x402":{}}]}}},"/api/v2/threats/medium":{"get":{"operationId":"threats-medium","summary":"Medium threats","description":"Enriched events classified MEDIUM threat. $0.50 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/architects":{"get":{"operationId":"architects","summary":"Architects","description":"Classified network architect wallets. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/target":{"get":{"operationId":"target-wallets","summary":"Target wallets","description":"Scored, invite-tracked target wallet pool. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/hvt-anomaly":{"get":{"operationId":"hvt-anomaly","summary":"HVT anomaly pool","description":"High-value-target anomaly wallets. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/pool":{"get":{"operationId":"wallet-pool","summary":"Wallet pool","description":"Generic scored wallet pool. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/connected":{"get":{"operationId":"connected","summary":"Connected (unpaid)","description":"Authenticated humans who hit the paywall, unpaid. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/blink-ready":{"get":{"operationId":"blink-ready","summary":"Blink-ready wallets","description":"Wallets flagged blink-ready for action. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/critical":{"get":{"operationId":"anomaly-critical-wallets","summary":"Critical-anomaly wallets","description":"Wallets behind critical-tier events. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/medium":{"get":{"operationId":"anomaly-medium-wallets","summary":"Medium-anomaly wallets","description":"Wallets behind medium-tier events. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/wallets/paid":{"get":{"operationId":"paid","summary":"Paid wallets","description":"Converted paying wallets. $0.50 USDC/call.","tags":["wallet-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/pyramid/tier-1":{"get":{"operationId":"tier-1","summary":"Tier 1 (6–7 lists)","description":"Maximum-signal wallets appearing on 6+ independent lists. $0.50 USDC/call.","tags":["engagement"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/pyramid/tier-2":{"get":{"operationId":"tier-2","summary":"Tier 2 (4–5 lists)","description":"Wallets appearing on 4–5 independent lists. $0.50 USDC/call.","tags":["engagement"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/pyramid/tier-3":{"get":{"operationId":"tier-3","summary":"Tier 3 (2–3 lists)","description":"Wallets appearing on 2–3 independent lists. $0.50 USDC/call.","tags":["engagement"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.500000"},"protocols":[{"x402":{}}]}}},"/api/v2/threats/low":{"get":{"operationId":"threats-low","summary":"Low threats","description":"Enriched events classified LOW threat. $0.01 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v2/threats/pending":{"get":{"operationId":"pending-loops","summary":"Pending open-loops","description":"Events where threat assessment started but never resolved. $0.01 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v2/anomalies":{"get":{"operationId":"anomalies","summary":"Top anomalies","description":"Highest anomaly-score enriched events. $0.01 USDC/call.","tags":["threat-intel"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v2/escalation":{"get":{"operationId":"escalation-ledger","summary":"LLM escalation ledger","description":"Tiered LLM verdict trail (SLM 0.5B -> SLM 3.5B -> LLM). $0.01 USDC/call.","tags":["forensic"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v2/dlq":{"get":{"operationId":"unparsed-dlq","summary":"Unparsed DLQ","description":"Failure-mode intelligence / dead-letter queue. $0.01 USDC/call.","tags":["forensic"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v2/stats":{"get":{"operationId":"stats","summary":"Threat distribution","description":"FREE — live counts of enriched events by threat tier.","tags":["meta"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows to return (Strictly enforced to 1 for per-record pricing).","schema":{"type":"integer","minimum":1,"maximum":1,"default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string"},"dataType":{"type":"string"},"rowCount":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["endpoint","rowCount","rows"]}}}}},"security":[]}},"/api/v2/query":{"post":{"operationId":"query-datalake","summary":"Query the DePIN intelligence datalake","description":"Run a read-only SQL SELECT over the enriched datalake (SELECT-only, single statement, LIMIT 1 enforced). Base cost $0.01 USDC/call.","tags":["query"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sql":{"type":"string","description":"A single read-only SELECT with a LIMIT 1 clause."},"params":{"type":"array","items":{},"description":"Optional positional query parameters."}},"required":["sql"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"rowCount":{"type":"integer"}},"required":["rows","rowCount"]}}}},"400":{"description":"Query rejected (not a SELECT, multiple statements, bad LIMIT, or disallowed table)"},"402":{"description":"Payment Required"}}}},"/api/v2/event/{signature}":{"get":{"operationId":"lookup-event","summary":"Look up one enriched event by transaction signature","description":"Fetch a single enriched event object by its transaction signature. $0.01 USDC/call.","tags":["lookup"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"signature","in":"path","required":true,"schema":{"type":"string"},"description":"Solana transaction signature (transaction_id)."}],"responses":{"200":{"description":"The enriched event","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required"},"404":{"description":"Event not found"}}}},"/api/v2/ledger/{wallet}":{"get":{"operationId":"wallet-ledger","summary":"Wallet payment + query history (free transparency surface)","description":"A wallet's payment and query history against the datalake. Free, public, no payment required.","tags":["transparency"],"security":[],"parameters":[{"name":"wallet","in":"path","required":true,"schema":{"type":"string"},"description":"Solana wallet address."}],"responses":{"200":{"description":"Wallet history","content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string"},"total_paid_usdc":{"type":"number"},"payment_count":{"type":"integer"},"query_count":{"type":"integer"},"payments":{"type":"array","items":{"type":"object","additionalProperties":true}},"queries":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["wallet"]}}}}}}},"/health":{"get":{"operationId":"health","summary":"Health check","tags":["meta"],"security":[],"responses":{"200":{"description":"Service healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}}}}