Daily Main Street (consumer demand) vs Wall Street (analyst sentiment) scores on 500+ US stocks, divergence events with dated outcomes, and a decade of history. REST API + hosted MCP server for agents. The free key takes one email — no card, no consumer subscription; paid tiers add live data and volume.
Study methodology + full fact sheets: likefolio.ai/enterprise. Hypothetical results; past performance does not guarantee future results.
Already a LikeFolio member? Sign in — your login is your developer account.
curl -H "X-API-Key: lf_your_key" \
https://likefolio.ai/v1/scores/AAPL
# Python
import requests
r = requests.get("https://likefolio.ai/v1/scores/AAPL",
headers={"X-API-Key": "lf_your_key"})
print(r.json()) # {"ticker": "AAPL", "main_street": 90, "wall_street": 33,
# "divergence_gap": 57, "as_of": "...", ...}
# MCP (Claude, Cursor, any MCP client) — see likefolio.ai/mcp
{"mcpServers": {"likefolio": {"url": "https://likefolio.ai/mcp/http",
"headers": {"X-API-Key": "lf_your_key"}}}}
Full reference — endpoints, errors, code samples: /docs · Docs mirror for LLMs:
/llms.txt · machine-readable
data dictionary: GET /v1/meta.
Every plan includes a monthly credit allowance. Beyond it, prepaid credit packs are consumed automatically — then a clean hard stop, so you can never be surprise-billed. Packs work with or without a subscription. Plan changes are prorated and self-serve through the billing portal. Need more than Quant — redistribution, embeds, or firm-wide feeds? Talk to us.
| Endpoint | Credits | What it returns |
|---|---|---|
GET /v1/scores/{ticker} | 2 | Latest Main Street / Wall Street / LikeFolio Score for one ticker |
GET /v1/scores/{ticker}/history | 1 / ticker-day | Daily score history for one ticker |
GET /v1/scores/social-heat/{ticker} | 1 / row | Visits-based Social Heat Score history, computed on the fly from currently stored SimilarWeb US visits |
GET /v1/screener | 2 / row | The whole universe, ranked by LikeFolio Score, filterable by score floor |
GET /v1/divergence | 3 / row | Today's widest Main Street vs Wall Street gaps, ranked, with researched why-now context on builder+ |
GET /v1/divergence/events | 10 | Dated divergence-extreme onsets with forward-return outcomes — the receipts log — Quant |
GET /v1/signals | 2 | Recent published, ticker-tagged research signals (delayed on free keys) |
GET /v1/themes | 2 | Curated investment theme baskets with aggregate demand scores |
GET /v1/themes/{slug} | 1 / constituent | One theme with every constituent's latest scores and divergence gap |
GET /v1/coverage | free | Every ticker this key can currently retrieve a score for — the /v1 replacement for the old charts endpoint /charts/v1/companies/with-social-heat-score |
GET /v1/scores/history | 1 / row | Daily score history for many tickers in one call, at the same per-row rate as the single-ticker route |
GET /v1/track-record | free | The public closed model-portfolio record — aggregate stats plus the dated per-trade list |
GET /v1/divergence/open | 500 | Currently-open divergence extremes — the actionable signal, with flag date and entry price — Quant |
GET /v1/earnings | 100 | Covered names reporting soon, with the current demand read on each — Builder+ |
GET /v1/usage · GET /v1/meta | free | Your meter + the data dictionary (free) |
GET /v1/bulk/exports | free | The nightly Backtest Pack: full score history + divergence events as gzipped CSVs with checksums — Quant |
POST/GET/DELETE /v1/webhooks | free | Event webhooks: divergence onsets + score moves — Quant |
Worked example: score every ticker daily (500 × 1 credit × 21 trading days ≈ 10,500 credits/mo) fits Hobbyist with room to spare; add daily full-universe history pulls and you want Builder.
| Tier | You may | You may not |
|---|---|---|
| Free | Personal projects with "Powered by LikeFolio" attribution | Commercial use, redistribution, removing attribution |
| Hobbyist | Personal trading, private tools | Commercial products, sharing data |
| Builder | Internal commercial use at your company | Displaying data to your users, redistribution |
| Quant | Indie apps displaying scores (with attribution) | Bulk redistribution, resale |
| Enterprise | Redistribution, embeds, firm-wide feeds, custom terms | — |
The hosted MCP server exposes the same data as first-class tools (scores, divergence, events, screener) with as-of dates and citation URLs in every payload — one config line in Claude, Cursor, or any MCP client. Setup: likefolio.ai/mcp. MCP calls burn the same credits as REST.
No — and you don't need a LikeFolio membership either. Enter your email above, click the sign-in link, and your developer account and free key exist. Already have a LikeFolio login? Same email, same account — it can hold a Pro membership and an API plan side by side. Keys, usage, and billing all live on this page.
One credit is roughly one scored-data request. Heavier calls cost more per the rate card above, and every response carries X-Credits-Remaining so you always know where you stand. Usage and meta calls are free.
Prepaid credits are consumed next, automatically. When both are gone your key returns HTTP 429 until you top up, upgrade, or the cycle resets — usage is always paid up front, so you can never be surprise-billed. We email you at 75, 90, and 100% of your allowance.
Manage billing on this page opens your Stripe portal: switch between Hobbyist, Builder, and Quant with automatic proration, update your card, download invoices, or cancel at period end. Your key keeps working after a cancel — it just drops back to the free tier.
Your key automatically upgrades to live data (no 7-day delay), the full 500+ ticker universe, a year of history, and 5,000 credits a month — included with your membership. Deeper history, webhooks, and bulk exports remain part of the developer plans.
Yes — the hosted MCP server exposes the same data as first-class tools with as-of dates and citation URLs in every payload. One config line in Claude, Cursor, or any MCP client; MCP calls burn the same credits as REST.