Credits, tiers & limits
Every call costs credits per the rate card (per-record endpoints bill by rows returned). Credits come out of your monthly allowance first; when that's gone we draw from any prepaid pack; when both are gone the API returns 429 until you top up or upgrade — usage is always paid up front, you are never billed after the fact.
Tiers
| Tier | Credits/mo | Freshness | Coverage | History | Price |
|---|---|---|---|---|---|
| Free | 500 | 7-day delay | top 100 | 90 days | $0/mo |
| Hobbyist | 5,000 | live | full universe | 1095 days | $49/mo |
| Builder | 30,000 | live | full universe | full | $199/mo |
| Quant | 100,000 | live | full universe | full | $499/mo |
| Enterprise | custom | live | full universe | full | custom |
Pro-member perk: a LikeFolio Pro member's
otherwise-free key upgrades automatically — live data, full universe,
5,000 credits/mo, 365 days of history.
Included with membership; deeper history, webhooks, and bulk exports stay
with the developer plans.
Rate card
| 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 |
When the allowance runs out
- Prepaid packs (automatic): $25 buys 2,000 credits that never expire and are consumed after your allowance — with or without a subscription. Top up any time from your console.
- Then a clean stop: with allowance and prepaid both gone, requests return 429 until you top up, upgrade, or your cycle resets on the 1st. Usage is always paid up front — no surprise bills, ever.
We email you at 75%, 90%, and 100% of your allowance, on every
tier, and every response carries X-Credits-Remaining and
X-Prepaid-Remaining.
Fair rejections
Rejected calls charge zero credits — tier gates (quant-only events, bulk, webhooks), malformed parameters (bad dates, out-of-bounds limits, invalid enums), and free-tier coverage 403s are all checked before billing, on REST and MCP alike.