BTC Intel Score statistics
get_score_statisticsUse for a summary of the record: the historical position (the share of recorded days below and above the latest reading), mean, median and range, days per 10-point band, the share of days per classification, and counts of stretches and moves between classifications. Choose it to see how unusual a reading is; for the stretches themselves use get_classification_history, for daily values get_score_history, for recent change get_score_momentum. 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 per answer, no subscription: the first call returns an invoice instead of data (steps under payment). The historical position describes where today's Score sits in the record, not what comes next.
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_statistics"
}
}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 of the range for the mean, median, range, bands and shares, YYYY-MM-DD, included. Default: the start of the record. The historical position and the current classification always use the whole record. | |
| live | No | true: data through the latest published day, paid ($0.25). Omit or false: the free answer, through the Delayed date. | |
| 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 |
|---|---|---|---|
| link | Yes | ||
| note | Yes | ||
| 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 | ||
| through | No | ||
| price_usd | No | ||
| basis_note | No | ||
| score_note | No | ||
| statistics | No | ||
| attribution | Yes | ||
| delayed_through | No | The Delayed date: free answers stop here | |
| payment_required | No |