BTC Intel Score history
get_score_historyUse for the raw daily series: one row per day with the Score, its classification and a live or backtested mark (daily since July 18, 2011, backtested with the current method before live publication), as JSON or CSV, 100 rows a page. Choose it to chart or export values; for one day use get_score_for_day, for summaries get_score_statistics, for classification periods get_classification_history. Free through the Delayed date (the free cut-off, three months before the latest published day). A later "to", or live = true, costs $0.25 in bitcoin over Lightning, one payment for every page of that query, no subscription: the first call returns an invoice instead of data (steps under payment). Example: from 2024-01-01, to 2024-03-31 and format csv return that quarter as one table; a range longer than a page comes back in parts, so repeat the same call with page = next_page until next_page is null.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_score_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last day, YYYY-MM-DD, included. Default: the Delayed date, or the latest published day with live = true. A day after the Delayed date is paid ($0.25). | |
| from | No | First day, YYYY-MM-DD, included. Default without from, to or page: the last 30 days of the free record, newest last; give from (for example 2011-07-18, the start) for an earlier range. | |
| live | No | true: data through the latest published day, paid ($0.25). Omit or false: the free answer, through the Delayed date. | |
| page | No | Page number, from 1 (default 1). A page is 100 rows; take next_page from the answer, null on the last page. | |
| export | No | true: the whole record through the latest published day, 1000 rows a page, $1.00 once for all its pages within 24 hours. Default false. | |
| format | No | json (default): rows as objects. csv: one text table with the header date,score,score_exact,level,change,pct_below,basis, for spreadsheets. | |
| payment | No | Omit on the first call: a paid request then returns a Lightning invoice (valid 10 minutes) and a macaroon instead of data. Pay it, then repeat the call with the same other arguments and payment = "<macaroon>:<preimage>" (the preimage your wallet shows once paid) within 24 hours. A used, expired or mismatched proof is refused with the reason; call again without payment for a new invoice. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| csv | No | ||
| from | No | ||
| link | Yes | ||
| note | Yes | ||
| page | No | ||
| rows | No | ||
| as_of | Yes | UTC: the last day the answer covers (YYYY-MM-DD), or for the Brief and methodology the time it was published (ISO 8601) | |
| pages | No | ||
| range | No | ||
| access | No | ||
| source | Yes | ||
| next_page | No | ||
| page_size | No | ||
| price_usd | No | ||
| basis_note | No | ||
| score_note | No | ||
| total_rows | No | ||
| attribution | Yes | ||
| delayed_through | No | The Delayed date: free answers stop here | |
| payment_required | No |