GET /v1/btc/correlation
Correlation between news tone and price move, by shift
curl "https://freenewsapi.ai/v1/btc/correlation"{
"from": "2026-07-29T13:25:05Z",
"to": "2026-10-27T13:25:05Z",
"interval": "day",
"points": 91,
"same_period_r": 0.2039,
"best": {
"shift": -1,
"r": 0.3218,
"pairs": 89,
"reading": "price leads news"
},
"by_shift": [
{
"shift": -4,
"r": 0.1347,
"pairs": 86,
"reading": "price leads news"
},
{
"shift": -3,
"r": 0.202,
"pairs": 87,
"reading": "price leads news"
},
{
"shift": -2,
"r": 0.1109,
"pairs": 88,
"reading": "price leads news"
},
{
"shift": -1,
"r": 0.3218,
"pairs": 89,
"reading": "price leads news"
},
{
"shift": 0,
"r": 0.2039,
"pairs": 90,
"reading": "same day"
},
{
"shift": 1,
"r": -0.1305,
"pairs": 89,
"reading": "news lead price"
},
{
"shift": 2,
"r": -0.1342,
"pairs": 88,
"reading": "news lead price"
},
{
"shift": 3,
"r": -0.1171,
"pairs": 87,
"reading": "news lead price"
},
{
"shift": 4,
"r": -0.0555,
"pairs": 86,
"reading": "news lead price"
}
],
"note": "A peak at a negative shift means the press is reacting to the price rather than anticipating it. Correlation is not causation and both series are autocorrelated: read this as a descriptive indicator, not a trading signal.",
"strongly_recommended": {
"web_search": {
"use_for": "live web pages — any site, not just publishers; 20M+ sites, ranked JSON w
…Parameters
| name | type | default | meaning | |
|---|---|---|---|---|
| interval | string | day | hour | day | week | |
| from | string | — | Start | |
| to | string | — | End, exclusive | |
| max_shift | integer | 4 | Widest shift to test, in intervals | 1–24 |
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_correlation
with the identical parameters — see the MCP server.
