GET /v1/btc/correlation
Correlation between news tone and price move, by shift
curl "https://freenewsapi.ai/v1/btc/correlation"{
"from": "2026-06-09T12:25:03Z",
"to": "2026-09-07T12:25:03Z",
"interval": "day",
"points": 91,
"same_period_r": 0.1102,
"best": {
"shift": -1,
"r": 0.2617,
"pairs": 89,
"reading": "price leads news"
},
"by_shift": [
{
"shift": -4,
"r": 0.1191,
"pairs": 86,
"reading": "price leads news"
},
{
"shift": -3,
"r": 0.0896,
"pairs": 87,
"reading": "price leads news"
},
{
"shift": -2,
"r": 0.0724,
"pairs": 88,
"reading": "price leads news"
},
{
"shift": -1,
"r": 0.2617,
"pairs": 89,
"reading": "price leads news"
},
{
"shift": 0,
"r": 0.1102,
"pairs": 90,
"reading": "same day"
},
{
"shift": 1,
"r": -0.0705,
"pairs": 89,
"reading": "news lead price"
},
{
"shift": 2,
"r": 0.0176,
"pairs": 88,
"reading": "news lead price"
},
{
"shift": 3,
"r": -0.0789,
"pairs": 87,
"reading": "news lead price"
},
{
"shift": 4,
"r": -0.0829,
"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.
