# CoinGecko Market Scraper (`exuberant_volley/coingecko-market-scraper`) Actor For dashboards, bots, and analysts who need a clean top-coins snapshot in their fiat before a report or alert. Price, market cap, rank, 24h volume/change, ATH/ATL. Official CoinGecko API. Free to run. - **URL**: https://apify.com/exuberant\_volley/coingecko-market-scraper.md - **Developed by:** [ScrapeForge](https://apify.com/exuberant_volley) (community) - **Categories:** Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## CoinGecko Scraper — Live Crypto Prices & Market Caps, No API Key **Launch pricing: this actor currently adds no fee — run it on your Apify free-plan credits. Try it, bookmark it, wire it into your stack.** A **CoinGecko scraper** for live market data with zero setup: this **CoinGecko API scraper** works as a **crypto price scraper** and **cryptocurrency market data scraper** — prices, market caps, ranks, 24h volume, 24h change, ATH and ATL for the top coins in any quote currency. Use it as a scheduled **crypto market cap scraper** without registering for an API key. > Top-N coins by market cap as clean JSON, every run — and an API error or empty response fails loudly instead of producing an empty dataset. ### Who uses this - **Dashboard & bot builders** — a scheduled run is a free, keyless market-data backend. - **Analysts & newsletter writers** — daily top-100 snapshots make trend tables trivial. - **Spreadsheet investors** — live portfolio valuation with one IMPORTDATA formula. - **Data teams** — consistent coin records (`id`, `symbol`, `vsCurrency`, `scrapedAt`) for time-series storage. Tracking public crypto-adjacent companies too (MSTR, COIN, miners)? The [SEC EDGAR Filings Scraper](https://apify.com/exuberant_volley/sec-edgar-filings-scraper) pulls their filing history by ticker. ### How it works The actor calls CoinGecko's public `/coins/markets` endpoint ordered by market cap, paginates until `maxItems` is reached, and maps each row to a flat record. Non-array API responses (rate-limit or error objects) throw immediately, and a run that pushed zero coins **fails loudly instead of succeeding empty**. ### Output One record per coin: ```json { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "currentPrice": 64749, "marketCap": 1298684174087, "marketCapRank": 1, "totalVolume": 31926927567, "priceChangePercentage24h": 3.48824, "ath": 126080, "atl": 67.81, "vsCurrency": "usd", "scrapedAt": "2026-07-15T09:35:29.185Z" } ```` - `id` is CoinGecko's stable coin id — join key for any other CoinGecko data. - `vsCurrency` + `scrapedAt` make records safely stackable into a time series. ### Input | Field | Default | Description | |---|---|---| | `vsCurrency` | `usd` | Quote currency (`usd`, `eur`, `gbp`, `btc`, …) | | `perPage` | `100` | Coins per API request (1–250) | | `page` | `1` | Start page (1 = highest market cap) | | `maxItems` | `100` | Stop after this many coins | **The default run needs no configuration** — an empty input returns the top 100 coins by market cap in USD. ### Reliability & limits - **Free-tier rate limits**: CoinGecko's public API allows roughly 5–15 calls/min. The default run is a single call; very large `maxItems` values (many pages) can hit 429 — the actor retries with backoff, then fails loudly rather than returning a partial-silent dataset. - Prices refresh on CoinGecko's cadence (typically under a minute for top coins); this is market **snapshot** data, not tick-level feed. - No API key needed; for heavy schedules keep runs ≤250 coins or space them out. ### Paste this output into… - **Google Sheets** — `=IMPORTDATA("https://api.apify.com/v2/acts/exuberant_volley~coingecko-market-scraper/runs/last/dataset/items?format=csv&clean=1&token=YOUR_TOKEN")` = a self-refreshing market sheet. - **Make / n8n** — schedule every hour, fetch `.../runs/last/dataset/items`, and alert when `priceChangePercentage24h` crosses your threshold. - **Portfolio valuation (spreadsheet investors)** — keep a holdings tab keyed by `id` (e.g. `bitcoin`, `ethereum`); `VLOOKUP` each id against the imported sheet's `currentPrice` for live portfolio value on open. ### ScrapeForge free data suite One publisher, fourteen plug-and-play datasets — all currently free to run: | Actor | What it delivers | | |---|---|---| | [Executive Changes Tracker](https://apify.com/exuberant_volley/executive-changes-scraper) | New CEO/CFO/board moves from SEC 8-Ks + official newswires — source-cited B2B trigger leads | [run it next →](https://apify.com/exuberant_volley/executive-changes-scraper) | | [IKEA Product Scraper](https://apify.com/exuberant_volley/ikea-product-scraper) | Names, prices, ratings and images from any IKEA search or category page | [run it next →](https://apify.com/exuberant_volley/ikea-product-scraper) | | [Shopify Store Scraper](https://apify.com/exuberant_volley/shopify-store-scraper) | Any Shopify store's full catalog — variants, SKUs, prices — via products.json | [run it next →](https://apify.com/exuberant_volley/shopify-store-scraper) | | [App Store Apps Scraper](https://apify.com/exuberant_volley/app-store-apps-scraper) | App rankings, ratings, prices and metadata by keyword, any country | [run it next →](https://apify.com/exuberant_volley/app-store-apps-scraper) | | [Remote Jobs Scraper](https://apify.com/exuberant_volley/remote-jobs-scraper) | Live remote listings from RemoteOK + Remotive, keyword-filtered | [run it next →](https://apify.com/exuberant_volley/remote-jobs-scraper) | | [CoinGecko Market Scraper](https://apify.com/exuberant_volley/coingecko-market-scraper) | Top-coin prices, market caps and 24h moves — keyless | [run it next →](https://apify.com/exuberant_volley/coingecko-market-scraper) | | [GitHub Repositories Scraper](https://apify.com/exuberant_volley/github-repos-scraper) | Repo search with stars, forks, topics and licenses | [run it next →](https://apify.com/exuberant_volley/github-repos-scraper) | | [Hacker News Scraper](https://apify.com/exuberant_volley/hackernews-scraper) | Top/New/Best HN stories with scores and comment counts | [run it next →](https://apify.com/exuberant_volley/hackernews-scraper) | | [Wikipedia Scraper](https://apify.com/exuberant_volley/wikipedia-scraper) | Article summaries, images and URLs in any language — RAG-ready | [run it next →](https://apify.com/exuberant_volley/wikipedia-scraper) | | [SEC EDGAR Filings Scraper](https://apify.com/exuberant_volley/sec-edgar-filings-scraper) | Any US public company's filing history by ticker | [run it next →](https://apify.com/exuberant_volley/sec-edgar-filings-scraper) | | [Open-Meteo Weather Scraper](https://apify.com/exuberant_volley/open-meteo-weather-scraper) | 16-day daily forecast for any coordinates — temps, rain, wind — keyless | [run it next →](https://apify.com/exuberant_volley/open-meteo-weather-scraper) | | [arXiv Papers Scraper](https://apify.com/exuberant_volley/arxiv-papers-scraper) | Research papers by topic — abstracts, categories, PDF links, newest-first sort | [run it next →](https://apify.com/exuberant_volley/arxiv-papers-scraper) | | [NVD CVE Scraper](https://apify.com/exuberant_volley/nvd-cve-scraper) | Fresh CVEs with CVSS severity, CWE ids and CISA known-exploited flags | [run it next →](https://apify.com/exuberant_volley/nvd-cve-scraper) | | [npm Registry Scraper](https://apify.com/exuberant_volley/npm-registry-scraper) | npm package vitals — latest version, license, weekly downloads, dependency count | [run it next →](https://apify.com/exuberant_volley/npm-registry-scraper) | ### Compliance - **No personal data is collected — market data only.** - Data comes from CoinGecko's public API; this actor is intended for personal/internal analytics, not commercial redistribution of CoinGecko data (see CoinGecko's terms). - Records live only in your run's dataset; the actor keeps nothing beyond it. # Actor input Schema ## `vsCurrency` (type: `string`): Fiat or crypto currency to price coins against (usd, eur, gbp, btc, ...). ## `perPage` (type: `integer`): Coins fetched per API request (1-250). ## `page` (type: `integer`): Page number to start from (1 = highest market cap). ## `maxItems` (type: `integer`): Stop after this many coins (paginates automatically if larger than results per page). ## Actor input object example ```json { "vsCurrency": "usd", "perPage": 100, "page": 1, "maxItems": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "vsCurrency": "usd", "perPage": 100, "page": 1, "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("exuberant_volley/coingecko-market-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "vsCurrency": "usd", "perPage": 100, "page": 1, "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("exuberant_volley/coingecko-market-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "vsCurrency": "usd", "perPage": 100, "page": 1, "maxItems": 100 }' | apify call exuberant_volley/coingecko-market-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=exuberant_volley/coingecko-market-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CoinGecko Market Scraper", "description": "For dashboards, bots, and analysts who need a clean top-coins snapshot in their fiat before a report or alert. Price, market cap, rank, 24h volume/change, ATH/ATL. Official CoinGecko API. Free to run.", "version": "0.1", "x-build-id": "UVjMqcQp3qJk1r5cP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/exuberant_volley~coingecko-market-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-exuberant_volley-coingecko-market-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/exuberant_volley~coingecko-market-scraper/runs": { "post": { "operationId": "runs-sync-exuberant_volley-coingecko-market-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/exuberant_volley~coingecko-market-scraper/run-sync": { "post": { "operationId": "run-sync-exuberant_volley-coingecko-market-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "vsCurrency": { "title": "Quote currency", "type": "string", "description": "Fiat or crypto currency to price coins against (usd, eur, gbp, btc, ...).", "default": "usd" }, "perPage": { "title": "Results per page", "minimum": 1, "maximum": 250, "type": "integer", "description": "Coins fetched per API request (1-250).", "default": 100 }, "page": { "title": "Start page", "minimum": 1, "type": "integer", "description": "Page number to start from (1 = highest market cap).", "default": 1 }, "maxItems": { "title": "Max coins", "minimum": 1, "type": "integer", "description": "Stop after this many coins (paginates automatically if larger than results per page).", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```