CoinGecko Category Snapshot

For each CoinGecko category ID, pull the full coin list with prices, market caps, 24h volume + change, supply, and ATH/ATL. One row per coin. Public API, no auth.

What you get

{
  "category":            "layer-1",
  "vsCurrency":          "usd",
  "snapshotAt":          "2026-06-02T10:45:11+00:00",
  "id":                  "bitcoin",
  "symbol":              "btc",
  "name":                "Bitcoin",
  "image":               "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png",
  "currentPrice":        69552,
  "marketCap":           1393658679511,
  "marketCapRank":       1,
  "fdv":                 1393658679511,
  "totalVolume":         55519986061,
  "high24h":             72665,
  "low24h":              69294,
  "priceChange24h":      -3109.91,
  "priceChangePct24h":   -4.28,
  "marketCapChange24h":  -62206924319,
  "circulatingSupply":   20037803,
  "totalSupply":         20037803,
  "maxSupply":           21000000,
  "ath":                 108342,
  "athChangePct":        -35.81,
  "athDate":             "2025-12-17T20:34:31.000Z",
  "atl":                 67.81,
  "atlChangePct":        102484.21,
  "atlDate":             "2013-07-06T00:00:00.000Z",
  "lastUpdated":         "2026-06-02T10:45:00.000Z"
}

How to use

Input. A list of category IDs.

{
  "categories":          ["layer-1", "meme-token", "defi"],
  "vsCurrency":          "usd",
  "maxCoinsPerCategory": 250,
  "include24hChange":    true
}

Get the full category list (~800 entries) from https://api.coingecko.com/api/v3/coins/categories/list. Common ones:

Category ID	What
layer-1	Base-layer blockchains (BTC, ETH, SOL, …)
defi	DeFi tokens
meme-token	Meme/community coins
ethereum-ecosystem	ERC-20 tokens
solana-ecosystem	SPL tokens
gaming	GameFi
real-world-assets-rwa	RWA narrative
liquid-staking-tokens	LSTs

Pricing

Pay per event. Price per 1,000 events:

Event	Base price	Bronze	Silver	Gold
CoinGecko coin snapshot row	$0.10	$0.09	$0.08	$0.07

Bronze, Silver and Gold are the discounts Apify gives users of its paid plans. The Pricing tab always shows the current prices.

Buyer

• Crypto traders running daily sector-rotation reports.
• Researchers building category-bound dashboards.
• Anyone who currently copy-pastes from coingecko.com into a sheet.

Run it through the API

Python, with the apify-client package:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("v0iddo/coingecko-category-snapshot").call(run_input={"categories": ["layer-1", "meme-token"], "maxCoinsPerCategory": 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript, with the apify-client package:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('v0iddo/coingecko-category-snapshot').call({"categories": ["layer-1", "meme-token"], "maxCoinsPerCategory": 20});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

One HTTP call that waits for the run and returns the rows (for runs that finish within 5 minutes):

curl -X POST "https://api.apify.com/v2/acts/v0iddo~coingecko-category-snapshot/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"categories": ["layer-1", "meme-token"], "maxCoinsPerCategory": 20}'

Use it from an agent (MCP)

Claude, Cursor, VS Code and other MCP clients can call this actor as a tool through the Apify MCP server. Add it to the client's MCP configuration:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=v0iddo/coingecko-category-snapshot",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

FAQ

Do I need an account, cookies or an API key?

No. The actor reads public data without logging in. You only need an Apify account to start it.

How many results can one run return?

Set Max coins per category (up to 10,000) to the number you need. Large jobs can also be split into several runs or scheduled.

How am I charged?

Pay per event, at the prices on the Pricing tab for your Apify plan (the Pricing section of this page lists them). The platform usage of the run is included in those prices, and your spending limit for a run is always respected.

Why did my run return no results?

The status message and the log of the run say why: usually nothing matched the input, or the source did not answer for a moment. Check the input against the example above and run it again.

Can I run it on a schedule?

Yes. Save your input as a task and add a schedule in the Apify Console (daily, hourly or with a cron expression). Each run gets its own dataset, so you keep a history.

Which formats can I export?

JSON, CSV, Excel, XML, HTML table and RSS from the Output tab or the API. Integrations send the rows to Google Sheets, Slack, Make, Zapier, n8n or a webhook.

Is collecting this data allowed?

The actor collects data that the source publishes openly, without a login. Public data can still be personal data under laws such as the GDPR, and sources have their own terms: make sure your use of the data follows the rules that apply to you.

What happens when the source changes?

An automated test runs the actor every day on the example input and checks the rows, not only that the run finished. When a check fails, the actor is repaired and rebuilt; the build history on this page shows each update.

Something is missing or wrong. Where do I report it?

Open an issue on the Issues tab of this actor with the run link. Requests for a new field are welcome too.

Related actors

• DefiLlama Scraper: Protocol TVL by Chain and Category
• JetBrains Marketplace Plugin Scraper
• App Store Scraper: App Details, Ratings, Prices
• App Store Search Scraper: Apps by Keyword
• App Store Top Charts Scraper: Ranks by Country and Genre
• Chrome Web Store Scraper: Extension Details and Ratings

Source

https://api.coingecko.com/api/v3/coins/markets: CoinGecko's public tier. Soft cap ~10-30 calls/minute; actor paces 1s between pages.