BASE URL:api.perception.to

PERCEPTION DATA · REST API + MCP

Digital asset context through one API

Query companies, coverage, statements, and sentiment from your application. Use a paid API key for authenticated endpoints, or try the public index below.

Thousands

of Curated Sources

90s

Update Frequency

REST Endpoints

MCP Tools

Start with Free MCP

Connect Perception data to your research tools.

/index

Live outlet-weighted sentiment index with decomposed drivers and velocity. Open, no key required.

/v1/feed

Programmatic full-text database query across thousands of vetted crypto media outlets and RSS feeds.

/v1/trends

Exposes AI-extracted narrative clusters, signal strength changes, and coverage volume deltas.

/v1/fear-greed-index

Natural language sentiment index computed from natural language briefs, bypassing price noise.

/v1/grouped-data

Entity recognition across a body of coverage: company mentions with counts and sentiment.

Claude · ChatGPT · Gemini · Cursor · VS Code · Hermes · OpenClaw · Claude Code

/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

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

Open the reference

DEVELOPER PLAYGROUND

Try a request and inspect the response

The public index response was captured on 8 September 2026. Other responses use placeholder content and numbers to explain the schema. Copy a request to query the endpoint.

Endpoints

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

Perception Index data feed

Read the public market sentiment index, its coverage window, and update time. Optional authenticated fields include divergence and historical context.

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

Choose API or MCP access

Perception at $249/mo includes the REST API and all 31 metered research tools at 20 included requests a day. Intelligence at $499/mo covers the same 31 research tools at 100 included requests a day, every accepted metered request using one included call. Free MCP covers all 31 research tools at five calls a day, no card. Taxonomy discovery is unmetered. Metered MCP adds prepaid weighted credits.

Metered MCP

All 31 metered tools with a prepaid wallet

10 credits for $19, 25 for $39, or 60 for $79. Successful calls commit their weighted request cost.

Start with Metered MCP

x402 full-text feed

$0.05 USDC per REST feed call

The x402 rail runs on Base mainnet and applies only to GET /feed. MCP tool access uses the plans and prepaid wallet.

Read the endpoint reference

INTELLIGENCE

$499 / month

Team workspace · $399/mo billed annually

100 MCP credits per day · Flat 1 credit per call

Full REST API access on its own daily pool, a flat 1 credit per call
Includes all 31 metered research tools plus unmetered taxonomy discovery (Claude, Cursor, Jupyter)
Includes the full Perception dashboard: sentiment, trends and entity intelligence

View Intelligence pricing

Internal and embedded systems use qualified implementation. Explore Perception Systems.