> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/finance-and-accounting/coinmarketcap/data-overview.md).

# Data Overview

CoinMarketCap provides structured market data across five entities in Coupler.io. You can pull live snapshots or historical intervals depending on your API plan and the data type you select.

## Entities

| Entity     | Best for                                            |
| ---------- | --------------------------------------------------- |
| Listings   | Market-wide ranking tables and cap/volume overviews |
| Quotes     | Targeted price monitoring for specific coins        |
| Categories | Sector-level analysis (DeFi, NFT, Layer 2, etc.)    |
| Fiats      | Fiat reference rates for currency conversion        |
| Exchanges  | Exchange volume comparisons and market structure    |

## Available data fields

#### Listings

| Field                          | Description                    |
| ------------------------------ | ------------------------------ |
| id                             | CoinMarketCap internal coin ID |
| name                           | Full cryptocurrency name       |
| symbol                         | Ticker symbol (e.g., BTC, ETH) |
| cmc\_rank                      | Current CoinMarketCap ranking  |
| price                          | Current price in USD           |
| market\_cap                    | Total market capitalization    |
| volume\_24h                    | 24-hour trading volume         |
| percent\_change\_1h / 24h / 7d | Price change percentages       |
| circulating\_supply            | Coins currently in circulation |
| total\_supply                  | Total issued supply            |
| last\_updated                  | Timestamp of last data update  |

#### Quotes

| Field                                | Description                     |
| ------------------------------------ | ------------------------------- |
| symbol                               | Requested cryptocurrency symbol |
| price                                | Current price                   |
| volume\_24h                          | 24-hour volume                  |
| market\_cap                          | Market capitalization           |
| percent\_change\_1h / 24h / 7d / 30d | Multi-timeframe price changes   |
| fully\_diluted\_market\_cap          | Market cap at max supply        |
| last\_updated                        | Data freshness timestamp        |

#### Categories

| Field                   | Description                                    |
| ----------------------- | ---------------------------------------------- |
| id                      | Category ID                                    |
| name                    | Category name (e.g., DeFi, Metaverse)          |
| title                   | Display title                                  |
| description             | Category description                           |
| num\_tokens             | Number of tokens in category                   |
| market\_cap             | Aggregate market cap for the category          |
| volume\_24h             | Aggregate 24h volume                           |
| avg\_price\_change\_24h | Average price change across tokens in category |

#### Fiats

| Field  | Description                          |
| ------ | ------------------------------------ |
| id     | Fiat currency ID                     |
| name   | Currency name                        |
| symbol | ISO currency symbol (e.g., USD, EUR) |
| sign   | Currency sign                        |

#### Exchanges

| Field              | Description                    |
| ------------------ | ------------------------------ |
| id                 | Exchange ID                    |
| name               | Exchange name                  |
| slug               | URL-friendly identifier        |
| num\_market\_pairs | Number of active trading pairs |
| volume\_24h        | Total 24h exchange volume      |
| last\_updated      | Timestamp of last update       |

## Common data combinations

* **Listings + Quotes** — use Coupler.io's **Join** transformation to enrich ranked listing data with real-time price quotes for your target coins
* **Quotes + Fiats** — combine quote prices with fiat rates to convert USD values into local currencies
* **Quotes (multiple symbols)** — use **Append** to pull quotes from multiple separate data flows (e.g., by asset class) into one unified table
* **Categories + Listings** — join category tags onto individual coin listings for sector-level filtering in your dashboard

## Use cases by role

{% tabs %}
{% tab title="Crypto analysts" %}

* Pull **Listings** daily into a Google Sheet to track rank movements and identify coins gaining or losing momentum
* Use **Quotes** with specific symbols to monitor a custom watchlist and compare 1h/24h/7d changes side by side
* Feed quotes data into ChatGPT or Claude for automated market commentary
  {% endtab %}

{% tab title="Finance teams" %}

* Use **Fiats** to maintain up-to-date conversion rates alongside crypto holdings
* Pull **Listings** into BigQuery to build historical snapshots of market cap and volume over time
* Combine exchange data with internal trading records to reconcile volumes
  {% endtab %}

{% tab title="Researchers & developers" %}

* Use **Categories** to segment the market by sector and track aggregate DeFi or Layer 2 performance
* Pull **historical** data type for OHLCV analysis and backtesting (requires paid API plan)
* Send structured market data to Cursor or Perplexity for research summaries and trend detection
  {% endtab %}
  {% endtabs %}

## Platform-specific notes

* The **Quotes** entity requires at least one cryptocurrency symbol — leave it blank and the sync will fail
* Symbol input is case-insensitive but must match CoinMarketCap's recognized tickers exactly
* The **historical** data type returns OHLCV interval data and is only available on paid CoinMarketCap API plans
* CoinMarketCap data is quoted in USD by default; use **Fiats** data to handle multi-currency conversion in your destination
* The free Basic API tier has strict call limits — avoid scheduling very frequent refreshes if you're on this plan


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/finance-and-accounting/coinmarketcap/data-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.