Get Bitcoin Rainbow Chart data: the bitcoin price and the values of the nine rainbow bands for each date, returned as positional arrays, with the full history in one response. Suitable for drawing the rainbow chart directly and seeing which band of the long-term logarithmic growth range the price is in.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on all API plans: Hobbyist Startup Standard Professional Enterprise
Response Data
data is an array; each element is the rainbow chart data for one date. Each element is a positional array with no field names and is read by position: [0] bitcoin price, [1] lowest shadow value, [2]–[10] bands 1 to 9, [11] timestamp (milliseconds). In the table below, data[].0 means the 1st position, data[].11 means the 12th position, and so on. [1]–[10] are in the same unit as the price (USD), and in the example they increase from [1] to [10]. Positions with missing data return null. This endpoint has no request parameters and returns the full history in one response: as of 2026-10-20 there are 6,183 records in total, each with 12 positions, and the response is about 940 KB, so we recommend caching it and using it as needed.
Missing values are returned as nullPositions with missing data return
null; they are not replaced with 0, and the array still keeps its 12 positions. When parsing, check each position for null, and do not assume thatnullonly appears in the earliest or the latest data.
200 · application/json · See the response example in the right panel.
| Field | Type | Always Returned | Description |
|---|---|---|---|
code | string | Yes | Business status code; "0" means success |
msg | string | No | Result message |
data | array of array | Yes | Array of rainbow chart data; each element is a positional array with 12 positions, and positions with missing data are null |
data[].0 | number | Yes | Position 0: bitcoin price, in USD; null when missing |
data[].1 | number | Yes | Position 1: lowest shadow value, in the same unit as the price; null when missing |
data[].2 | number | Yes | Position 2: band 1, in the same unit as the price; null when missing |
data[].3 | number | Yes | Position 3: band 2; null when missing |
data[].4 | number | Yes | Position 4: band 3; null when missing |
data[].5 | number | Yes | Position 5: band 4; null when missing |
data[].6 | number | Yes | Position 6: band 5; null when missing |
data[].7 | number | Yes | Position 7: band 6; null when missing |
data[].8 | number | Yes | Position 8: band 7; null when missing |
data[].9 | number | Yes | Position 9: band 8; null when missing |
data[].10 | number | Yes | Position 10: band 9; null when missing |
data[].11 | integer (int64) | Yes | Position 11: timestamp, in milliseconds (UTC) |
API Plans
All API plans can call this endpoint. For the price of each plan, see API Plans.
| API Plan | Access |
|---|---|
| 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.
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
| Scenario | Description |
|---|---|
| Draw the Rainbow Chart | Get the full history of the price and the nine bands in one request and draw the Bitcoin Rainbow Chart directly. |
| Identify the Price's Band | Compare the latest price with the band values to judge whether the price is in the lower or the upper part of the long-term growth range. |
| Long-Cycle Research | Review how the price moved between bands across past bull and bear cycles, as a reference for studying long-term cycles. |
| Market Dashboards | Display it on a dashboard together with cycle indicators such as Bull Market Peak Indicators. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Bitcoin Profitable Days | The price and a classification flag for every day in history |
| 200-Week Moving Average Heatmap | How the price relates to the 200-week moving average |
| Bitcoin Golden Ratio Multiplier | Price ranges based on multiples of a long-term moving average |
| Bitcoin Stock-to-Flow | Data related to the stock-to-flow model |
| Bull Market Peak Indicators | Current status of multiple cycle top indicators |
FAQ
Why does the data have no field names?
Each record is a positional array that is read by position: [0] price, [1] lowest shadow value, [2]–[10] bands 1 to 9, [11] millisecond timestamp. Read values by position, and do not assume there are field names such as price.
Is band 1 the lowest or the highest?
[2] is band 1 and [10] is band 9. In the example, the values increase from [1] to [10], i.e., band 1 is the lowest and band 9 the highest.
What should I do about null values?
Positions with missing data return null; they are not replaced with 0. When parsing, check each position for null: skip that point when plotting, and when determining which band the price is in, use a record in which neither the price nor any band value is null. Do not assume that null only appears in the earliest or the latest data.
Can I query only a recent period?
No. This endpoint has no request parameters and returns the full history on every call. If you need the last N days of data, filter it yourself by the millisecond timestamp at position [11] after you get the result; the data is only updated once a day, so there is no need to request it frequently.
Learn More: Bitcoin Rainbow Chart
What Is the Bitcoin Rainbow Chart?
On a logarithmic scale, the Bitcoin Rainbow Chart describes the price trend with a long-term growth curve fitted to bitcoin's historical prices, and draws several color bands above and below the curve, using different colors to show how high or low the price is relative to the long-term trend. It is an intuitive reference chart for long-term position.
How Is the Rainbow Chart Usually Read?
When the price is in the lower bands, it is usually seen as low relative to the long-term trend; when it is in the upper bands, it is seen as relatively high, with overheated market sentiment. The rainbow chart is only a fit to historical price action; it cannot predict prices and does not constitute investment advice.
What Are the Limitations of the Rainbow Chart?
The bands are fitted from historical data, and bitcoin's future growth rate will not necessarily continue at its past pace; the price may also stay in one band for a long time, or break through the outermost bands. It is therefore better suited as a reference for observing long-term position, and is best used together with other cycle indicators.
