Traderhub

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_change on movers/discover rows is a fraction (0.052 = +5.2%).
• dividend_yield, ETF weight are decimal fractions (0.012 = 1.2%).
• OECD cpi --transform yoy and rates are percent units (3.72 = 3.72%).
• FRED series come in the unit FRED publishes (check the series title).
• dollar_volume is price × volume — the only volume number comparable ACROSS tickers; rvol (volume vs its own 20d average) is the unusual-for-itself signal.