# Traderhub

How to pull LOW-FREQUENCY market data from the `traderhub` CLI: finished market boards...

- Repository: https://github.com/TraderAlice/OpenAlice (7404 stars)
- Category: Engineering
- License: AGPL-3.0
- Last updated: 2026-10-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add TraderAlice/OpenAlice --skill traderhub -g -a claude-code -y`
Codex: `npx skills add TraderAlice/OpenAlice --skill traderhub -g -a codex -y`
Cursor: `npx skills add TraderAlice/OpenAlice --skill traderhub -g -a cursor -y`
Gemini CLI: `npx skills add TraderAlice/OpenAlice --skill traderhub -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# `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:

```bash
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

The rest: https://github.com/TraderAlice/OpenAlice/blob/HEAD/default/skills/traderhub/SKILL.md