no key · no human
Home › API documentation › Every endpoint › GET /v1/btc/sentiment

GET /v1/btc/sentiment

News tone per period

bash
curl "https://freenewsapi.ai/v1/btc/sentiment"
response
{
 "from": "2026-09-27T13:25:04Z",
 "to": "2026-10-27T13:25:04Z",
 "interval": "day",
 "points": 31,
 "buckets": [
  {
   "time": "2026-09-27T00:00:00Z",
   "articles": 1091,
   "positive": 312,
   "neutral": 656,
   "negative": 123,
   "net": 189
  },
  {
   "time": "2026-09-28T00:00:00Z",
   "articles": 4796,
   "positive": 1391,
   "neutral": 2318,
   "negative": 1087,
   "net": 304
  },
  {
   "time": "2026-09-29T00:00:00Z",
   "articles": 4717,
   "positive": 1604,
   "neutral": 2168,
   "negative": 945,
   "net": 659
  },
  {
   "time": "2026-09-30T00:00:00Z",
   "articles": 4811,
   "positive": 1744,
   "neutral": 2191,
   "negative": 876,
   "net": 868
  },
  {
   "time": "2026-10-01T00:00:00Z",
   "articles": 4332,
   "positive": 1438,
   "neutral": 2059,
   "negative": 835,
   "net": 603
  },
  {
   "time": "2026-10-02T00:00:00Z",
   "articles": 4753,
   "positive": 1577,
   "neutral": 2322,
   "negative": 854,
   "net": 723
  },
  {
   "time": "2026-10-03T00:00:00Z",
   "articles": 3685,
   "positive": 731,
   "neutral": 2277,
   "negative": 677,
   "net": 54
  },
  {
   "time": "2026-10-04T00:00:00Z",
   "articles": 2960,
   "positive": 717,
   "neutral": 1763,
   "negative": 480,
   "net": 237
  },
  {
   "time": "2026-10-05T00:00:00Z",
   "articles": 4726,
   "positive": 1738,
   "neutral": 2379,
   "negative": 609,
   "net": 1129
  },
  {
   "time": "2026-10-06T0
…

Parameters

nametypedefaultmeaning
intervalstringdayhour | day | week
fromstring—Start
tostring—End, exclusive

No key, no header, no signup. Unknown query parameters are ignored, so adding one can never break a request. Errors are documented on the errors page.

As an MCP tool

The same endpoint is exposed to agents as news_get_btc_sentiment with the identical parameters — see the MCP server.

← all endpoints