REST API reference

Perception Index score, status, 24h/7d change, confidence and decomposed drivers. Updated every 15 minutes.

Open without a key. The open response uses no credits.

Open, no key. Add ?full=true with a Bearer token for divergences and returns by sentiment regime (1 credit).

Perception's five-index family: Perception Index, Bitcoin Discourse Dominance, Narrative Cost Basis, Cohort Conviction Gap and Perception Breadth.

Open without a key. The open response uses no credits.

Current headline readings are open. Add ?full=true with a Bearer token for methodology receipts, component breakdowns and bounded history (1 credit).

Earnings-call directness scores per company, with the verbatim quotes behind each score.

Open without a key. The open response uses no credits.

Open, no key.

Companies ranked by directness score.

Bearer authentication required. One REST call uses 1 credit.

Full directness detail for one company, including scored quotes.

Bearer authentication required. One REST call uses 1 credit.

Mention search across thousands of sources with full-text search, date, outlet and sentiment filters.

Bearer authentication required. One REST call uses 1 credit.

Also accepts x402 pay-per-call in USDC without a subscription, which is why an unkeyed request returns 402 rather than 401.

AI-extracted narrative trends with signal strength and the mentions behind each cluster.

Bearer authentication required. One REST call uses 1 credit.

Trend intelligence and category distribution.

Bearer authentication required. One REST call uses 1 credit.

Historical sentiment series, by day and by outlet.

Bearer authentication required. One REST call uses 1 credit.

Bitcoin Fear & Greed Index history.

Bearer authentication required. One REST call uses 1 credit.

Mention volume broken down by outlet and channel.

Bearer authentication required. One REST call uses 1 credit.

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

Bearer authentication required. One REST call uses 1 credit.

Sentiment split by the role of the speaker: execs, devs, analysts, investors, media and more.

Bearer authentication required. One REST call uses 1 credit.

Evade-o-Meter directness scoring across tracked companies.

Bearer authentication required. One REST call uses 1 credit.

Companies ranked by how directly management answers.

Bearer authentication required. One REST call uses 1 credit.

Evade-o-Meter detail for one company.

Bearer authentication required. One REST call uses 1 credit.

Rows from a Space you own, in the same shape as its CSV export. Cursor-paginated, 50 per page by default.

Bearer authentication required. One REST call uses 1 credit.

Returns 404 rather than 403 on a Space you do not own, so the API never confirms that someone else’s Space exists.

A Brain you own: the collected post history behind it.

Bearer authentication required. One REST call uses 1 credit.