Bitcoin Bubble Index

Get daily historical data of the Bitcoin Bubble Index, along with the price, mining difficulty, transaction count and sending address count for each day. The endpoint takes no parameters and returns the full history since 2010 in one call.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Available on all API plans: Hobbyist Startup Standard Professional Enterprise

Response Data

data is an array; each element is one day's data. This endpoint has no request parameters and returns the full history at once: as of 2026-10-20, there are 5939 records in total, and the first is the earliest data point (2010-07-17). The example on the right keeps only the first 2.

📘

google_trend_percent and tweet_count Are Reserved Fields and May Not Be Returned

As of 2026-10-20, none of the 5939 data points contain the two fields google_trend_percent (Google Trends percentage) and tweet_count (tweet count). When they are missing, the fields are simply absent and are not replaced with 0. When reading, check whether the fields exist first, and do not rely on them.

200 · application/json · See the response example in the right panel.

FieldTypeAlways ReturnedDescription
codestringYesBusiness status code; "0" means success
msgstringNoResult message; not returned on success
dataarray of objectYesArray of daily data
data[].pricenumberYesBitcoin price on that day, in USD; values include both integers and decimals. The price returned by different indicator endpoints for the same day is not exactly the same; keep this in mind when merging data
data[].bubble_indexnumberYesBubble index value; can be negative
data[].google_trend_percentnumberNoGoogle Trends percentage. A reserved field that may not be returned: as of 2026-10-20, no data contains this field
data[].mining_difficultynumberYesBitcoin mining difficulty; values include both integers and decimals
data[].transaction_countintegerYesNumber of transactions; unit: transactions
data[].address_send_countintegerYesSending address count (the number of addresses that sent Bitcoin on that day); unit: addresses
data[].tweet_countnumberNoTweet count. A reserved field that may not be returned: as of 2026-10-20, no data contains this field
data[].date_stringstringYesDate string, format YYYY-MM-DD

API Plans

All API plans can call this endpoint. For the price of each plan, see API Plans.

API PlanAccess
Hobbyist✅ Yes
Startup✅ Yes
Standard✅ Yes
Professional✅ Yes
Enterprise✅ Yes

Use This Endpoint with AI

Pick a task and click Open in ChatGPT or Open in Claude: the AI reads this page first and then gives you the result. You can also click Copy and paste the full prompt into the AI tool you use.

Plot a trend chart with Python
Have AI write code that plots the bubble index and the Bitcoin price on one dual-axis chart.
Export to CSV
Have AI write a script that saves the bubble index and on-chain data as a CSV file.
Understand this endpoint
Have AI explain the response fields and what the bubble index means in plain language.

This endpoint provides data through the REST API. Use the prompts above to have AI write the request code. For the tools available through MCP, see CoinGlass MCP.

Use Cases

ScenarioDescription
Gauge Bubble LevelsPut the bubble index together with the price to observe how the index changed during past major rallies.
Get Basic On-Chain DataThe same endpoint also returns mining difficulty, transaction count and sending address count, which can be used directly as basic on-chain data.
Low-Barrier ResearchAll API plans can call it, which makes it suitable for personal research and small tools.
Charts for Research ReportsA single request returns the complete series since 2010, suitable for research reports and dashboards.

Related Endpoints

EndpointHow It Differs
Bitcoin AHR999 IndicatorMeasures the price position using the 200-day DCA cost and a long-term growth valuation
Bitcoin Active AddressesNumber of addresses taking part in transactions each day
Crypto Fear & Greed IndexMeasures overall market sentiment
Bull Market Peak IndicatorsCurrent and target values of multiple cycle indicators

FAQ

Are google_trend_percent and tweet_count always returned?

Not necessarily. These two are reserved fields that may not be returned; as of 2026-10-20, no data contains them. In your code, check whether the fields exist first, do not rely on them, and do not treat their absence as 0.

What format is date_string in?

YYYY-MM-DD, e.g., 2010-07-17. This endpoint has no millisecond timestamp field; Bitcoin AHR999 Indicator in the same section uses YYYY/MM/DD, so unify the formats before merging data.

Can the bubble index be negative?

Yes. Early data is negative (e.g., -29.6); a negative value does not mean the price is negative.

Can I query data for only a specific time period?

No. This endpoint has no parameters and always returns the full history (the response is about 940 KB); if you need a specific period, filter locally by date_string. We recommend caching the result and refreshing it as needed; there is no need to request it frequently.

Learn More: Bitcoin Bubble Index

What Is the Bitcoin Bubble Index?

The Bitcoin Bubble Index uses a single value to measure the degree of “bubble” in the Bitcoin price. Alongside the index, this endpoint also returns the price, mining difficulty, transaction count and sending address count for each day, making it easy to compare the index with the price and basic network data.

What Do Mining Difficulty, Transaction Count and Sending Address Count Represent?

Mining difficulty reflects how intense the competition for hash power is across the network: the higher the hash power, the higher the difficulty; transaction count is the number of on-chain transactions on that day; sending address count is the number of addresses that sent Bitcoin on that day. They are all basic data for measuring the scale and usage of the Bitcoin network.

Can the Bubble Index Alone Be Used to Identify a Top?

Not recommended. Any single indicator can fail; the bubble index is better used as one reference, together with other cycle indicators such as Bull Market Peak Indicators.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json