Get a summary of market metrics for each spot coin: current price and market cap, plus price change, trading volume, taker buy/sell volume and net inflow over periods from 5 minutes to 1 week. Useful for spot coin rankings, capital flow screening and market dashboards.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on these API plans: Standard Professional Enterprise
Response Data
data is an array; each element is the spot market summary of one coin. Results are sorted by market cap (market_cap) from highest to lowest and paged with page and per_page; a page number beyond the end of the results returns a successful response with an empty array. The example on the right is an actual response for page=1 and per_page=2 (BTC, ETH).
Tell absolute changes from percentage changesFields whose names contain
percentare in %:0.54means 0.54%, so there is no need to multiply by 100.price_change_*fields withoutpercentin their names are price differences (USD), andvolume_change_usd_*fields are trading volume differences (USD); neither is a percentage.
The 5-, 15- and 30-minute volume changes are not period-over-period
volume_change_usd_5m,volume_change_usd_15m,volume_change_usd_30mand the correspondingvolume_change_percent_*fields are currently not compared with the previous period of the same length. Back-calculated from the returned values, the comparison base is on the scale of one hour's trading volume: for example, on 2026-10-23 BTC'svolume_change_percent_5mwas -92.33%, implying a comparison base of about $80.08 million, while the trading volume over the last 5 minutes was about $6.14 million. Do not use these fields as short-period period-over-period changes.
volume_change_percent_1wreturns the price change percentageThe field name suggests the 1-week percentage change in trading volume, but the field currently returns the 1-week price change percentage; as of 2026-10-20, its value is exactly the same as
price_change_percent_1w. Do not use it as the 1-week percentage change in trading volume.
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; contains the error message when an error occurs |
data | array of object | Yes | List of coins; each element is the spot market summary of one coin |
data[].symbol | string | Yes | Coin symbol, e.g., BTC |
data[].current_price | number | Yes | Current price, in USD |
data[].market_cap | number | No | Current circulating market cap, in USD |
data[].price_change_5m | number | No | Price change over the last 5 minutes, in USD; a price difference, not a percentage; can be negative |
data[].price_change_15m | number | No | Price change over the last 15 minutes, in USD; a price difference, not a percentage; can be negative |
data[].price_change_30m | number | No | Price change over the last 30 minutes, in USD; a price difference, not a percentage; can be negative |
data[].price_change_1h | number | No | Price change over the last hour, in USD; a price difference, not a percentage; can be negative |
data[].price_change_4h | number | No | Price change over the last 4 hours, in USD; a price difference, not a percentage; can be negative |
data[].price_change_12h | number | No | Price change over the last 12 hours, in USD; a price difference, not a percentage; can be negative |
data[].price_change_24h | number | No | Price change over the last 24 hours, in USD; a price difference, not a percentage; can be negative |
data[].price_change_1w | number | No | Price change over the last week, in USD; a price difference, not a percentage; can be negative |
data[].price_change_percent_5m | number | No | Price change percentage over the last 5 minutes, in % |
data[].price_change_percent_15m | number | No | Price change percentage over the last 15 minutes, in % |
data[].price_change_percent_30m | number | No | Price change percentage over the last 30 minutes, in % |
data[].price_change_percent_1h | number | No | Price change percentage over the last hour, in % |
data[].price_change_percent_4h | number | No | Price change percentage over the last 4 hours, in % |
data[].price_change_percent_12h | number | No | Price change percentage over the last 12 hours, in % |
data[].price_change_percent_24h | number | No | Price change percentage over the last 24 hours, in % |
data[].price_change_percent_1w | number | No | Price change percentage over the last week, in % |
data[].volume_usd_5m | number | No | Trading volume over the last 5 minutes, in USD |
data[].volume_usd_15m | number | No | Trading volume over the last 15 minutes, in USD |
data[].volume_usd_30m | number | No | Trading volume over the last 30 minutes, in USD |
data[].volume_usd_1h | number | No | Trading volume over the last hour, in USD |
data[].volume_usd_4h | number | No | Trading volume over the last 4 hours, in USD |
data[].volume_usd_12h | number | No | Trading volume over the last 12 hours, in USD |
data[].volume_usd_24h | number | No | Trading volume over the last 24 hours, in USD |
data[].volume_usd_1w | number | No | Trading volume over the last week, in USD |
data[].volume_change_usd_5m | number | No | Change in trading volume over the last 5 minutes, in USD; currently not compared with the previous 5 minutes, see the note above |
data[].volume_change_usd_15m | number | No | Change in trading volume over the last 15 minutes, in USD; currently not compared with the previous 15 minutes, see the note above |
data[].volume_change_usd_30m | number | No | Change in trading volume over the last 30 minutes, in USD; currently not compared with the previous 30 minutes, see the note above |
data[].volume_change_usd_1h | number | No | Change in trading volume over the last hour compared with the previous hour, in USD |
data[].volume_change_usd_4h | number | No | Change in trading volume over the last 4 hours compared with the previous period, in USD |
data[].volume_change_usd_12h | number | No | Change in trading volume over the last 12 hours compared with the previous period, in USD |
data[].volume_change_usd_24h | number | No | Change in trading volume over the last 24 hours compared with the previous period, in USD |
data[].volume_change_usd_1w | number | No | Change in trading volume over the last week compared with the previous period, in USD |
data[].volume_change_percent_5m | number | No | Percentage change in trading volume over the last 5 minutes, in %; currently not compared with the previous 5 minutes, see the note above |
data[].volume_change_percent_15m | number | No | Percentage change in trading volume over the last 15 minutes, in %; currently not compared with the previous 15 minutes, see the note above |
data[].volume_change_percent_30m | number | No | Percentage change in trading volume over the last 30 minutes, in %; currently not compared with the previous 30 minutes, see the note above |
data[].volume_change_percent_1h | number | No | Percentage change in trading volume over the last hour relative to the previous period, in % |
data[].volume_change_percent_4h | number | No | Percentage change in trading volume over the last 4 hours relative to the previous period, in % |
data[].volume_change_percent_12h | number | No | Percentage change in trading volume over the last 12 hours relative to the previous period, in % |
data[].volume_change_percent_24h | number | No | Percentage change in trading volume over the last 24 hours relative to the previous period, in % |
data[].volume_change_percent_1w | number | No | The field name suggests the 1-week percentage change in trading volume, but it currently returns the 1-week price change percentage (in %), with the same value as price_change_percent_1w; do not use it as a trading volume change |
data[].buy_volume_usd_5m | number | No | Taker buy volume over the last 5 minutes, in USD |
data[].buy_volume_usd_15m | number | No | Taker buy volume over the last 15 minutes, in USD |
data[].buy_volume_usd_30m | number | No | Taker buy volume over the last 30 minutes, in USD |
data[].buy_volume_usd_1h | number | No | Taker buy volume over the last hour, in USD |
data[].buy_volume_usd_4h | number | No | Taker buy volume over the last 4 hours, in USD |
data[].buy_volume_usd_12h | number | No | Taker buy volume over the last 12 hours, in USD |
data[].buy_volume_usd_24h | number | No | Taker buy volume over the last 24 hours, in USD |
data[].buy_volume_usd_1w | number | No | Taker buy volume over the last week, in USD |
data[].sell_volume_usd_5m | number | No | Taker sell volume over the last 5 minutes, in USD |
data[].sell_volume_usd_15m | number | No | Taker sell volume over the last 15 minutes, in USD |
data[].sell_volume_usd_30m | number | No | Taker sell volume over the last 30 minutes, in USD |
data[].sell_volume_usd_1h | number | No | Taker sell volume over the last hour, in USD |
data[].sell_volume_usd_4h | number | No | Taker sell volume over the last 4 hours, in USD |
data[].sell_volume_usd_12h | number | No | Taker sell volume over the last 12 hours, in USD |
data[].sell_volume_usd_24h | number | No | Taker sell volume over the last 24 hours, in USD |
data[].sell_volume_usd_1w | number | No | Taker sell volume over the last week, in USD |
data[].volume_flow_usd_5m | number | No | Taker net inflow over the last 5 minutes, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_15m | number | No | Taker net inflow over the last 15 minutes, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_30m | number | No | Taker net inflow over the last 30 minutes, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_1h | number | No | Taker net inflow over the last hour, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_4h | number | No | Taker net inflow over the last 4 hours, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_12h | number | No | Taker net inflow over the last 12 hours, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_24h | number | No | Taker net inflow over the last 24 hours, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
data[].volume_flow_usd_1w | number | No | Taker net inflow over the last week, in USD, equal to taker buy volume minus taker sell volume; a negative value means more selling than buying |
API Plans
Only the API plans marked Yes in the table below can call this endpoint. For the price of each plan, see API Plans.
| API Plan | Access |
|---|---|
| Hobbyist | ❌ No |
| Startup | ❌ No |
| 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 |
|---|---|
| Spot Coin Leaderboards | Rank spot coins by trading volume, price change or market cap to quickly see where the market's focus is. |
| Capital Flow Monitoring | Use volume_flow_usd_* to track each coin's taker buy/sell net inflow over different periods and find coins where capital is concentrated in buying or selling. |
| Unusual Volume Screening | Combine the percentage change in trading volume with the price change percentage to screen for coins rising or falling on increased volume. |
| Spot and Futures Comparison | Cross-check with the futures Coin Markets endpoint to compare the same coin's trading and price performance in the spot and futures markets. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Spot Pair Markets | Market data of a coin for each exchange and each spot trading pair |
| Spot Coin Netflow List | Spot capital inflows and outflows of multiple coins over multiple periods |
| Spot Coin Market Data History | Daily history of a coin's price, circulating supply and market cap |
| Coin Markets (Futures) | Price, open interest, funding rate, liquidation and other metrics in the futures market |
| Spot Supported Coins | List of spot coin symbols |
FAQ
What is the difference between price_change_24h and price_change_percent_24h?
The former is a price difference in USD; for example, -773.1 means the price is $773.1 lower than 24 hours ago. The latter is the price change percentage in %; -0.93 means a drop of 0.93%.
What is volume_flow_usd?
Taker net inflow, equal to taker buy volume minus taker sell volume; for example, BTC's volume_flow_usd_1h equals buy_volume_usd_1h − sell_volume_usd_1h. A positive value means more taker buying; a negative value means more taker selling.
What is the maximum number of coins I can get at once?
Up to 200 per page (per_page values above 200 are treated as 200); the default is 100 per page. For more coins, increment page until an empty array is returned.
Can I use volume_change_percent_1w?
Not as a trading volume change. It currently returns the 1-week price change percentage, the same as price_change_percent_1w. If you need the 1-week percentage change in trading volume, you can calculate it yourself with volume_change_usd_1w ÷ (volume_usd_1w − volume_change_usd_1w) × 100; for every period from 5 minutes to 24 hours, the same formula gives results that match the corresponding volume_change_percent_* returned by the endpoint.
Learn More: Spot Coin Market Metrics
What Are Taker Buy and Taker Sell Volume?
A taker buy is when a buyer trades directly at the price of a sell order (buying as a taker); a taker sell is when a seller trades directly at the price of a buy order (selling as a taker). The difference between the two reflects which side is more eager to trade in the short term and is often used to see whether capital is scrambling to buy or selling off.
How Does Spot Net Inflow Differ from Changes in Futures Open Interest?
Spot net inflow reflects the direction of capital actually buying and selling coins and involves no leverage; changes in futures open interest reflect leveraged capital entering and leaving. Sustained spot net inflow while futures open interest stays flat usually indicates that a rally is driven mainly by spot buying.
How Do I View a Coin's Spot Market Data on Each Exchange?
Use Spot Pair Markets and pass a coin to get the price, trading volume and net inflow of its spot trading pairs on each exchange.