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-cardteaser (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.csvBase 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.
Quick links
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
| Surface | Free | Essential | Research | Pro (session) | Enterprise key |
|---|---|---|---|---|---|
| Screener | SPY25 sample · arrow + regime cells | S&P 500 · FUND / PERF / EXH / ATR cells | Full 12k+ universe + CSV | Research + I·EXH | Pro + keys / webhooks |
| Signal card | Direction, regime, headline PF on SPY25 | Fund scores + exhaustion (SP500) | Fund scores + exhaustion (full book) | Full packs (PF, composite, Best Combo) | Full packs (login or API key) |
| Stock page | Public dossier on any ticker (overview, financials, news); call + regime on SPY25 | Deeper scores on S&P 500 names | Deeper scores on the full book | Full packs + 1D on the page | Same as Pro |
| Charts | 30 days · White Arrow + regime on SPY25 | Through 1Y · + exhaustion, ATR trail, HiLo flip, studies | Through 5Y / MAX | Long history + 1D intraday | Same as Pro |
| Saved views / alerts | Built-in presets | Saved columns and views | Overnight email alerts | Research + unlisted share links | Pro + Slack / Discord |
| Research chat | Guest 1/day · signed-in 3/day | Signed-in free quota (3/day) | Signed-in free quota (3/day) | 10 messages/day | Unlimited · CLI / MCP ask |
| Options | 5 public observe-only ledgers | Same public ledgers | Same public ledgers | Same public ledgers | Same public ledgers |
| Live / I·EXH / SD50 | Locked | Locked | Locked | 1D charts, I·EXH, SD50 | Pro + CLI via API key |
| API / CLI | Thin card, intel, ask | Session card depth on SP500 | Session card depth on full book | Full card when signed in | Keys: universe, export, archives |
| MCP / webhooks | MCP with free tools (sign in) | MCP at the S&P 500 desk | MCP at the full book | MCP at the complete desk | MCP + 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/latestsignal-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, headlinepf/win_rate, market capdepth=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 .depthas_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.
| Field | Meaning |
|---|---|
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. |
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/mcpto 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-authenticateResearch 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.
- Free research: no account —
lopjlb ticker AAPL(thin card) - MCP host: add
https://www.lopjlb.com/mcpand sign in with your LOPJLB account (any plan) - Pro UI: account + Pro at /pricing; session cookie → full signal-card + intraday
- Enterprise: subscribe, wait for entitlement, create key in Settings
- 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.
| Tier | Scope | How |
|---|---|---|
| public | Regime, search, preview, market pulse, thin signal-card | No credentials |
| freemium | Detail, fundamentals, ETF holdings, earnings intel/transcripts, 30d sparkline | No credentials; ticker routes 30/min · 500/day anon |
| essential | S&P 500 book, Triple Exhaustion + FUND/PERF, 1Y charts, saved views | WorkOS session + essential |
| research | Full 12k book, 5Y/MAX charts, desktop CSV, overnight alerts, full regime history (?full=1) | WorkOS session + research |
| pro | Full packs, desk peers, SD50 files, live I·EXH / 1D, per-ticker options chains, chat 10/day | WorkOS session + pro, or Enterprise API key (BFF maps key → Pro) |
| enterprise | API keys, Slack/Discord webhooks, bulk export, unlimited research chat | Live 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.
| Caller | Per minute | Per day |
|---|---|---|
| Anonymous / session (IP) | 120 | 10,000 |
| Anon freemium ticker (signal-card / detail / intel) | 30 | 500 |
| Enterprise API key | 600 | 50,000 |
| API key validate (IP) | 30 | 200 |
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.
Integrating with this codebase? AGENTS.md in the LOPJLB repository has the coding-agent instructions.