no key · no human
HomeAPI documentationEvery endpointGET /v1/btc/sentiment

GET /v1/btc/sentiment

News tone per period

bash
curl "https://freenewsapi.ai/v1/btc/sentiment"
response
{
 "from": "2026-08-08T12:25:03Z",
 "to": "2026-09-07T12:25:03Z",
 "interval": "day",
 "points": 31,
 "buckets": [
  {
   "time": "2026-08-08T00:00:00Z",
   "articles": 25,
   "positive": 6,
   "neutral": 11,
   "negative": 8,
   "net": -2
  },
  {
   "time": "2026-08-09T00:00:00Z",
   "articles": 58,
   "positive": 23,
   "neutral": 18,
   "negative": 17,
   "net": 6
  },
  {
   "time": "2026-08-10T00:00:00Z",
   "articles": 397,
   "positive": 51,
   "neutral": 266,
   "negative": 80,
   "net": -29
  },
  {
   "time": "2026-08-11T00:00:00Z",
   "articles": 327,
   "positive": 103,
   "neutral": 136,
   "negative": 88,
   "net": 15
  },
  {
   "time": "2026-08-12T00:00:00Z",
   "articles": 269,
   "positive": 63,
   "neutral": 148,
   "negative": 58,
   "net": 5
  },
  {
   "time": "2026-08-13T00:00:00Z",
   "articles": 267,
   "positive": 76,
   "neutral": 134,
   "negative": 57,
   "net": 19
  },
  {
   "time": "2026-08-14T00:00:00Z",
   "articles": 309,
   "positive": 79,
   "neutral": 157,
   "negative": 73,
   "net": 6
  },
  {
   "time": "2026-08-15T00:00:00Z",
   "articles": 123,
   "positive": 33,
   "neutral": 55,
   "negative": 35,
   "net": -2
  },
  {
   "time": "2026-08-16T00:00:00Z",
   "articles": 98,
   "positive": 13,
   "neutral": 52,
   "negative": 33,
   "net": -20
  },
  {
   "time": "2026-08-17T00:00:00Z",
   "articles": 402,
   "positive": 73,
   "neutra
…

Parameters

nametypedefaultmeaning
intervalstringdayhour | day | week
fromstringStart
tostringEnd, 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