By name: traderhub
description: >
How to pull LOW-FREQUENCY market data from the traderhub CLI: finished
market boards (macro, movers, calendars, global macro, Fed, shipping,
term structure, sector rotation), equity fundamentals (profile, financials,
ratios, estimates, insiders, short interest), ETF drilldowns, FRED/BLS/EIA
macro series, OECD cross-country indicators, IMF PortWatch shipping, and
Deribit crypto curves. Use whenever you need a macro number, a fundamental,
a calendar, or a ready-made board: "what's CPI", "AAPL ratios", "earnings
this week", "which sectors are rotating in", "Suez canal traffic", "Fed
balance sheet". Data is served hub-first (hosted TraderHub) with local
fallback — no API keys needed. Discover flags live with
traderhub <group> <verb> --help; do NOT guess flags.
traderhub — low-frequency market data
One binary for everything that updates on hours-to-quarters cadence. Output is
JSON on stdout (pipe to jq); a non-zero exit = failure with the reason on
stderr.
traderhub <group> <verb> [--flag value]
traderhub --help # all groups
traderhub <group> <verb> --help # a verb's flags
Not here: K-lines/quotes (realtime — see alice analysis + the
alice-analysis skill), collected-RSS articles (alice rss), trading (use
alice-uta — see the alice-uta skill).
Reach for a BOARD before assembling primitives
Boards are the finished product — pre-aggregated, cached, one call:
traderhub board get --board macro # 14 US macro cards (rates, CPI YoY, labor, oil, M2…)
traderhub board get --board movers # gainers/losers/active + 4 screener lists
traderhub board get --board calendar # earnings + IPOs + ex-dividends, 14d window
traderhub board get --board calendar --days 30
traderhub board get --board valuation # S&P 500 PE / CAPE / yields
traderhub board get --board term-structure # BTC/ETH futures curve + annualized basis
traderhub board get --board global-macro # 7 countries × CPI/rates/CLI/house/equity
traderhub board get --board shipping # 6 maritime chokepoints, daily transit
traderhub board get --board fed # balance sheet + dealer positioning + FOMC docs
traderhub board rotation # GICS sector rotation table (capital flow lens)
Every payload carries meta: origin ("hub" = hosted TraderHub, "local" =
this instance's own keys), stale: true = upstream refresh failed, you're
seeing the last good snapshot — say so if it matters to the conclusion.
Equity fundamentals
traderhub equity profile --symbol AAPL
traderhub equity financials --symbol AAPL --type income --period annual --limit 5
traderhub equity ratios --symbol AAPL --period annual --limit 5 # ttm=include by default
traderhub equity estimates --symbol NVDA # analyst consensus + price targets
traderhub equity insiders --symbol NVDA --limit 20 # Form-4 transactions
traderhub equity short-interest --symbol GME # short shares/ratio/float %
traderhub equity earnings --start-date 2026-06-15 --end-date 2026-06-30
traderhub equity discover --list gainers # or: losers, active,
# undervalued_growth, growth_tech, small_caps, undervalued_large
ETF drilldown (the theme workflow)
Broad sectors come from board rotation; for a specific theme go one level
deeper:
traderhub etf search --query uranium
traderhub etf info --symbol URA
traderhub etf holdings --symbol URA # top constituents
traderhub etf sectors --symbol XLK # sector weights (decimal fractions)
US macro series (FRED / BLS / EIA)
Workflow: search for the series id first, then pull observations.
traderhub economy fred-search --query "core pce"
traderhub economy fred-series --symbol PCEPILFE --limit 24 # limit = latest N
traderhub economy fred-series --symbol "GDP,UNRATE" --start-date 2020-01-01
traderhub economy fred-regional --symbol WIPCPI # state-level cross-section
traderhub economy bls-search --query "average hourly earnings"
traderhub economy bls-series --symbol CES0500000003
traderhub economy petroleum --category crude_oil_stocks # EIA weekly
traderhub economy energy --category retail_gasoline # EIA short-term outlook
traderhub economy euro-bop --report-type main # ECB euro-area balance of payments
Cross-country (OECD)
Country flag takes slugs, comma-separable:
united_states, china, japan, germany, united_kingdom, india, brazil, france, italy, canada, australia, south_korea.
traderhub global cpi --country china,japan --transform yoy
traderhub global rates --country united_states --duration short
traderhub global leading --country germany # CLI: 100 = trend, above & rising = expansion
traderhub global house --country canada # real house price index, 2015=100
traderhub global share --country japan # equity index, 2015=100
traderhub global retail --country united_kingdom
Shipping (IMF PortWatch) / Fed / crypto curves
traderhub shipping port-search --query shanghai
traderhub shipping port-volume --port-id <id-from-search>
traderhub shipping chokepoint --name suez # daily vessels + tonnage
traderhub fed documents # FOMC statements/minutes/projections links
traderhub fed balance-sheet # WALCL/TREAST/MBS series
traderhub fed dealers # primary dealer net positions (NY Fed)
traderhub crypto options --symbol BTC # Deribit chains (BTC/ETH/PAXG)
traderhub crypto futures --symbol ETH
traderhub index search --query "S&P" # CBOE index directory
Units — read before comparing numbers
percent_changeon movers/discover rows is a fraction (0.052 = +5.2%).dividend_yield, ETFweightare decimal fractions (0.012 = 1.2%).- OECD
cpi --transform yoyandratesare percent units (3.72 = 3.72%). - FRED series come in the unit FRED publishes (check the series title).
dollar_volumeis price × volume — the only volume number comparable ACROSS tickers;rvol(volume vs its own 20d average) is the unusual-for-itself signal.