Skip to content
Sentiment API

Crypto sentiment API

Query the tone of company and topic coverage, then trace the result to its sources. REST access is included in paid plans; Free MCP includes five calls a day.

PerceptionSaved example · 8 Sep 2026

Read the current Perception Index from the public API.

A request you can run

Request
curl "https://api.perception.to/index"
Saved response · selected fields
{
  "score": 49,
  "status": "Neutral",
  "article_count_24h": 1918,
  "updated_at": "2026-09-08T16:45:16.965Z",
  "update_frequency_minutes": 15
}
    Open the source

    Selected fields from a captured API response. The endpoint returns the latest value when you run it.

    Condensed from cited sources

    Ask your own question with Perception connected to your AI. Connect Perception

    Make a sentiment-filtered request

    On a paid plan, filter matching coverage by its sentiment label. Inspect the source and publication date in each returned record.

    curl "https://api.perception.to/feed?keyword=bitcoin&sentiment=negative"   -H "Authorization: Bearer pcp_your_key_here"

    The public index example above shows an aggregate sentiment result. The authenticated feed endpoint returns article-level records and supports a sentiment filter; its response shape is documented in the reference.

    Open the endpoint reference

    Evaluate the data behind a sentiment API

    Check the source sample, observation window, sentiment definition, and missing-data behavior. Then inspect a returned record and its source.

    Confirm the endpoints and usage allowance for the plan your application needs. Use the same company and date range when evaluating providers.

    Compare sentiment workflows

    Use cases

    Common builds

    Company dashboards. Put coverage tone, volume, and the source list beside the company metrics your team reviews.

    Research notebooks. Query historical sentiment by outlet and date range into pandas, and backtest how coverage tone led or lagged price at previous cycle turns.

    Comms monitoring. Track sentiment on your own company and competitors, broken down by outlet, so you know which stories moved tone and which outlets to brief next.

    AI agents. Connect over MCP and let your assistant run the whole loop: search coverage, compare entities, check momentum, and draft the brief. No glue code.

    FAQ

    Frequently asked questions

    Is there free access to crypto sentiment data?

    Free access uses MCP with all 31 commercial tools at five calls a day. Taxonomy discovery is unmetered. Paid plans include authenticated REST API access.

    How do REST and MCP allowances work?

    MCP and REST use separate access and capacity rules. The Free allowance covers MCP. Paid plans include authenticated REST access.

    Is this social media sentiment?

    Primarily media sentiment: news, financial press, podcasts, research, filings. Social platforms are part of the source mix, and the product is built around the editorial layer. If you want social-only metrics like engagement counts, LunarCrush is the better fit.

    What does it cost after the free tier?

    Paid subscriptions include the Perception app and REST access. Check the current MCP and REST allowances on the pricing page.

    Get started

    Get a key and make your first call

    Create a Free account and run your first sentiment query with one of five daily MCP calls. No card required.