Skip to content

LOPJLB API for developers & agents

A quant research layer, not a raw market-data API: 12,000+ U.S. names re-scored nightly, evidence with the call.

Each call carries direction, backtested stats, market regime, factor scores and earnings CallCard synthesis. Only need OHLCV? Free tools are enough. See how it works, compare, methodology.

Free, no login
Thin signal-card teaser (depth=public) plus freemium detail / earnings intel. Anon ticker budget 30/min · 500/day.
Pro or Enterprise
Full PF packs and cross-section /universe: a Pro browser session or an Enterprise API key.

Quick start

# Install CLI (pick one) — no browser for free research
uv tool install lopjlb
curl -fsSL https://www.lopjlb.com/install.sh | sh
brew install lopjlb/tap/lopjlb

# Free REST via CLI / PyPI (thin signal-card depth=public)
lopjlb ticker AAPL
lopjlb ticker AAPL intel
lopjlb regime
lopjlb schema
python -c "import lopjlb; print(lopjlb.Ticker('AAPL').summary())"

# Enterprise REST (mint key in Settings after entitlement is active)
# Key unlocks full signal-card + Pro REST (/universe) + export
export LOPJLB_API_KEY=lopjlb_live_…
lopjlb screen
lopjlb export signals --out signals.csv

Base URL, the canonical versioned prefix:

https://www.lopjlb.com/api/v1/

Legacy https://www.lopjlb.com/bff/api/ paths keep working, with the same handlers, auth and rate limits. Every request goes through the BFF proxy on the web origin. Do not call api.lopjlb.com directly: it requires an internal key.

openapi.json · openapi.yaml — Machine-readable API spec
https://www.lopjlb.com/mcp · server card — Remote MCP, every plan (sign in)
llms.txt — Agent navigation index
api/llms.txt — Endpoint reference
/bff/api/schema/metrics — Screener column dictionary (ui_id ↔ api_key)
lopjlb/lopjlb-skill — npx skills add lopjlb/lopjlb-skill

Agent surfaces (REST · CLI · PyPI · MCP)

Four surfaces over one BFF, and what each plan unlocks.

Four peers over one BFF. CLI and PyPI call REST only; MCP is a separate host protocol (Claude, ChatGPT, Cursor), on every plan once you sign in. Free REST needs no browser and no API key: thin teaser + freemium detail/intel, not a full universe dump. Pro is browser-first (session cookie), including live intraday / I·EXH. Enterprise keys unlock headless Pro REST, full signal-card, export and MCP without a browser. Same matrix as /pricing.

Screener

Free
SPY25 sample · arrow + regime cells
Essential
S&P 500 · FUND / PERF / EXH / ATR cells
Research
Full 12k+ universe + CSV
Pro (session)
Research + I·EXH
Enterprise key
Pro + keys / webhooks

Signal card

Free
Direction, regime, headline PF on SPY25
Essential
Fund scores + exhaustion (SP500)
Research
Fund scores + exhaustion (full book)
Pro (session)
Full packs (PF, composite, Best Combo)
Enterprise key
Full packs (login or API key)

Stock page

Free
Public dossier on any ticker (overview, financials, news); call + regime on SPY25
Essential
Deeper scores on S&P 500 names
Research
Deeper scores on the full book
Pro (session)
Full packs + 1D on the page
Enterprise key
Same as Pro

Charts

Free
30 days · White Arrow + regime on SPY25
Essential
Through 1Y · + exhaustion, ATR trail, HiLo flip, studies
Research
Through 5Y / MAX
Pro (session)
Long history + 1D intraday
Enterprise key
Same as Pro

Saved views / alerts

Free
Built-in presets
Essential
Saved columns and views
Research
Overnight email alerts
Pro (session)
Research + unlisted share links
Enterprise key
Pro + Slack / Discord

Research chat

Free
Guest 1/day · signed-in 3/day
Essential
Signed-in free quota (3/day)
Research
Signed-in free quota (3/day)
Pro (session)
10 messages/day
Enterprise key
Unlimited · CLI / MCP ask

Options

Free
5 public observe-only ledgers
Essential
Same public ledgers
Research
Same public ledgers
Pro (session)
Same public ledgers
Enterprise key
Same public ledgers

Live / I·EXH / SD50

Free
Locked
Essential
Locked
Research
Locked
Pro (session)
1D charts, I·EXH, SD50
Enterprise key
Pro + CLI via API key

API / CLI

Free
Thin card, intel, ask
Essential
Session card depth on SP500
Research
Session card depth on full book
Pro (session)
Full card when signed in
Enterprise key
Keys: universe, export, archives

MCP / webhooks

Free
MCP with free tools (sign in)
Essential
MCP at the S&P 500 desk
Research
MCP at the full book
Pro (session)
MCP at the complete desk
Enterprise key
MCP + Slack / Discord webhooks
SurfaceFreeEssentialResearchPro (session)Enterprise key
ScreenerSPY25 sample · arrow + regime cellsS&P 500 · FUND / PERF / EXH / ATR cellsFull 12k+ universe + CSVResearch + I·EXHPro + keys / webhooks
Signal cardDirection, regime, headline PF on SPY25Fund scores + exhaustion (SP500)Fund scores + exhaustion (full book)Full packs (PF, composite, Best Combo)Full packs (login or API key)
Stock pagePublic dossier on any ticker (overview, financials, news); call + regime on SPY25Deeper scores on S&P 500 namesDeeper scores on the full bookFull packs + 1D on the pageSame as Pro
Charts30 days · White Arrow + regime on SPY25Through 1Y · + exhaustion, ATR trail, HiLo flip, studiesThrough 5Y / MAXLong history + 1D intradaySame as Pro
Saved views / alertsBuilt-in presetsSaved columns and viewsOvernight email alertsResearch + unlisted share linksPro + Slack / Discord
Research chatGuest 1/day · signed-in 3/daySigned-in free quota (3/day)Signed-in free quota (3/day)10 messages/dayUnlimited · CLI / MCP ask
Options5 public observe-only ledgersSame public ledgersSame public ledgersSame public ledgersSame public ledgers
Live / I·EXH / SD50LockedLockedLocked1D charts, I·EXH, SD50Pro + CLI via API key
API / CLIThin card, intel, askSession card depth on SP500Session card depth on full bookFull card when signed inKeys: universe, export, archives
MCP / webhooksMCP with free tools (sign in)MCP at the S&P 500 deskMCP at the full bookMCP at the complete deskMCP + Slack / Discord webhooks

Public endpoints (no auth)

One curl per public route, with a trimmed production body.

Anon freemium ticker routes (signal-card, detail, earnings-intel) share a 30/min · 500/day per-IP budget on top of the global 120/min · 10k/day limit. /hmm/latest is the market regime (four states); signal-card.regime is the per-ticker proxy and can disagree. On 2026-10-26 the market was BEAR while AAPL’s card was BULL (37 days).

Canonical prefix /api/v1; /bff/api is the legacy alias. JSON comments are not on the wire.

# Market regime (cross-asset). This is NOT signal-card.regime.
curl -s https://www.lopjlb.com/api/v1/hmm/latest
# {"success":true,"regime":{"date":"2026-10-26","spy_price":765.37,"regime":"BEAR","days_in_regime":7,"previous_regime":"BULL"}}

curl -s https://www.lopjlb.com/api/v1/hmm/sparkline
# {"points":[{"d":"2026-07-29","c":634.12,"r":"BULL"},"..."]}

curl -s https://www.lopjlb.com/api/v1/hmm/history
# {"points":[{"date":"2025-10-27","regime":"BULL","spy_price":671.3,"leverage":1.0}],"count":251,"truncated":true,"tier":"public","public_window_days":365,"start":"2025-10-27"}

# 402 — requested range is entirely before the 365-day free window
curl -s 'https://www.lopjlb.com/api/v1/hmm/history?start=2024-01-01&end=2024-03-01'
# {"error":"history_outside_free_window","public_window_days":365,"earliest_public_date":"2025-10-27","hint":"Pass full=1 with a Research session or Enterprise API key"}

# 422 — inverted range in the request itself
curl -s 'https://www.lopjlb.com/api/v1/hmm/history?start=2026-03-01&end=2026-01-01'
# {"error":"invalid_range","hint":"end must be on or after start","start":"2026-03-01","end":"2026-01-01"}

curl -s https://www.lopjlb.com/api/v1/healthz
# {"status":"ok|degraded","service":"big5-api","components":{"pipeline":{"status":"ok"},"archive":{"status":"degraded","reason":"…"}}}

curl -s https://www.lopjlb.com/api/v1/market-pulse
# {"regime":{"date":"2026-10-26","regime":"BEAR","days_in_regime":7},"breadth":{"total":15164,"bull":5998,"bear":9032,"bull_pct":40}}

curl -s https://www.lopjlb.com/api/v1/watch/glance
# {"regime":"BEAR","days":7,"bull_pct":40,"bear_pct":60}

curl -s https://www.lopjlb.com/api/v1/watch/home
curl -s https://www.lopjlb.com/api/v1/watch/spy25

# PIT universes — names are case-insensitive; sp500 aliases spy500
curl -s 'https://www.lopjlb.com/api/v1/universes/SPY25?asof=2025-01'
# {"universe":"spy25","asof":"2025-01","count":25,"members":[{"symbol":"NVDA","name":"NVIDIA Corp","weight":0.07}]}

curl -s 'https://www.lopjlb.com/api/v1/universes/sp500?asof=2025-01'
# {"universe":"spy500","asof":"2025-01","count":503,"members":[{"symbol":"AAPL","name":"Apple Inc."}]}

curl -s https://www.lopjlb.com/api/v1/universes/spy500/months
curl -s https://www.lopjlb.com/api/v1/universes/maps
# {"rename_count":296,"delisted_count":2215}

curl -s 'https://www.lopjlb.com/api/v1/bigfive/search?q=AAPL'
# [{"symbol":"AAPL","name":"Apple Inc."}]

curl -s https://www.lopjlb.com/api/v1/bigfive/universe-preview
# {"count":24,"total_count":6576,"is_preview":true,"symbols":[{"symbol":"…","direction":1}]}

curl -s https://www.lopjlb.com/api/v1/bigfive/universe-version
# {"version":"dfc7dd586557260f0abc7f17"}

curl -s https://www.lopjlb.com/api/v1/bigfive/showcase
curl -s https://www.lopjlb.com/api/v1/bigfive/signal-ledger
curl -s https://www.lopjlb.com/api/v1/bigfive/signal-history
curl -s https://www.lopjlb.com/api/v1/bigfive/earnings-calendar
curl -s https://www.lopjlb.com/api/v1/bigfive/economic-calendar
curl -s 'https://www.lopjlb.com/api/v1/bigfive/compare-series?symbols=AAPL,MSFT&range=5y'
# {"range":"5y","symbols":["AAPL","MSFT"],"series":{"AAPL":{"dates":[...],"closes":[...],"in_spy25":true}}}

# Per-ticker regime proxy (can differ from /hmm/latest). 2026-10-26: AAPL BULL / 37d while market BEAR.
curl -s https://www.lopjlb.com/api/v1/bigfive/signal-card/AAPL
# {"symbol":"AAPL","name":"Apple Inc.","direction":1,"regime":"BULL","hmm_days_in_regime":37,"depth":"public"}

curl -s https://www.lopjlb.com/api/v1/bigfive/detail/AAPL
# {"symbol":"AAPL","data":[{"date":"2024-01-02","close":185.64,"combo5_direction":1}]}

curl -s https://www.lopjlb.com/api/v1/bigfive/earnings-intel/AAPL
# {"status":"ready","symbol":"AAPL","quarters_analyzed":8}

curl -s https://www.lopjlb.com/api/v1/market/overview
curl -s https://www.lopjlb.com/api/v1/market/indices
# [{"symbol":"^GSPC","price":7721.47,"change_pct":0.58}]

curl -s https://www.lopjlb.com/api/v1/market/exchange-hours
# {"count":81,"open_count":25}

curl -s https://www.lopjlb.com/api/v1/market/treasury-rates
# {"as_of":"2026-10-23","latest":{"month1":4.11,"year10":4.02},"derived":{"spread_2s10s":0.31}}

curl -s https://www.lopjlb.com/api/v1/market/news
curl -s https://www.lopjlb.com/api/v1/market/heatmap

curl -s https://www.lopjlb.com/api/v1/congress/summary
# {"as_of":"2026-10-23","trade_count":19583,"member_count":254}

curl -s https://www.lopjlb.com/api/v1/congress/trades
curl -s https://www.lopjlb.com/api/v1/congress/politicians
curl -s 'https://www.lopjlb.com/api/v1/congress/symbol/AAPL?limit=5'
# 503 when FMP is slow: {"error":"upstream_timeout","service":"congress","retry_after_s":30}

curl -s https://www.lopjlb.com/api/v1/prediction-markets/summary
# {"as_of":"2026-10-27","market_count":4439,"by_venue":{"kalshi":279,"polymarket":575}}

curl -s https://www.lopjlb.com/api/v1/prediction-markets/markets

curl -s https://www.lopjlb.com/api/v1/hold-spreads/summary
curl -s 'https://www.lopjlb.com/api/v1/hold-spreads/opportunities?limit=25'
curl -s https://www.lopjlb.com/api/v1/cash-secured-puts/summary
curl -s 'https://www.lopjlb.com/api/v1/cash-secured-puts/opportunities?limit=25'
curl -s https://www.lopjlb.com/api/v1/covered-calls/summary
curl -s 'https://www.lopjlb.com/api/v1/covered-calls/opportunities?limit=25'
curl -s https://www.lopjlb.com/api/v1/long-puts/summary
curl -s 'https://www.lopjlb.com/api/v1/long-puts/opportunities?limit=25'
curl -s https://www.lopjlb.com/api/v1/long-calls/summary
curl -s 'https://www.lopjlb.com/api/v1/long-calls/opportunities?limit=25'

curl -s https://www.lopjlb.com/api/v1/schema/metrics
curl -s https://www.lopjlb.com/api/v1/schema/presets
curl -s https://www.lopjlb.com/api/v1/schema/scopes
curl -s https://www.lopjlb.com/api/v1/schema/screener

curl -s https://www.lopjlb.com/api/v1/sd50/feed
# RSS 2.0 (not JSON)

# Legacy prefix — same handlers
curl -s https://www.lopjlb.com/bff/api/hmm/latest

signal-card depth

depth=public teaser vs depth=full packs, and who gets which.

GET /bff/api/bigfive/signal-card/{symbol} returns a depth field:

  • depth=public (anon BFF): OG-safe teaser. Symbol, name, direction, score, regime, price, daily change, sparkline, headline pf / win_rate, market cap
  • depth=full: PF packs, composite score, fund archetype scores, best-combo, ATR/exhaustion/coil, opt metrics and related research fields

The full pack needs a WorkOS Pro session (browser cookie on BFF) or an Enterprise X-LOPJLB-API-Key. First-party server jobs (OG SSR, MCP internal) also receive full packs.

# Anon → depth=public
curl -s https://www.lopjlb.com/bff/api/bigfive/signal-card/AAPL | jq .depth

# Enterprise key → depth=full (+ Pro REST)
curl -s -H "X-LOPJLB-API-Key: $LOPJLB_API_KEY" \
  https://www.lopjlb.com/bff/api/bigfive/signal-card/AAPL | jq .depth

as_of / nightly vintage

As-published snapshots with as_of=YYYY-MM-DD; 422 when none exists.

signal-card, detail (including CLI lopjlb ticker scores) and earnings-intel accept as_of=YYYY-MM-DD. When a stored nightly snapshot exists for that session, the API returns the as-published values and stamps vintage / published_at on the response (and on each detail.data[] row). Omit as_of for the live payload: existing paths are unchanged, and its published_at is when the nightly desk wrote the source file. A blank as_of= is 422 invalid_as_of.

No backfill before this store existed. The first servable vintage is the first session jobs/ticker_vintage persists after deploy; until that job succeeds, every as_of returns 422 no_vintage. Missing dates after that (weekends, holidays, a failed snapshot) also 422. The API never substitutes today's values for a past as_of.

Daily regime inference appends to regime_history.jsonl, but an ops backfill can rewrite that file from the current model after a reset: labels are not guaranteed never to be relabelled. The public signal-ledger is rebuilt from dated blog posts plus current daily pickles: posts stay put, outcomes can move if pickle history is recomputed. Treat as_of snapshots, not those two files, as the as-published ticker record.

# Live (no as_of) — today's payload + vintage/published_at stamps
curl -s https://www.lopjlb.com/bff/api/bigfive/signal-card/AAPL | jq '{depth,vintage,published_at,score}'

# Historical vintage — 200 as-published, or 422 no_vintage
curl -s 'https://www.lopjlb.com/bff/api/bigfive/signal-card/AAPL?as_of=2025-01-02'
# {"error":"no_vintage","withheld":"no vintage before <earliest>","earliest_vintage":"...","latest_vintage":"...","as_of":"2025-01-02"}

curl -s 'https://www.lopjlb.com/bff/api/bigfive/detail/AAPL?as_of=2025-01-02'
curl -s 'https://www.lopjlb.com/bff/api/bigfive/earnings-intel/AAPL?as_of=2025-01-02'

Market regime payload

Every /hmm/latest field in plain words. Free, no key.

GET /bff/api/hmm/latest is free and needs no key. It returns tonight’s market regime with its probabilities, circuit breakers and recent history. Each field is described, with an example, in openapi.json under HmmLatestResponse.

regime.regime
Current regime: BULL (rising market, normal risk), RECOVERY (rebound after stress), BEAR (falling or risk-off) or CRISIS (high-volatility sell-off).
regime.days_in_regimeregime.transition_dateregime.previous_regime
How long the regime has held, the day it started, and the regime before it.
regime.probabilities
Probability of each regime today, in percent. The four add up to about 100.
regime.risk_off_prob
BEAR plus CRISIS probability, in percent.
regime.leverageregime.risk_on
SPY exposure the regime backtest takes next session: 3x in BULL or RECOVERY, 1x in BEAR or CRISIS. risk_on means 2x or more.
regime.pbt_drawdown_prob
PBT model probability (0–1) that SPY falls more than 5% within 20 trading days. Context only: it has shown no out-of-sample skill.
regime.pbt_breaker_activeregime.breadth_mom_defensive
Two breaker readings, context only since Nov 2026: drawdown model above threshold, and market breadth deteriorating fast. They no longer change leverage.
regime.active_breakersregime.breaker_moderegime.breakers_applied
Breakers on (0–2) and what the old tiered rule would do: CLEAR, REDUCED or FLAT. breakers_applied is false: the rule no longer touches leverage.
regime.breadth_breaker_active
Informational breadth flag (5-day below 20-day). Not counted as a breaker.
regime.dist_from_highregime.momentum_weak
Where SPY sits in its one-year range, 0 at the low and 1 at the high (a range position, not a percent below the high). momentum_weak is below 0.75.
regime.ml_crisis_prob
Average of two auxiliary machine-learning crisis classifiers, in percent. Null when they did not run.
regime.hedge
Illustrative SPY put-hedge playbook: action (BUY_PUTS, WAIT_VIX_HIGH, TAKE_PROFIT or HOLD), VIX and whether it is under 22, strike 1% under SPY, 60-day puts rolled at 21 days, take-profit triggers.
validationhistorytransitionscharts
Model scorecard, archived daily snapshots, regime switches with SPY’s move, chart files. Optional: absent or empty when not published.
FieldMeaning
regime.regime
Current regime: BULL (rising market, normal risk), RECOVERY (rebound after stress), BEAR (falling or risk-off) or CRISIS (high-volatility sell-off).
regime.days_in_regime
regime.transition_date
regime.previous_regime
How long the regime has held, the day it started, and the regime before it.
regime.probabilities
Probability of each regime today, in percent. The four add up to about 100.
regime.risk_off_prob
BEAR plus CRISIS probability, in percent.
regime.leverage
regime.risk_on
SPY exposure the regime backtest takes next session: 3x in BULL or RECOVERY, 1x in BEAR or CRISIS. risk_on means 2x or more.
regime.pbt_drawdown_prob
PBT model probability (0–1) that SPY falls more than 5% within 20 trading days. Context only: it has shown no out-of-sample skill.
regime.pbt_breaker_active
regime.breadth_mom_defensive
Two breaker readings, context only since Nov 2026: drawdown model above threshold, and market breadth deteriorating fast. They no longer change leverage.
regime.active_breakers
regime.breaker_mode
regime.breakers_applied
Breakers on (0–2) and what the old tiered rule would do: CLEAR, REDUCED or FLAT. breakers_applied is false: the rule no longer touches leverage.
regime.breadth_breaker_active
Informational breadth flag (5-day below 20-day). Not counted as a breaker.
regime.dist_from_high
regime.momentum_weak
Where SPY sits in its one-year range, 0 at the low and 1 at the high (a range position, not a percent below the high). momentum_weak is below 0.75.
regime.ml_crisis_prob
Average of two auxiliary machine-learning crisis classifiers, in percent. Null when they did not run.
regime.hedge
Illustrative SPY put-hedge playbook: action (BUY_PUTS, WAIT_VIX_HIGH, TAKE_PROFIT or HOLD), VIX and whether it is under 22, strike 1% under SPY, 60-day puts rolled at 21 days, take-profit triggers.
validation
history
transitions
charts
Model scorecard, archived daily snapshots, regime switches with SPY’s move, chart files. Optional: absent or empty when not published.

leverage and hedge are illustrative output of the regime model’s backtest, not investment advice and not orders.

MCP

Every plan: add https://www.lopjlb.com/mcp and sign in.

MCP is included in every plan. Server URL: https://www.lopjlb.com/mcp (Streamable HTTP). Sign in with your LOPJLB account; the tools follow your plan. Free: regime, search, SPY25 summaries, calendars, option ledgers and congress. Essential, Research and Pro add their desks; Pro adds peers, I·EXH, SD50 allocation and the research desk at the Pro chat quota. Enterprise adds API keys, webhooks, bulk export and unlimited research chat.

  • Claude: Settings → Connectors → Add custom connector, paste the URL, then sign in. Claude Code: claude mcp add --transport http lopjlb https://www.lopjlb.com/mcp, then /mcp to sign in.
  • ChatGPT: Settings → Apps & Connectors → turn on developer mode (Advanced) → Create, paste the URL, choose OAuth, then sign in.
  • Cursor: add the server to ~/.cursor/mcp.json (below), then Connect in Settings → MCP.

Auth: OAuth 2.1 through WorkOS AuthKit. Without a credential the server answers 401 with a WWW-Authenticate challenge pointing at /.well-known/oauth-protected-resource/mcp, which names AuthKit as the authorization server; the host runs the sign-in. The token says who you are; your plan comes from your subscription on every call, not from token scopes. Headless (Enterprise): send X-LOPJLB-API-Key instead. The legacy URL https://www.lopjlb.com/bff/api/mcp keeps working.

Discovery: /mcp/server-card (also server-card.json). The card carries no tool list: tools depend on your plan, so hosts list them live with tools/list. Prefer compact tools (get_ticker_summary, screen_universe); ask_research_desk is the NLP desk (same pipeline and daily quota as /chat and CLI lopjlb ask). Full-universe CSV stays REST/CLI (lopjlb export signals --out …).

# Cursor (~/.cursor/mcp.json): sign in when prompted
{
  "mcpServers": {
    "lopjlb": { "url": "https://www.lopjlb.com/mcp" }
  }
}

# Enterprise, headless (no browser sign-in)
{
  "mcpServers": {
    "lopjlb": {
      "url": "https://www.lopjlb.com/mcp",
      "headers": { "X-LOPJLB-API-Key": "lopjlb_live_…" }
    }
  }
}

# Without credentials: 401 + the OAuth challenge
curl -si https://www.lopjlb.com/mcp -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | grep -i www-authenticate

Research chat

Daily quotas by plan, and the NDJSON stream.

Browser desk at /chat. Ticker turns assemble the same CONTEXT pack as scheduled blog posts (signal card, fundamentals, news, earnings CallCard). Daily quotas: anon 1 · free / Essential / Research 3 · Pro 10 · Enterprise unlimited. Agent Bearer tokens and API keys work on the same BFF routes (identity order: API key → Bearer → session).

# Quota
curl -s https://www.lopjlb.com/bff/api/research/chat/quota

# Stream NDJSON (meta → chip* → delta* → done)
curl -sN https://www.lopjlb.com/bff/api/research/chat \
  -H 'Content-Type: application/json' \
  -d '{"message":"What does LOPJLB say about AAPL?"}'

Agent Registration (WorkOS auth.md)

Register via /auth.md, then call the BFF with a Bearer token.

Discovery skill at /auth.md. Protected resource metadata: /.well-known/oauth-protected-resource. The registration AS is AuthKit (not lopjlb.com). After claim + token exchange, call the BFF with Authorization: Bearer. Agent scopes (unverified and verified): lopjlb:read:public + lopjlb:read:freemium. Pro routes follow the claimed user’s subscription; agent tokens never carry lopjlb:read:pro or Enterprise scopes. A claimed agent token also reaches MCP at the claimant’s plan (up to Pro). Export and webhooks still use Settings X-LOPJLB-API-Key.

# Follow https://www.lopjlb.com/auth.md → AuthKit register/claim/token
curl -s https://www.lopjlb.com/bff/api/hmm/latest \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Auth for AI agents

Five steps, from free CLI to a headless Enterprise key.

Free CLI returns a thin signal-card (depth=public). A Pro browser session upgrades it to depth=full on BFF. Headless full-universe /universe, peers and export need an Enterprise key minted in Settings after entitlement is active (cancelled plans get 402). Browser intraday / I·EXH is Pro-session. MCP works on every plan after OAuth sign-in.

  1. Free research: no account — lopjlb ticker AAPL (thin card)
  2. MCP host: add https://www.lopjlb.com/mcp and sign in with your LOPJLB account (any plan)
  3. Pro UI: account + Pro at /pricing; session cookie → full signal-card + intraday
  4. Enterprise: subscribe, wait for entitlement, create key in Settings
  5. Headless: X-LOPJLB-API-Key: lopjlb_live_… (full card + Pro REST + export + MCP without a browser; CLI intraday via key)

Authentication tiers

Six tiers: what each reads and how it authenticates.
TierScopeHow
publicRegime, search, preview, market pulse, thin signal-cardNo credentials
freemiumDetail, fundamentals, ETF holdings, earnings intel/transcripts, 30d sparklineNo credentials; ticker routes 30/min · 500/day anon
essentialS&P 500 book, Triple Exhaustion + FUND/PERF, 1Y charts, saved viewsWorkOS session + essential
researchFull 12k book, 5Y/MAX charts, desktop CSV, overnight alerts, full regime history (?full=1)WorkOS session + research
proFull packs, desk peers, SD50 files, live I·EXH / 1D, per-ticker options chains, chat 10/dayWorkOS session + pro, or Enterprise API key (BFF maps key → Pro)
enterpriseAPI keys, Slack/Discord webhooks, bulk export, unlimited research chatLive enterprise entitlement (session or X-LOPJLB-API-Key)

Enterprise: API keys & export

X-LOPJLB-API-Key: full card, Pro REST, export, headless MCP.

After Enterprise entitlement is active, create API keys in Settings; keys need a live Enterprise subscription. Header: X-LOPJLB-API-Key. Keys unlock full signal-card, Pro REST (/bigfive/universe, peers), bulk export, CLI intraday tools and MCP without a browser sign-in.

Rate limits

120/min anon · 30/min ticker routes · 600/min Enterprise key.
CallerPer minutePer day
Anonymous / session (IP)12010,000
Anon freemium ticker (signal-card / detail / intel)30500
Enterprise API key60050,000
API key validate (IP)30200

Errors

401 invalid key · 402 plan required · 429 rate limited.

Stable codes for CLI/SDK: 401 invalid/revoked key, 402 entitlement required (pro_required / enterprise_required), 429 rate limited. The body includes error and an optional upgrade_url.

Versioning and deprecation

/api/v1 is additive-only; breaking changes get 90+ days notice.

/api/v1 is additive-only: new fields and routes may appear, existing fields stay. Breaking changes go to /api/v2 with at least 90 days notice, advertised with Deprecation and Sunset response headers.

Webhooks

Enterprise Slack and Discord signal alerts. No arbitrary URLs.

Enterprise users configure outbound Slack and Discord webhooks for signal alerts in Settings. Generic arbitrary URLs are not supported (SSRF allowlist). Setup: platform docs.

SD50 signal service

RSS and live MTD tracker are public; CSV and JSON need Pro.

Monthly model portfolio allocations. Level 1 (RSS) and the live MTD tracker are public; CSV and JSON require Pro. See platform docs and /sd50.

# Level 1. RSS feed (public, full monthly history)
curl -s https://www.lopjlb.com/bff/api/sd50/feed

# Live MTD. SD50 + SD14 vs SPY/FTEC/SPMO (public)
curl -s https://www.lopjlb.com/bff/api/sd50/mtd-tracker

# Level 2. CSV (Pro session cookie required)
curl -s -b 'your-workos-session-cookie' \
  'https://www.lopjlb.com/bff/api/sd50/allocation.csv?variant=sd14'

# SD50 full book + share sizing for a $100k account
curl -s -b 'your-workos-session-cookie' \
  'https://www.lopjlb.com/bff/api/sd50/allocation.csv?variant=sd50&account_value=100000'

# Level 3. JSON API (Pro)
curl -s -b 'your-workos-session-cookie' \
  'https://www.lopjlb.com/bff/api/sd50/allocation?variant=sd14&account_value=100000'

Glossary: bigfive and combo5

bigfive is a route family; combo5 is the White Arrow composite.

bigfive is the per-ticker signal and score API family (signal-card, detail, earnings intel, scores): an internal route prefix, not a fifth model.

combo5 is the five-sub-signal directional composite behind the White Arrow (score −5 to +5), which Methodology calls the Directional Signal 5-model composite. It is not Best Combo V5 (the separate confirmed-evidence state machine).

Full platform glossary: /docs#glossary.

Get access

No key for the thin signal-card and freemium detail. MCP on every plan. Pro sessions unlock full packs; Enterprise adds API keys, webhooks, bulk export and unlimited research chat.

See pricingOpen the screener

Integrating with this codebase? AGENTS.md in the LOPJLB repository has the coding-agent instructions.