BASE URL:api.perception.to

DEVELOPER REST API

Every digital asset discussion, served through a single API

Connect your models directly to our high-velocity market sentiment data streams.

1,000+

Curated Sources

<3 min

Ingestion Latency

REST Endpoints

MCP Tools

Start 14-Day Free Trial

/index

/v1/feed

/v1/trends

/v1/fear-greed-index

/v1/grouped-data

Perception API Gateway

IGET /index

200 OK

TGET /v1/trends

200 OK

EPOST /v1/grouped-data

200 OK

FGET /v1/feed

200 OK

GGET /v1/fear-greed-index

200 OK

Claude

ChatGPT

Gemini

Cursor

VS Code

Hermes

OpenClaw

Claude Code

Reference

Every endpoint, every tool, and what each one costs

31 MCP tools and 17 REST endpoints, with what each returns, the question it answers, and the credits a call spends.

Open the reference

DEVELOPER PLAYGROUND

See a real request and what comes back

Endpoints List

GET https://api.perception.to/index

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

INTEGRATED VALUE ACCESS

Platform license inclusion

Perception REST API is fully bundled inside our premium seat plans. Zero usage markup.

INTELLIGENCE SEAT LICENSE

$499 / month per seat

14-Day Free Trial (No Credit Card Required)

Includes full high-velocity REST API Feed access
Includes all 31 Perception MCP Gateway tools (Claude, Cursor, Jupyter)
Includes full live sentiment anomalies and Pulse sentiment dashboards

Activate Your Seat

Enterprise configurations and custom private servers available in-app.