# CoinGecko Crypto Market Data Scraper (`hipersoft/coingecko-scraper`) Actor Live cryptocurrency market data from CoinGecko: price, market cap, rank, 24h volume & change, ATH/ATL, supply and more. Fetch the top coins by market cap, specific coins by symbol/name, or trending coins. Fast clean HTTP, no API key. - **URL**: https://apify.com/hipersoft/coingecko-scraper.md - **Developed by:** [hiper soft](https://apify.com/hipersoft) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.0008 / coin scraped This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 Crypto Market Data Scraper — Prices, Market Cap, Volume & ATH/ATL Get live cryptocurrency market data from CoinGecko as clean, structured JSON: price, market cap, rank, 24h volume and change, ATH/ATL, supply and more. Fetch the top coins by market cap, look up specific coins by symbol/name/id, or append CoinGecko's currently trending coins — all in one run. **No account, no API key.** Fast, dependable HTTP for traders, dashboards and crypto data pipelines. ### Features - 🚀 **Top-N by market cap** — set `maxCoins` to pull the largest coins (paginated automatically, 250 per request). - 🔎 **Specific coins** — pass `coins` like `BTC`, `ethereum` or `solana`; free-text symbols/names are resolved to CoinGecko ids for you. - 🔥 **Trending flag** — enable `includeTrending` and every coin gets a consistent `isTrending` boolean, with trending coins outside the top-N fetched too. - 💱 **Any quote currency** — price against `usd`, `eur`, `gbp`, `btc` and more via `vsCurrency`. - 📈 **Rich per-coin fields** — price, market cap, FDV, 24h high/low, 24h change, supply, ATH/ATL and timestamps. - 🧹 **Deduplicated output** — each coin appears once, keyed by id, even across trending + top-N pulls. - 🔑 **No key needed** — uses the free CoinGecko public API and works without a proxy. ### What you get One flat JSON record per coin: ```json { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "image": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png", "currentPrice": 61234.55, "marketCap": 1203450000000, "marketCapRank": 1, "fullyDilutedValuation": 1287000000000, "totalVolume": 28500000000, "high24h": 62010.12, "low24h": 60110.88, "priceChange24h": 512.44, "priceChangePct24h": 0.84, "circulatingSupply": 19700000, "totalSupply": 21000000, "maxSupply": 21000000, "ath": 73800.0, "athChangePct": -17.02, "athDate": "2024-03-14T07:10:36.635Z", "atl": 67.81, "atlDate": "2013-07-06T00:00:00.000Z", "lastUpdated": "2026-07-23T09:15:04.123Z", "isTrending": false } ``` ### Input ```json { "coins": [], "maxCoins": 100, "vsCurrency": "usd", "includeTrending": true } ``` | Field | Description | | --- | --- | | `coins` | Specific coin symbols, names or CoinGecko ids (e.g. `BTC`, `ethereum`). Empty = fetch top coins. | | `maxCoins` | How many top coins by market cap to fetch when no specific coins are given. | | `vsCurrency` | Quote currency to price against (e.g. `usd`, `eur`, `btc`). | | `includeTrending` | Also include CoinGecko's currently trending coins and flag them. | | `proxyConfiguration` | Optional proxy. The public API works fine without one. | ### Use cases - Power a live price/market-cap dashboard or portfolio tracker. - Snapshot the top 100–1000 coins on a schedule for time-series analysis. - Monitor a watchlist of specific tokens and their 24h movement. - Detect and record trending coins for momentum or research signals. ### Pricing Pay-per-event: you're billed a small amount per run and per item scraped — you only pay for what you get. See the **Pricing** tab for current rates. ### FAQ **Do I need an API key or CoinGecko account?** No. The Actor uses the free public [CoinGecko](https://www.coingecko.com) API (api.coingecko.com), so there's nothing to sign up for and no key to paste in. It works without a proxy too. **How many coins can I get per run?** As many as you set with `maxCoins` — the Actor paginates automatically at 250 coins per request, so you can pull the top 100, 1,000 or more by market cap. You can also pass a specific `coins` list instead. **How fresh is the data?** Prices, market cap and volume are pulled live from CoinGecko at run time, and each record carries a `lastUpdated` timestamp so you know exactly when the values were fetched. **Is this official CoinGecko data?** The data comes straight from CoinGecko's own public API, but this Actor is an independent tool and is not affiliated with or endorsed by CoinGecko. **What's the output format?** Clean, flat JSON — one record per coin with fields like `currentPrice`, `marketCap`, `marketCapRank`, `totalVolume`, `ath` and `atl`. You can export the dataset as JSON, CSV or Excel. ### Related Actors More market-data scrapers from the same publisher: - [DefiLlama Scraper](https://apify.com/hipersoft/defillama-scraper) — DeFi protocols, yields, chains and stablecoins with TVL and APY. - [Yahoo Finance Scraper](https://apify.com/hipersoft/yahoo-finance-scraper) — live quotes and OHLCV price history for stocks, ETFs, crypto and forex. - [SEC EDGAR Filings Scraper](https://apify.com/hipersoft/sec-edgar-scraper) — 10-K, 10-Q and 8-K filings by ticker or CIK. ### Notes This Actor uses the free public CoinGecko API (api.coingecko.com). It is an independent tool and is not affiliated with, endorsed by or sponsored by CoinGecko; all trademarks belong to their respective owners. # Actor input Schema ## `coins` (type: `array`): Coin symbols, names or CoinGecko ids (e.g. "BTC", "ethereum", "solana"), one per line. Leave empty to fetch the top coins by market cap. ## `maxCoins` (type: `integer`): How many top coins to fetch when no specific coins are given (250 per API request). ## `vsCurrency` (type: `string`): Fiat/crypto to price against (e.g. usd, eur, gbp, btc). ## `includeTrending` (type: `boolean`): Append CoinGecko's currently trending coins. ## `proxyConfiguration` (type: `object`): Optional. The CoinGecko public API works without a proxy. ## Actor input object example ```json { "coins": [], "maxCoins": 100, "vsCurrency": "usd", "includeTrending": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "coins": [] }; // Run the Actor and wait for it to finish const run = await client.actor("hipersoft/coingecko-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 = { "coins": [] } # Run the Actor and wait for it to finish run = client.actor("hipersoft/coingecko-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 '{ "coins": [] }' | apify call hipersoft/coingecko-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hipersoft/coingecko-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/52JxsfPv55BbiMshu/builds/l5aG6Jv4zA5vHb5K2/openapi.json