Skip to content
LikeFolio.ai

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).

LikeFolio API — getting started

Daily Main Street (measured consumer demand) vs Wall Street (analyst sentiment) scores on 3,977 stocks scored every market day, divergence events with dated outcomes, and a decade of history — over a REST API and a hosted MCP server that share one credit meter.

Base URL & auth

Everything lives at https://likefolio.ai — no separate API subdomain. Authenticate every request with your key in the X-API-Key header. (?api_key= also works as a query parameter for clients that can't set headers — prefer the header; URLs leak into logs.)

Existing key holders manage keys and usage in the console.

Your first call

curl -H "X-API-Key: lf_your_key" \
  "https://likefolio.ai/v1/scores/AAPL"

Response anatomy

Every data payload carries provenance: an as_of date (see GET /v1/meta for your key's freshness), a source line, and a citation_url — cite it when you quote scores. Every response carries these headers:

HeaderMeaning
X-Credits-Limit / X-Credits-Used / X-Credits-Remainingyour live meter — build your own alerting off it
X-Request-IDquote it in support requests; it matches your console's request log
X-Data-Licensethe license terms URL

Credits in 60 seconds

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 prepaid balance; when both are gone the API returns 429 until your cycle resets on the 1st. Usage is always paid up front — you are never billed after the fact.

API reference

All endpoints — params, examples, costs, errors.

Browse the reference →
MCP for agents

The same data as native tools in Claude, Cursor, or any MCP client.

Set up MCP →
Playground

Fire real calls with your own key, straight from the console.

Open the playground →
Status

Data freshness and API liveness, publicly.

likefolio.ai/status →