{"openapi":"3.1.0","info":{"title":"Tradar Public API","version":"1.0.0","description":"Public Tradar endpoints for AI assistants. AI-classified market catalysts from 50+ primary federal sources, with watchlist tickers, sectors, and impact/urgency/trust scores. No auth, rate-limited per IP.","contact":{"name":"Tradar Support","url":"https://trytradar.com","email":"support@trytradar.com"},"license":{"name":"Proprietary","url":"https://trytradar.com/terms"}},"servers":[{"url":"https://trytradar.com","description":"Production"}],"paths":{"/api/public/events":{"get":{"operationId":"listEvents","summary":"List recent market-moving events","description":"Returns up to 100 recently-classified market-moving events from the last 14 days, sorted by timestamp descending. Filterable by ticker, category, and minimum impact score. Each event includes affected tickers, sectors, urgency/impact/trust scores, source, and a Tradar URL.","parameters":[{"name":"ticker","in":"query","description":"Filter to events affecting this ticker (case-insensitive). Examples: OKLO, TSLA, NVDA, ASTS, CMPS.","required":false,"schema":{"type":"string"},"example":"OKLO"},{"name":"category","in":"query","description":"Filter to a single event category. Common values: company_market_moving, earnings, fda_action, mergers_acquisitions, contract_award, geopolitical_conflict, policy_tariffs_sanctions, central_bank_decision, politician_trades.","required":false,"schema":{"type":"string"}},{"name":"minImpact","in":"query","description":"Minimum impactScore on a 0-100 scale. Default 50 (tradeable-catalyst threshold). Use 70 for high-impact only.","required":false,"schema":{"type":"integer","minimum":0,"maximum":100,"default":50}},{"name":"limit","in":"query","description":"Number of events to return (1-100). Default 25.","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"List of recent events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}}}}},"/api/public/event/{id}":{"get":{"operationId":"getEvent","summary":"Get full detail for a single event","description":"Deep narrative detail on one event: whyItMatters, whatToWatch, invalidators, traderTakeaway (actionable summary), keyDetails (structured facts), marketImpact (asset-level directional read).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full event detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventDetail"}}}},"404":{"description":"Event not found"}}}}},"components":{"schemas":{"Event":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"affectedAssets":{"type":"array","items":{"type":"string"},"description":"Ticker symbols affected by this event (uppercase)."},"sectors":{"type":"array","items":{"type":"string"},"description":"Sector tags (e.g. nuclear, semiconductors, biomed, quantum, defense_aerospace, energy, ai)."},"urgencyScore":{"type":"integer","description":"0-100; how time-sensitive the event is. 50+ = tradeable today."},"impactScore":{"type":"integer","description":"0-100; how large the expected market move is. 50+ = tradeable."},"trustScore":{"type":"integer","description":"0-100; confidence in the source and corroboration. Federal sources score 95+."},"primarySource":{"type":"string","nullable":true,"description":"Originating source name, e.g. 'SEC-API.io — Watchlist Filings', 'openFDA — Drug Recalls', 'NRC — Daily Event Reports'."},"corroborationCount":{"type":"integer","description":"Number of additional sources that have confirmed this event."},"timestamp":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri","description":"Canonical Tradar event detail URL."}}},"EventList":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"generatedAt":{"type":"string","format":"date-time"},"count":{"type":"integer"}}},"EventDetail":{"allOf":[{"$ref":"#/components/schemas/Event"},{"type":"object","properties":{"headline":{"type":"string","nullable":true},"directionalBias":{"type":"string","nullable":true},"impactHorizon":{"type":"string","nullable":true},"whyItMatters":{"type":"string","nullable":true},"whatToWatch":{"type":"string","nullable":true},"invalidators":{"type":"array","items":{"type":"string"}},"keyDetails":{"type":"object","additionalProperties":true},"marketImpact":{"type":"object","additionalProperties":true},"traderTakeaway":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"status":{"type":"string"}}}]}}}}