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

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

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

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

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