Perception Beta closes July 15. Lock in the Intelligence Plan for $499/mo for life before rates transition to $799/mo.Lock in rate

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

Production Endpoints

99.9%

Feed Uptime

Start 14-Day Free Trial

/v1/stream

/v1/feed

/v1/trends

/v1/fear-greed-index

/v1/alerts

Perception API Gateway

SGET /v1/stream

200 OK

TGET /v1/trends

200 OK

#POST /v1/alerts

ROUTING

FGET /v1/feed

429 LIMIT

GGET /v1/fear-greed

200 OK

Claude

ChatGPT

Gemini

Cursor

VS Code

Hermes

OpenClaw

Claude Code

DEVELOPER PLAYGROUND

Query un-sanitized real-time JSON.

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 regime forward returns by adding a Bearer token and "?full=true" parameter.

curl "https://api.perception.to/index"

Query Parameters Schema

Field	Type	Required	Description
full	boolean	optional	Include divergence metrics and forward returns regime analytics (requires Bearer token authentication).
date	string (YYYY-MM-DD)	optional	Query historical index value for a specific UTC date.

DATA STRUCTURING FORMAT

Article & Mention Schema

Every ingestion node inside the database aligns strictly to this schema object structure.

Field Name	Type Format	Description Scope
`Title`	string	Article headline, or @handle for tweets
`Content`	string	Full article text or tweet body
`Date`	string (ISO 8601)	Publication timestamp, UTC
`URL`	string	Source URL
`Outlet`	string	Source name (e.g. Bloomberg, X, CoinDesk)
`Sentiment`	string	Positive, Neutral, or Negative
`Outlet_Category`	string	Crypto Media, Financial Media, Social Media, Regulatory, Podcast, GitHub
`author_name`	string \| null	Author name (media articles only)
`image_url`	string \| null	Article thumbnail or OG image

WIDGET INTEGRATION

Embeddable Javascript Widget

Add a live, responsive Perception Index card directly to your website or blog. Simply copy and paste the snippet below.

HTML Snippet

<!-- Step 1: Add the container where the widget should render -->
<div class="perception-index-widget" data-theme="dark" data-drivers="true"></div>

<!-- Step 2: Include the widget script -->
<script src="https://perception.to/widgets/perception-index.js" defer></script>

Customization Attributes

Attribute	Options	Default	Description
`data-theme`	"dark" \| "light"	"dark"	Sets the visual theme of the card container.
`data-drivers`	"true" \| "false"	"true"	Controls the visibility of the sub-index drivers breakdown.

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 22 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.*

Get started View pricing