BTC Intel

Use for one named area of the market ("how is on-chain?", "what is liquidity saying?"), as its Analysis page shows it today: the read, how confident it is and when it last changed, the read by horizon (days, weeks, months), the reasoning in plain English (what holds it up, what could change it) and the state of each of its parts. Areas: technical, on-chain, market-structure, sentiment and macro (the five areas of the read), and cross-market (how the five line up), liquidity (the price levels where forced buying and selling sit, funding and the next big options expiry) and cycle (where Bitcoin is in its four-year cycle). For every area at once with the price and the forces use get_bitcoin_today; for the parts of all five areas side by side get_market_detail. Free.

Use for "what is Bitcoin doing and why", first: one morning briefing from BTC Intel's published Brief and Full Read. It gives the price now with its 24-hour, 3-day and 12-month moves and the distance from the cycle high; the market read in one sentence; the five areas (Technical, On-chain, Market structure, Sentiment, Macro) with each one's reason and last change; the forces moving the market, each with the figures behind it (for example stablecoin supply, funding, ETF flows, VIX); what changed today, this week and this month; what would change the read; and the events coming up. detail "full" adds the full reasoning and 14 days of calendar instead of 7. For the calendar alone use get_calendar, for one area in depth get_area, for the BTC Intel Score get_score_for_day. The Brief is published at 6 AM ET; the price is rolling. Free.

Use for the events ahead that can move Bitcoin: macro releases (CPI, jobs, the Fed), options expiries, the difficulty adjustment and Bitcoin dates, each with its date, Eastern time and one line on why it matters. Example: days 3 lists what lands before the weekend. For today's read and its forces use get_bitcoin_today. Free.

Use for the periods the Score spent in each classification (Low, Moderate-low, Neutral, Elevated, High): the start, end and length in days of each, newest first, 100 a page, each marked live or backtested. Choose it to see when a classification last held and for how long; for daily values use get_score_history, for shares and counts across the record get_score_statistics. 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).

Use for the five market areas broken into their published components: each area (Technical, On-chain, Market structure, Sentiment, Macro) with its state on the five-step scale (Adverse, Cautionary, Neutral, Constructive, Supportive), explanation, last change and edition time, and its components (26 in all), each with its state and position. Choose it for component-level detail; for today's read with its forces use get_bitcoin_today, for one area in depth get_area; for the live Score with the five areas use get_score_live. Free. The published market read, as on the Analysis pages. The market components describe the published market read. The BTC Intel Score is computed separately.

Use for definitions, not data: what the Score is, its five classifications, the record's dates, how it is published and checked, and what live, backtested, historical position and the Delayed date mean. The method itself is private. For Score values use get_score_for_day or get_score_live; for the Intel DCA rules get_plan_rules. Free, no arguments; one text document.

Use for the published Intel DCA ladder: what each plan (Defensive, Balanced, Growth) does on payday in each Score band (buy, save, or sell a set share once), word for word from btcintel.org/intel-dca/, with the notes under the ladder. Example: plan Balanced with score 34 returns the 20 to 39 band of the Balanced plan and its payday action there. Rules only: no personal plan, no advice, no backtest. For the Score to read the ladder against use get_score_for_day or get_score_live; for what the classifications mean get_methodology. Free.

Use for a past day's record, by date: the Full Read and the five market areas with their state words (Adverse, Cautionary, Neutral, Constructive or Supportive) as stored that day, and for the latest stored day the Brief's headline. Choose it to look up what the read was on a given day; for today use get_bitcoin_today, for the areas' 26 components get_market_detail, for the Score get_score_for_day. The stored reads begin in October 2026, so free answers start in early January 2027. Free through the Delayed date (the free cut-off, three months before the latest published day). A later date, or live = true for the latest day with its headline, 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).

Use for the Score on one day: its value (0–100), its classification (Low, Moderate-low, Neutral, Elevated or High) and whether the day is live or backtested (daily since July 18, 2011, backtested with the current method before live publication). Choose it for a single day; for today's Score with its historical position and the five market areas use get_score_live, for a run of days 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 day, 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).

Use 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.

Use for today's complete live picture in one paid call: the latest published BTC Intel Score (0–100) and its classification, its historical position (the share of recorded days below and above it, daily since July 2011, backtested with the current method before live publication), and the five market areas (Technical, On-chain, Market structure, Sentiment, Macro), each with its state, position on the five-step scale and last change. Not for a past day (use get_score_for_day), a range of days (get_score_history), statistics (get_score_statistics) or the market areas alone (free: get_bitcoin_today or get_market_detail). Context, not a forecast. $0.25 per call in bitcoin over Lightning, one payment per answer, no subscription: the first call returns an invoice instead of data (steps under payment). Research, not investment advice.

Use for recent change: how many points the Score moved over 1, 7, 30 and 90 days, and how many days it has held its current classification. Choose it to see whether the Score is rising or falling; for the values themselves use get_score_history, for averages and distributions get_score_statistics, for past classification periods get_classification_history. Free through the Delayed date (the free cut-off, three months before the latest published day). live = true reaches the latest published day and 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). Changes describe the past, not what comes next.

Use 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.