{"openapi":"3.1.0","info":{"title":"Degenscan Intel","version":"0.6.1","description":"Cross-asset market event intelligence for AI trading agents. Priced routes return HTTP 402 with x402 v2 payment requirements (USDC on Base) unless X-API-KEY is sent or the free trial header X-Free-Trial: 1 is present (100 calls/day/IP). Information and analytics only — not investment advice.","contact":{"name":"Marbella Collins LLC","email":"contact@degenscan.io"},"license":{"name":"MIT"}},"servers":[{"url":"https://intel.degenscan.io"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-KEY"},"freeTrial":{"type":"apiKey","in":"header","name":"X-Free-Trial","description":"Send the value 1 for 100 free calls/day per IP."},"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment payload (base64). Obtain requirements from the 402 response header PAYMENT-REQUIRED."}}},"paths":{"/v1/events":{"get":{"summary":"Events since t that touch a universe, scored into per-asset impacts","x-price-usd":0.005,"parameters":[{"name":"since","in":"query","schema":{"type":"string","default":"4h"},"description":"30m | 4h | 2d | ISO-8601 (past values = backtest)"},{"name":"universe","in":"query","schema":{"type":"string"},"description":"comma-separated asset ids, e.g. NVDA,BTC,CL"},{"name":"kinds","in":"query","schema":{"type":"string"}},{"name":"min_severity","in":"query","schema":{"type":"number"}},{"name":"min_confidence","in":"query","schema":{"type":"number"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"events[] with impacts[]"},"402":{"description":"x402 payment required (header PAYMENT-REQUIRED)"}}}},"/v1/impact/{asset_id}":{"get":{"summary":"Net directional pressure on one asset + source events","x-price-usd":0.003,"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string","default":"24h"}}],"responses":{"200":{"description":"bias, n_events, drivers, events"},"402":{"description":"payment required"}}}},"/v1/graph/{asset_id}":{"get":{"summary":"Exposure sub-graph around an asset","x-price-usd":0.002,"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"depth","in":"query","schema":{"type":"integer","default":2,"minimum":1,"maximum":3}}],"responses":{"200":{"description":"nodes, edges, facilities"},"402":{"description":"payment required"}}}},"/v1/regime":{"get":{"summary":"Venues open, 24h pressure ranking, top events, prediction markets","x-price-usd":0.01,"responses":{"200":{"description":"snapshot"},"402":{"description":"payment required"}}}},"/v1/explain/{event_id}":{"get":{"summary":"Rationale for one event's impacts","x-price-usd":0.02,"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"explanation"},"402":{"description":"payment required"}}}},"/v1/polymarket/{market}":{"get":{"summary":"Evidence pack for one Polymarket market: current odds + primary-source events in our feed that bear on the question","x-price-usd":0.01,"parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string"},"description":"market id, slug, or question text"},{"name":"since","in":"query","schema":{"type":"string","default":"48h"}},{"name":"limit","in":"query","schema":{"type":"integer","default":15}}],"responses":{"200":{"description":"market, query_terms, related[]"},"402":{"description":"payment required"}}}},"/v1/pulse":{"get":{"summary":"Last-hour event counts by class, top-3 severe events, venues open — cheapest probe","x-price-usd":0.001,"responses":{"200":{"description":"pulse"},"402":{"description":"payment required"}}}},"/v1/derivs/{symbol}":{"get":{"summary":"Perp microstructure for one coin (Hyperliquid public API): funding, predicted funding by venue, open interest, premium, 24h volume, flags + our event pressure","x-price-usd":0.003,"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"BTC, ETH, SOL, HYPE…"},{"name":"since","in":"query","schema":{"type":"string","default":"24h"}}],"responses":{"200":{"description":"price, funding, open_interest, volume_24h_usd, flags, event_pressure"},"402":{"description":"payment required"}}}},"/v1/news/{ticker}":{"get":{"summary":"Headlines touching one asset with tier, corroboration and heuristic sentiment","x-price-usd":0.002,"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string","default":"24h"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25}}],"responses":{"200":{"description":"items[], sentiment_avg"},"402":{"description":"payment required"}}}},"/v1/filings/{ticker}":{"get":{"summary":"SEC EDGAR filings touching one issuer (8-K, Form 4, 13D/G, S-1)","x-price-usd":0.002,"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string","default":"7d"}},{"name":"forms","in":"query","schema":{"type":"string"},"description":"comma-separated: 8k,insider,activist,offering,bankruptcy"}],"responses":{"200":{"description":"filings[]"},"402":{"description":"payment required"}}}},"/v1/calendar":{"get":{"summary":"Upcoming US macro prints, FOMC, auctions and earnings (N days)","x-price-usd":0.002,"parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":7}},{"name":"types","in":"query","schema":{"type":"string"},"description":"comma-separated: macro,fomc,earnings,auctions"},{"name":"universe","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"items[]"},"402":{"description":"payment required"}}}},"/v1/brief/{asset_id}":{"get":{"summary":"Premium one-call pre-trade briefing for an asset (pressure, headlines, filings, exposure, prediction market, catalysts, venues)","x-price-usd":0.1,"parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string","default":"24h"}}],"responses":{"200":{"description":"brief"},"402":{"description":"payment required"}}}},"/v1/universe":{"get":{"summary":"Asset universe (free)","responses":{"200":{"description":"assets[]"}}}},"/v1/sources":{"get":{"summary":"Connector health (free)","responses":{"200":{"description":"sources[]"}}}},"/v1/metrics":{"get":{"summary":"Public weekly usage metrics (free)","responses":{"200":{"description":"weeks[]"}}}},"/v1/keys/x402/{pack}":{"post":{"summary":"Buy a prepaid API key with USDC (x402) — no human, no card","parameters":[{"name":"pack","in":"path","required":true,"schema":{"type":"string","enum":["pack_1k","pack_10k","pack_100k"]}}],"responses":{"200":{"description":"{ api_key, calls }"},"402":{"description":"x402 payment required: $5 / $40 / $300"}}}},"/v1/keys/me":{"get":{"summary":"Remaining budget for X-API-KEY (free)","security":[{"apiKey":[]}],"responses":{"200":{"description":"budget, used, remaining"}}}},"/v1/plans":{"get":{"summary":"Card subscriptions for human operators (Stripe)","responses":{"200":{"description":"plans[]"}}}},"/mcp":{"post":{"summary":"MCP streamable HTTP endpoint (tools: events_since, impact_for, exposure_graph, regime_snapshot, explain, universe, sources_status)","responses":{"200":{"description":"JSON-RPC / SSE"},"402":{"description":"payment required for priced tools after quota"}}}}}}