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

GET /v1/btc/series

Price and news tone aligned on one timeline

bash
curl "https://freenewsapi.ai/v1/btc/series"
response
{
 "from": "2026-08-08T12:25:03Z",
 "to": "2026-09-07T12:25:03Z",
 "interval": "day",
 "points": 31,
 "series": [
  {
   "time": "2026-08-08T00:00:00Z",
   "open": 65008.33,
   "high": 65192.54,
   "low": 64936.01,
   "close": 64962.6,
   "return_pct": null,
   "articles": 25,
   "positive": 6,
   "neutral": 11,
   "negative": 8,
   "net": -2,
   "direction": "flat"
  },
  {
   "time": "2026-08-09T00:00:00Z",
   "open": 64962.6,
   "high": 65474.46,
   "low": 64730.08,
   "close": 64901.59,
   "return_pct": -0.094,
   "articles": 58,
   "positive": 23,
   "neutral": 18,
   "negative": 17,
   "net": 6,
   "direction": "diverges"
  },
  {
   "time": "2026-08-10T00:00:00Z",
   "open": 64901.59,
   "high": 65391.14,
   "low": 63806.27,
   "close": 63970.01,
   "return_pct": -1.435,
   "articles": 397,
   "positive": 51,
   "neutral": 266,
   "negative": 80,
   "net": -29,
   "direction": "agrees"
  },
  {
   "time": "2026-08-11T00:00:00Z",
   "open": 63970.01,
   "high": 64515.43,
   "low": 63238.0,
   "close": 63600.0,
   "return_pct": -0.578,
   "articles": 327,
   "positive": 103,
   "neutral": 136,
   "negative": 88,
   "net": 15,
   "direction": "diverges"
  },
  {
   "time": "2026-08-12T00:00:00Z",
   "open": 63600.01,
   "high": 64500.0,
   "low": 63310.34,
   "close": 63479.99,
   "return_pct": -0.189,
   "articles": 269,
   "positive": 63,
   "neutral": 148,
   "negative":
…

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_series with the identical parameters — see the MCP server.

← all endpoints