likefolio.ai hosts the legacy /v1 developer endpoints and the MCP server for existing keys. New API access is sold only by SwanPowers through data.likefolio.com, a separate API with its own base URL and endpoints. Request a trial at https://data.likefolio.com/trial.html (work email, manual review).
Credits & limits
Legacy terms: credits apply to developer keys issued on likefolio.ai before the hand-off; new API access is offered only through data.likefolio.com. Technical reference for existing keys. Every call costs credits per the rate card (per-record endpoints bill by rows returned). Credits come out of your monthly allowance first, then any balance already on the key; when both are gone the API returns 429 until your cycle resets — you are never billed after the fact.
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 | |
GET /v1/divergence/events | 10 | Dated divergence-extreme onsets with forward-return outcomes — the receipts log |
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 |
GET /v1/earnings | 100 | Covered names reporting soon, with the current demand read on each |
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 |
POST/GET/DELETE /v1/webhooks | free | Event webhooks: divergence onsets + score moves |
When the allowance runs out
With the allowance and any balance on the key both gone, requests return 429 until your cycle resets on the 1st. There are no surprise bills, ever.
We email you at 75%, 90%, and 100% of your allowance, and every
response carries X-Credits-Remaining and
X-Prepaid-Remaining.
Fair rejections
Rejected calls charge zero credits — plan gates (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.