---
name: rogueiq-primary-source-finance-feed
description: Pull finance news straight from official US sources (Federal Reserve, BLS, BEA, Census Bureau, Labor Department, U.S. Treasury: market-moving economic releases only), get verified breakdowns of a release, and see the release calendar. Use when a user wants market-moving news with the original source, not media spin.
---

# RogueIQ primary-source finance feed

Base URL: `https://rogueiq.com/econiq` (free, no auth). OpenAPI: `https://rogueiq.com/econiq/openapi.json`.
Remote MCP (streamable HTTP, read-only, no auth): `https://rogueiq.com/econiq/mcp`. Local MCP: `npm run mcp` (stdio).

Every response includes `as_of`, `source_url` and `disclaimer` ("Educational information from official sources, not financial advice"). Always show the source link and the disclaimer when you pass content to a human.

## How to use it well
1. Ask the user what they cover (e.g. inflation, jobs, Fed, enforcement, crypto) and filter with `topic` / `source`, instead of dumping the whole feed.
2. Poll `GET /v1/items?since=<last as_of>` every few minutes; use `min_importance=2` for only market-moving items.
3. Before a big release, check `GET /v1/calendar/heads-up?hours=24` and prepare.
4. For any item worth posting, call `GET /v1/breakdown/{id}`. Only quote figures that appear in `quoted_lines`; if `numbers_verified` is false, do not use the numbers.
5. Never present this as advice. Link `source_url` (and `source_table_url` for data).

## Sources
- `fed` — Board of Governors of the Federal Reserve System
- `bls` — U.S. Bureau of Labor Statistics
- `bea` — U.S. Bureau of Economic Analysis
- `treasury` — U.S. Department of the Treasury

## BigMoneyIQ (CFTC positioning)
`GET https://rogueiq.com/bigmoneyiq/api/v1/positions` (all markets) or `GET https://rogueiq.com/bigmoneyiq/api/v1/positions/{market}` with market = sp500, nasdaq, ust10y, usd, wti, gold, btc. MCP tool: `get_bigmoneyiq` (optional `market`).
- Weekly net positions (longs minus shorts) from the CFTC Commitments of Traders, futures only, one contract per market picked by CFTC code. Financial markets show asset managers and leveraged funds (hedge funds); WTI and gold show managed money (hedge funds and other speculators).
- Each group has `percentile_since_start` (share of weeks since 2018 at or below this week), `week_change`, `pct_of_oi`, `report_date` (Tuesday as-of) and `release_date` (Friday).
- Always quote the as-of date, the report type and the trader group with a number. Include the `caveats` (Treasury and Bitcoin shorts are largely basis-trade hedges). Positioning describes who is in a trade; never present it as a call on prices, and show the `disclaimer`.

## HyperliquidIQ (preview)
`GET https://rogueiq.com/econiq/v1/hl-tradfi` (all 18 markets; optional `?markets=xyz:AAPL,xyz:GOLD`), `GET /econiq/v1/hl-tradfi/scorecard` (weekend-gap stats and chain status) and `GET /econiq/v1/hl-tradfi/scorecard/log.csv` (full append-only log). MCP tool: `hl_tradfi_snapshot` (optional `markets`, a list or a comma-separated string). Agent notes: https://rogueiq.com/hyperliquidiq/llms.txt
- `GET /econiq/v1/hl/weekend-tape[?compact=1]` · MCP `hl_weekend_tape`: the same 18 markets as a weekend view (move since the last close, funding, open positions).
- `GET /econiq/v1/hl/funding-board?min_oi_usd=10000000&limit=10` · MCP `hl_funding_board`: every market with at least `min_oi_usd` open interest ranked by 24-hour average funding vs its group's baseline; `last_paid_annualized_pct`, `accruing_now_annualized_pct`, 7-day average, `funding_side_24h` tier (flipped tiers use the last settled payment), Binance/Bybit spreads, `new_listing`, `currently_flipped`.
- `GET /econiq/v1/hl/whats-changed[?since=ISO]` · MCP `hl_whats_changed`: open-position jumps (|change| ≥ 10% and ≥ $2M, OI ≥ $5M; `divergence` set when price moved the other way), OI/price divergence, `funding_flips` for every live market (8-hour average vs baseline changed sides; check `funding_flips.health.ok` and `markets_checked`), near-cap markets and listings.
- **Funding: read `funding_avg_24h_annualized_pct` (24-hour mean, with `funding_avg_24h_n_hours`) first.** `funding_1h` / `funding_annualized_pct` are the latest single hour and can spike far above the day's typical rate; do not annualize or headline a single hour.
- Hourly snapshot of stock, index, gold, silver and oil perpetuals listed by the xyz and mkts HIP-3 deployers, read from the public Hyperliquid info API only: `mark_px`, `oracle_px`, `funding_1h`, `funding_annualized_pct`, `open_interest_usd`, `oi_cap_usd`, `volume_24h_usd`.
- `reference` is the last regular-session close for the same instrument: IEX HIST official last trade for single stocks (published T+1, so `gap_vs_reference_pct` stays null with a `reference_pending_note` until it lands), EIA spot (direct from EIA, series RWTC/RBRTE) for oil (`approximate: true`, different instrument). Index perps carry SPY/QQQ as labelled stand-ins and gold/silver carry GLD/SLV; for these use `move_since_last_close_pct` (perp vs its own price at the 4:00 PM ET close) instead of a level gap.
- Chart fields (the page charts use exactly these): `headline_gap_pct` with `headline_basis` and its plain-English `headline_basis_definition`; `comparable_in_ranking` (false for oil vs EIA spot, which the page keeps out of rankings); `reference_lag_days_vs_last_close`; `funding_annualized_pct` (current hourly rate × 24 × 365, arithmetic) plus `funding_avg_24h_annualized_pct`/`funding_avg_24h_n_hours` (the page's funding chart uses this 24h mean, since single-hour rates spike) and `funding_avg_7d_annualized_pct`/`funding_avg_7d_n_hours`; `usual_range` (10th–90th percentile of RogueIQ's hourly snapshots over `window_days`, with `n_obs`, `span_hours`, `first_ts`, `sufficient`). When `sufficient` is false the range values are null and `note` says how much history exists; quote that instead of a range. Top-level `range_basis` and `basis_definitions` describe the method.
- The weekend-gap log measures two moves from Friday's IEX close: to the perp's price at 7:00 PM ET Sunday, and to Monday's first IEX trade at or after 9:30 AM ET. Rows are SHA-256 hash-chained and never edited; stats appear only after 8 weekends.
- Always quote `as_of` and the reference date. This is descriptive market data only. It makes no forecast, is not financial advice, and should never be turned into buy or sell calls.

## Hyperliquid market feed (preview)
Free, read-only Hyperliquid market state for core and HIP-3 perps, cached from Hyperliquid's public info API every minute. Docs: https://rogueiq.com/tools/hyperliquid-market-feed/ · OpenAPI: `https://rogueiq.com/econiq/v1/hl/openapi.json`.
- `GET /econiq/v1/hl/markets[?dex=xyz&include_delisted=1]` · MCP `hl_markets`: every perp (coin id with `dex:` prefix for HIP-3), max leverage, OI cap, delisted flag. Call it first for valid coin ids.
- `GET /econiq/v1/hl/state?coins=BTC,xyz:GOLD` · MCP `hl_market_state`: mark, oracle, mid, premium, `funding_1h` (fraction per hour) and `funding_annualized_pct`, `open_interest` (contracts) and `open_interest_usd` (× oracle), `volume_24h_usd`, `prev_day_px`, `change_24h_pct`.
- `GET /econiq/v1/hl/funding?coin=BTC&window=24h|7d|30d` · MCP `hl_funding_history`: hourly history plus mean/min/max.
- `GET /econiq/v1/hl/oi-history?coin=BTC&window=24h|7d|30d|90d` · MCP `hl_oi_history`: RogueIQ's own 5-minute OI snapshots; `history_start` says when they begin (launch).
- `GET /econiq/v1/hl/liquidations` · MCP `hl_liquidations`: `available:false, planned:"v1.1"` with the reason. Never an estimate.
- Every response has `as_of`, `stale`, `stale_since`, `sources` and `disclaimer`. MCP tools return the same JSON as the REST endpoints.
- Limits: 30 requests/min per IP without a key; 300/min with `Authorization: Bearer rq_live_…`. A bad key counts as no key. 429 responses carry `retry_after` (seconds) and `get_key`.
- Disclaimer: Market data for education. Not financial advice. Not affiliated with Hyperliquid or any HIP-3 deployer.
- What this cannot tell you: where a price goes next; liquidations (v1.1); anything about a single wallet; other exchanges' prices. Quote `as_of` with every number and mention `stale:true` when set.

## Endpoints
### GET /v1/items
Latest primary-source items (newest first)

Coverage: Federal Reserve monetary-policy releases, Chair speeches, testimony and FOMC press conferences; BLS; BEA national releases (GDP, PCE, trade); Census Bureau retail sales, durable goods, housing starts and new home sales; Labor Department weekly jobless claims; Treasury debt and markets releases.

Parameters: `source` — Comma list: fed,bls,bea,census,dol,treasury; `topic` — inflation, jobs, rates, growth, banking, enforcement, sanctions, crypto, filings, earnings, halts, rulemaking; `q`; `since` — ISO time; only items published at/after; `before` — ISO time cursor for paging (use next_before); `min_importance`; `limit`

### GET /v1/items/{id}
One item

Parameters: `id` (required)

### GET /v1/breakdown/{id}
Deep breakdown traced to the official report

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: `id` (required); `refresh`

### GET /v1/calendar
Upcoming scheduled releases (CPI, jobs, PCE, GDP, FOMC, PPI...)

Parameters: `from`; `to`; `days`; `kind` — Comma list: cpi,jobs,pce,gdp,fomc,ppi,jolts,other

### GET /v1/calendar/heads-up
Heads-up alerts due in the next N hours (24h / 1h before each release)

Parameters: `hours`

### GET /v1/sources
Sources, live status and counts

Parameters: none