coinbase.com APIcoinbase.com ↗
Access Coinbase cryptocurrency market data via API. Get top gainers, top losers, and ranked coin listings with price changes across hour, day, week, month, and year.
curl -X GET 'https://api.parse.bot/scraper/48ffd0a1-24c2-4fc7-ac88-1b9966606c10/get_top_gainers?limit=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Get coins with the highest percent change, sorted by biggest gainers first. Returns price, percent changes across multiple time periods, market cap, and volume for each coin.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of coins per page. |
| filter | string | Filter type: all or listed. |
| currency | string | Quote currency for prices (e.g. USD, EUR). |
| resolution | string | Time period for sorting by percent change: hour, day, week, month, or year. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"sort": "string, sort field used",
"coins": "array of coin objects with name, symbol, slug, id, price, percent changes, market_cap, volume_24h, image_url, rank",
"limit": "integer, requested page size",
"order": "string, sort order used",
"resolution": "string, time resolution used",
"total_returned": "integer, number of coins returned in this page"
},
"sample": {
"data": {
"page": 1,
"sort": "percent_change",
"coins": [
{
"id": "36ac1aca-afde-4e8e-a878-992c1acc9636",
"name": "Polkadot",
"rank": 9999999,
"slug": "hyperbridge-bridged-dot",
"price": "1.3172045982028577",
"symbol": "DOT",
"currency": "USD",
"image_url": "https://asset-metadata-service-production.s3.amazonaws.com/asset_icons/c27fa9cc2405df4f48a821b79ad0f99f39ca42ebd462cab97b377b2fd0da2cc5.jpeg",
"market_cap": "0.00000000361774807870468041500187006",
"volume_24h": "14",
"percent_change_day": 370046800000000000,
"percent_change_hour": -0.0012627229,
"percent_change_week": 370046800000000000,
"percent_change_year": -0.7858596,
"percent_change_month": 0.06963887
}
],
"limit": 10,
"order": "desc",
"resolution": "day",
"total_returned": 10
},
"status": "success"
}
}About the coinbase.com API
This API exposes cryptocurrency market data from Coinbase across 3 endpoints, returning price, market cap, 24-hour volume, and percent changes over five time periods for each coin. The get_top_gainers endpoint surfaces coins sorted by largest positive price movement, while get_top_losers returns the worst performers, and list_coins provides a fully sortable paginated catalog of the broader market.
What the API Returns
All three endpoints return the same core coin object structure: name, symbol, slug, id, price, market_cap, volume_24h, image_url, rank, and percent change fields spanning hour, day, week, month, and year intervals. The currency parameter lets you denominate prices in USD, EUR, or other quote currencies. Each response includes pagination metadata — page, limit, total_returned, sort, order, and resolution — so you can reliably walk through large result sets.
Endpoint Breakdown
get_top_gainers and get_top_losers are pre-sorted views focused on directional price movement. Both accept a resolution parameter (hour, day, week, month, year) to control which time window determines the ranking, and a filter parameter (all or listed) to narrow scope. list_coins is the general-purpose endpoint: it accepts an explicit sort field (rank, percent_change, market_cap, or volume) and an order field (asc or desc), making it suitable for building ranked tables or screeners sorted by any combination.
Pagination and Filtering
All three endpoints support page and limit parameters. Iterating pages with a consistent limit value and checking total_returned against limit is a straightforward way to determine when you have reached the last page. The filter parameter distinguishes between all tracked coins and only those actively listed on Coinbase, which matters when you want exchange-tradeable assets specifically versus broader market coverage.
- Build a real-time crypto dashboard showing the top 10 daily gainers and losers by percent change
- Screen for coins with the highest weekly volume to identify trending assets
- Construct a market cap-ranked leaderboard using
list_coinssorted bymarket_capdescending - Alert system that monitors
get_top_losersover thehourresolution to flag sudden price drops - Filter Coinbase-listed coins only to display a tradeable watchlist with current prices in EUR
- Track rank changes over time by periodically calling
list_coinssorted byrankand storing snapshots - Compare monthly versus yearly percent change fields to identify coins recovering from longer-term downtrends
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Coinbase have an official developer API?+
What does the `resolution` parameter control, and how does it affect `get_top_gainers`?+
resolution parameter selects which time window's percent change is used for sorting. Passing resolution=hour ranks coins by their price movement in the last hour, while week ranks by seven-day performance. The response still includes percent change values for all five periods (hour, day, week, month, year) regardless of which resolution drives the sort order.What is the difference between `filter=all` and `filter=listed`?+
filter=listed restricts results to coins actively listed for trading on Coinbase. filter=all includes a broader set of tracked coins that may not be directly tradeable on the exchange. If you are building a tool for Coinbase users who need to act on the data, listed is the more relevant filter.Does the API return historical OHLCV candlestick data or order book depth?+
Are individual coin detail pages — like description, circulating supply, or all-time high — included?+
name, symbol, slug, id, price, market_cap, volume_24h, image_url, rank, and percent change fields. Fields like circulating supply, total supply, all-time high price, or project descriptions are not in the current response shape. You can fork this API on Parse and revise it to pull those fields from a coin detail endpoint.