{"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 (Federal Reserve, BLS, BEA, Census Bureau, Labor Department, U.S. Treasury: market-moving economic releases only, including FOMC press conferences and new home sales). Every response carries as_of, source_url and disclaimer. Educational information from official sources, not financial advice."},"servers":[{"url":"https://rogueiq.com/econiq"}],"components":{"schemas":{"Item":{"type":"object","properties":{"impact":{"type":"string","enum":["high","medium","low"],"description":"How closely markets usually watch this release. Each release type has one fixed category that stays the same whatever the data shows."},"macroiq_step":{"type":["object","null"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"}},"required":["key","label","url"],"description":"The MacroIQ step this release feeds (jobs, inflation, fed, tenyear), with a link to that step"},"prior":{"type":["object","null"],"properties":{"text":{"type":"string"},"value":{"type":"string"},"period":{"type":"string"},"revised_from":{"type":"string"},"revised_to":{"type":"string"},"source_url":{"type":"string"}},"required":["text","value","period","source_url"],"description":"The prior period's figure or revision, as stated in this release. Checked by hand; null when not curated."},"id":{"type":"string"},"source":{"type":"string"},"source_name":{"type":"string"},"title":{"type":"string"},"excerpt":{"type":"string"},"url":{"type":"string","description":"This post on RogueIQ: https://rogueiq.com/econiq/{source}/{release-period}/"},"source_url":{"type":"string","description":"The official release"},"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","url","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"},"key_points":{"type":"array","items":{"type":"string"},"description":"3-5 major points copied from the official text (fewer when the source has fewer)"},"what_it_says":{"type":"string","description":"key_points joined into one string (legacy)"},"whats_new_vs_last":{"type":"string","description":"Deprecated, always empty. Use key_points; no consensus/expectations data is provided"},"caveats":{"type":"array","items":{"type":"string"},"description":"Deprecated, always empty"},"source_table_url":{"type":"string"},"quoted_lines":{"type":"array","items":{"type":"string"}},"engine":{"type":"string","description":"\"deterministic-v2\" 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","key_points","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","description":"The agency's official schedule page"},"release_url":{"type":["string","null"],"description":"Link to the agency's page for this release, when the agency publishes it in advance"},"name":{"type":"string","description":"Plain name, e.g. Jobless claims"},"series":{"type":"string"},"when_et":{"type":"string","example":"Tue Nov 3 · 10:00 AM ET"},"tentative":{"type":"boolean","description":"True until the agency confirms the date"},"impact":{"type":"string","enum":["high","medium","low"],"description":"How closely markets usually watch this release. Each release type has one fixed category that stays the same whatever the data shows."},"macroiq_step":{"type":["object","null"],"properties":{"key":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"}},"required":["key","label","url"],"description":"The MacroIQ step this release feeds (jobs, inflation, fed, tenyear), with a link to that step"},"heads_up":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"label":{"type":"string"}},"required":["at","label"]}},"post_url":{"type":"string","description":"Week view only: the RogueIQ post, for past releases built from posts"},"from_post":{"type":"boolean"}},"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","pattern":"^(high|medium|low)(,(high|medium|low))*$","description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release."},"required":false,"description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release.","name":"impact","in":"query"},{"schema":{"type":"string","description":"Comma list: fed,bls,bea,census,dol,treasury (EconIQ shows market-moving economic sources only)"},"required":false,"description":"Comma list: fed,bls,bea,census,dol,treasury (EconIQ shows market-moving economic sources only)","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","pattern":"^(high|medium|low)(,(high|medium|low))*$","description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release."},"required":false,"description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release.","name":"impact","in":"query"},{"schema":{"type":"string","pattern":"^(claims|retail|durable|starts|newhome|ism-mfg|ism-svc|umich|fomc-minutes|presconf|fomc|cpi|ppi|eci|jobs|jolts|ximpim|prod|realearn|trade|gdp-county|gdp|pce|tic|other)(,(claims|retail|durable|starts|newhome|ism-mfg|ism-svc|umich|fomc-minutes|presconf|fomc|cpi|ppi|eci|jobs|jolts|ximpim|prod|realearn|trade|gdp-county|gdp|pce|tic|other))*$","description":"Comma list, e.g. cpi,jobs,pce,gdp,fomc,ppi,jolts,claims,retail,trade,prod,realearn,ximpim,gdp-county,eci,other"},"required":false,"description":"Comma list, e.g. cpi,jobs,pce,gdp,fomc,ppi,jolts,claims,retail,trade,prod,realearn,ximpim,gdp-county,eci,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). Default: next 7 days (168 h)","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":336,"description":"Window in hours (default 168 = 7 days)"},"required":false,"description":"Window in hours (default 168 = 7 days)","name":"hours","in":"query"},{"schema":{"type":"string","pattern":"^(high|medium|low)(,(high|medium|low))*$","description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release."},"required":false,"description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release.","name":"impact","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/week":{"get":{"tags":["calendar"],"summary":"One week, Monday to Sunday by US Eastern calendar days: scheduled releases plus the posts published that week","parameters":[{"schema":{"type":"string","description":"Any day in the week, as YYYY-MM-DD (defaults to today in US Eastern time)","example":"2026-11-02"},"required":false,"description":"Any day in the week, as YYYY-MM-DD (defaults to today in US Eastern time)","name":"start","in":"query"},{"schema":{"type":"string","pattern":"^(high|medium|low)(,(high|medium|low))*$","description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release."},"required":false,"description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release.","name":"impact","in":"query"},{"schema":{"type":"string","pattern":"^(claims|retail|durable|starts|newhome|ism-mfg|ism-svc|umich|fomc-minutes|presconf|fomc|cpi|ppi|eci|jobs|jolts|ximpim|prod|realearn|trade|gdp-county|gdp|pce|tic|other)(,(claims|retail|durable|starts|newhome|ism-mfg|ism-svc|umich|fomc-minutes|presconf|fomc|cpi|ppi|eci|jobs|jolts|ximpim|prod|realearn|trade|gdp-county|gdp|pce|tic|other))*$","description":"Comma list of kinds, e.g. eci or gdp,pce. Matches the event kind or series; also filters recent posts"},"required":false,"description":"Comma list of kinds, e.g. eci or gdp,pce. Matches the event kind or series; also filters recent posts","name":"kind","in":"query"}],"responses":{"200":{"description":"Week","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"]},"week_start":{"type":"string"},"week_end":{"type":"string"},"tz":{"type":"string"},"count":{"type":"number"},"events":{"type":"array","items":{"$ref":"#/components/schemas/CalendarEvent"}},"recent":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}},"required":["as_of","source_url","disclaimer","week_start","week_end","tz","count","events","recent"]}}}},"400":{"description":"Bad start date","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/calendar.ics":{"get":{"tags":["calendar"],"summary":"Release calendar for the next 60 days as an iCalendar (.ics) file. Subscribe from Google, Apple or Outlook Calendar.","parameters":[{"schema":{"type":"string","pattern":"^(high|medium|low)(,(high|medium|low))*$","description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release."},"required":false,"description":"Filter by impact: high, medium or low. You can list more than one with commas. Impact is based on how closely markets usually watch the release.","name":"impact","in":"query"}],"responses":{"200":{"description":"iCalendar feed","content":{"text/calendar":{"schema":{"type":"string"}}}}}}},"/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"]}}}}}}},"/v1/hl/markets":{"get":{"tags":["hyperliquid"],"summary":"All Hyperliquid perps (core + HIP-3): dex, max leverage, OI cap, delisted flag","parameters":[{"name":"dex","in":"query","required":false,"description":"core, xyz, mkts, para, io …","schema":{"type":"string"}},{"name":"include_delisted","in":"query","required":false,"description":"1 to include delisted markets","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/state":{"get":{"tags":["hyperliquid"],"summary":"Market state: mark, oracle, mid, premium, funding now plus 24h and 7d averages vs the baseline (quote the 24h average), OI (contracts and USD), 24h volume, prevDayPx","parameters":[{"name":"coins","in":"query","required":false,"description":"Comma list, e.g. BTC,ETH,xyz:GOLD; omit for every live market","schema":{"type":"string"}},{"name":"coin","in":"query","required":false,"description":"One coin, e.g. xyz:INTC (same as coins with one entry)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/funding":{"get":{"tags":["hyperliquid"],"summary":"Hourly funding history with mean/min/max","parameters":[{"name":"coin","in":"query","required":true,"description":"e.g. BTC or xyz:GOLD","schema":{"type":"string"}},{"name":"window","in":"query","required":false,"description":"default 24h","schema":{"type":"string","enum":["24h","7d","30d"]}}],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/oi-history":{"get":{"tags":["hyperliquid"],"summary":"RogueIQ's own 5-minute open interest snapshots (history starts at launch)","parameters":[{"name":"coin","in":"query","required":true,"description":"e.g. BTC or xyz:GOLD","schema":{"type":"string"}},{"name":"window","in":"query","required":false,"description":"default 24h; 30d and 90d are hourly","schema":{"type":"string","enum":["24h","7d","30d","90d"]}}],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/funding-board":{"get":{"tags":["hyperliquid"],"summary":"Funding board across the core dex and every HIP-3 dex (OI at least $1M): top and bottom 10 by 24-hour average funding vs baseline, with 7-day average, tier, Hyperliquid's own estimated next-hour rate and the spread vs the Binance and Bybit rates Hyperliquid reports, all hourly-normalized and annualized","parameters":[],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/whats-changed":{"get":{"tags":["hyperliquid"],"summary":"What changed since a time (default 1 hour ago, up to 7 days): OI jumps, OI moving against price, markets at 80% or more of their OI cap, new listings and delistings, funding sign flips. Funding figures default to the 24-hour average","parameters":[{"name":"since","in":"query","required":false,"description":"ISO 8601 time, e.g. 2026-10-30T22:00:00Z","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/weekend-tape":{"get":{"tags":["hyperliquid"],"summary":"Weekend and overnight tape: HIP-3 stock, index, metal and oil perps vs the last U.S. close, last session move, funding tier, OI vs cap and the Monday-open scorecard","parameters":[{"name":"markets","in":"query","required":false,"description":"Comma list, e.g. xyz:SP500,xyz:GOLD; omit for all","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl/liquidations":{"get":{"tags":["hyperliquid"],"summary":"Not available in v1: returns {available:false, planned:'v1.1', reason}","parameters":[],"responses":{"200":{"description":"OK. Every response has as_of, stale, stale_since, sources and disclaimer."},"400":{"description":"Bad parameter: {error, code, docs}"},"404":{"description":"Unknown coin: {error, code, unknown, docs}"},"429":{"description":"Rate limited: {error, code, retry_after, docs, get_key}"}}}},"/v1/hl-tradfi":{"get":{"summary":"HyperliquidIQ snapshot (hourly): perp mark, last-close reference, gap, funding, open interest, usual range","operationId":"hlTradfiSnapshot","parameters":[{"name":"markets","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated coins, e.g. xyz:SP500,xyz:GOLD"}],"responses":{"200":{"description":"Snapshot. Per market: headline_gap_pct + headline_basis + headline_basis_definition, comparable_in_ranking, reference (source, date, approximate), reference_lag_days_vs_last_close, funding_annualized_pct (arithmetic), funding_avg_24h_annualized_pct + funding_avg_24h_n_hours, funding_avg_7d_annualized_pct + funding_avg_7d_n_hours, open_interest_usd, oi_cap_usd, usual_range {basis, window_days, n_obs, span_hours, first_ts, last_ts, sufficient, min_required, funding_annualized_pct{p10,p90}|null, open_interest_usd{p10,p90}|null, note}. Top level: as_of, range_basis, basis_definitions, method, units, sources, disclaimer.","content":{"application/json":{"schema":{"type":"object","required":["as_of","markets","range_basis","basis_definitions","disclaimer"]}}}}}}},"/v1/hl-tradfi/scorecard":{"get":{"summary":"Weekend-gap scorecard stats and hash-chain status","operationId":"hlTradfiScorecard","responses":{"200":{"description":"Scorecard; stats only after 8 weekends"}}}}},"webhooks":{}}