api.perception.toDEVELOPER REST API + MCP
Every digital asset discussion, served through a single API
One key covers the REST API and the MCP server: sentiment, trends and mentions from thousands of sources, structured for models.
Perception API Gateway
DEVELOPER PLAYGROUND
See a real request and what comes back
GET https://api.perception.to/indexPerception Index Data Feed
Fetches the live outlet-weighted sentiment index score for Bitcoin, including confidence, 24h/7d changes, decomposed drivers, and momentum velocity. Free tier requires no authentication; paid tier includes divergences and historical returns by sentiment regime by adding a Bearer token and "?full=true" parameter.
curl "https://api.perception.to/index"
Query Parameters Schema
scroll →
| Field | Type | Required | Description |
|---|---|---|---|
| full | boolean | optional | Include divergence metrics and historical returns by sentiment regime (requires Bearer token authentication). |
| date | string (YYYY-MM-DD) | optional | Query historical index value for a specific UTC date. |
PRICING
Included in every paid plan
Standard at $249/mo includes the REST API and 16 MCP tools at 20 credits a day. Intelligence at $499/mo covers all 31 tools at 100 credits a day, every call a flat 1 credit. A free key covers 14 tools at 5 credits a day, no card.
10 seats included · $399/mo billed annually
- Full REST API access on its own daily pool, a flat 1 credit per call
- Includes all 31 Perception MCP Gateway tools (Claude, Cursor, Jupyter)
- Includes the full Perception dashboard: sentiment, trends and entity intelligence