{"openapi":"3.1.0","info":{"title":"RogueIQ Primary-Source Finance Feed","version":"0.1.0","description":"Headlines, links and verified breakdowns straight from official US sources (Fed, BLS, BEA, Treasury, Treasury OFAC, SEC, EDGAR, CFTC, DOJ, Nasdaq halts). Every response carries as_of, source_url and disclaimer. Educational information from official sources, not financial advice."},"servers":[{"url":"https://rogueiq.com/wire"}],"components":{"schemas":{"Item":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"source_name":{"type":"string"},"title":{"type":"string"},"excerpt":{"type":"string"},"source_url":{"type":"string"},"source_feed":{"type":["string","null"]},"published_at":{"type":"string"},"fetched_at":{"type":"string"},"topics":{"type":"array","items":{"type":"string"}},"importance":{"type":"integer","description":"0-3; 3 = market-moving scheduled release"},"ticker":{"type":["string","null"]}},"required":["id","source","source_name","title","excerpt","source_url","source_feed","published_at","fetched_at","topics","importance","ticker"]},"Error":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"error":{"type":"string"}},"required":["as_of","source_url","disclaimer","error"]},"Breakdown":{"type":"object","properties":{"item_id":{"type":"string"},"what_it_says":{"type":"string"},"whats_new_vs_last":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"source_table_url":{"type":"string"},"quoted_lines":{"type":"array","items":{"type":"string"}},"engine":{"type":"string","description":"\"deterministic-fallback\" or \"llm:<provider>\""},"numbers_verified":{"type":"boolean","description":"true = every number in the output appears in the official source text"},"generated_at":{"type":"string"}},"required":["item_id","what_it_says","whats_new_vs_last","caveats","source_table_url","quoted_lines","engine","numbers_verified","generated_at"]},"CalendarEvent":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"agency":{"type":"string"},"kind":{"type":"string"},"scheduled_at":{"type":"string"},"source_url":{"type":"string"},"heads_up":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"label":{"type":"string"}},"required":["at","label"]}}},"required":["id","title","agency","kind","scheduled_at","source_url","heads_up"]}},"parameters":{}},"paths":{"/v1/items":{"get":{"tags":["feed"],"summary":"Latest primary-source items (newest first)","parameters":[{"schema":{"type":"string","description":"Comma list: fed,bls,bea,ofac,sec,edgar,cftc,doj,halts"},"required":false,"description":"Comma list: fed,bls,bea,ofac,sec,edgar,cftc,doj,halts","name":"source","in":"query"},{"schema":{"type":"string","description":"inflation, jobs, rates, growth, banking, enforcement, sanctions, crypto, filings, earnings, halts, rulemaking"},"required":false,"description":"inflation, jobs, rates, growth, banking, enforcement, sanctions, crypto, filings, earnings, halts, rulemaking","name":"topic","in":"query"},{"schema":{"type":"string"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"ISO time; only items published at/after"},"required":false,"description":"ISO time; only items published at/after","name":"since","in":"query"},{"schema":{"type":"string","description":"ISO time cursor for paging (use next_before)"},"required":false,"description":"ISO time cursor for paging (use next_before)","name":"before","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":3},"required":false,"name":"min_importance","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Items","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"count":{"type":"number"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"next_before":{"type":["string","null"]}},"required":["as_of","source_url","disclaimer","count","items","next_before"]}}}}}}},"/v1/items/{id}":{"get":{"tags":["feed"],"summary":"One item","parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Item","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"item":{"$ref":"#/components/schemas/Item"},"has_breakdown":{"type":"boolean"}},"required":["as_of","source_url","disclaimer","item","has_breakdown"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/breakdown/{id}":{"get":{"tags":["breakdown"],"summary":"Deep breakdown traced to the official report","description":"What the report says, what changed vs the previous release, caveats, the exact table link and verbatim quoted lines. Numbers are verified against the source text.","parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","enum":["0","1"]},"required":false,"name":"refresh","in":"query"}],"responses":{"200":{"description":"Breakdown","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"item":{"$ref":"#/components/schemas/Item"},"breakdown":{"$ref":"#/components/schemas/Breakdown"}},"required":["as_of","source_url","disclaimer","item","breakdown"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/calendar":{"get":{"tags":["calendar"],"summary":"Upcoming scheduled releases (CPI, jobs, PCE, GDP, FOMC, PPI...)","parameters":[{"schema":{"type":"string"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string"},"required":false,"name":"to","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":400},"required":false,"name":"days","in":"query"},{"schema":{"type":"string","description":"Comma list: cpi,jobs,pce,gdp,fomc,ppi,jolts,other"},"required":false,"description":"Comma list: cpi,jobs,pce,gdp,fomc,ppi,jolts,other","name":"kind","in":"query"}],"responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"count":{"type":"number"},"events":{"type":"array","items":{"$ref":"#/components/schemas/CalendarEvent"}},"sources":{"type":"array","items":{"type":"string"}}},"required":["as_of","source_url","disclaimer","count","events","sources"]}}}}}}},"/v1/calendar/heads-up":{"get":{"tags":["calendar"],"summary":"Heads-up alerts due in the next N hours (24h / 1h before each release)","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":336},"required":false,"name":"hours","in":"query"}],"responses":{"200":{"description":"Alerts","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"count":{"type":"number"},"alerts":{"type":"array","items":{"type":"object","properties":{"event_id":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string"},"scheduled_at":{"type":"string"},"heads_up_at":{"type":"string"},"label":{"type":"string"},"source_url":{"type":"string"}},"required":["event_id","title","kind","scheduled_at","heads_up_at","label","source_url"]}}},"required":["as_of","source_url","disclaimer","count","alerts"]}}}}}}},"/v1/sources":{"get":{"tags":["meta"],"summary":"Sources, live status and counts","responses":{"200":{"description":"Sources","content":{"application/json":{"schema":{"type":"object","properties":{"as_of":{"type":"string","example":"2026-10-19T18:42:00.000Z"},"source_url":{"type":["string","null"],"description":"Official source page. For lists spanning several sources this is null and each item carries its own source_url."},"disclaimer":{"type":"string","enum":["Educational information from official sources, not financial advice"]},"sources":{"type":"array","items":{}},"dropped":{"type":"array","items":{}}},"required":["as_of","source_url","disclaimer","sources","dropped"]}}}}}}}},"webhooks":{}}