# CoinGecko Derivatives Scraper (`logiover/coingecko-derivatives-scraper`) Actor Scrape 22,000+ crypto derivative tickers from CoinGecko in one run — price, 24h change, funding rate, open interest, basis, spread and 24h volume across every derivatives exchange. Schedule it for a continuously fresh feed. - **URL**: https://apify.com/logiover/coingecko-derivatives-scraper.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Automation, Developer tools - **Stats:** 16 total users, 4 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $2.00 / 1,000 results 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 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 Derivatives Scraper — Scrape Crypto Futures & Perpetual Tickers Scrape **22,000+ crypto derivative tickers from CoinGecko** in a single run — every perpetual and futures contract across all derivatives exchanges — and export them to JSON, CSV or Excel. This **CoinGecko derivatives scraper** pulls price, funding rate, open interest, basis, spread and 24h volume straight from the **official CoinGecko API**, with **no login and no API key required**. Derivatives data moves constantly, so this Actor is built for scheduled, recurring use: run it on an interval to keep a continuously fresh crypto derivatives feed for trading, risk and research. ### ✨ What this Actor does / Key features - 📑 **Official CoinGecko API** — reliable, fully structured data with no blocking and no scraping headaches. - 🌐 **Massive coverage** — 22,000+ derivative tickers across every derivatives exchange in one run. - 📊 **Rich metrics per ticker** — market, symbol, contract type, price, 24h price change, index, basis, spread, funding rate, open interest and 24h volume. - 🔎 **Contract type filter** — focus on `perpetual`, `futures`, or leave empty for all. - 💧 **Volume filtering** — drop low-liquidity tickers with a minimum 24h volume threshold. - 🔃 **Sort by metric** — rank tickers by 24h volume, open interest, 24h price change or price. - 📈 **Full or targeted runs** — leave `maxTickers` empty to pull every ticker, or set a number for a smaller run. - 📤 **Structured output** — clean JSON records ready for CSV, Excel, dashboards or your database. ### 🔍 Input | Field | Type | Description | |---|---|---| | `contractType` | string | Filter by contract type, e.g. `perpetual` or `futures`. Leave empty for all. | | `minVolume24h` | integer | Drop tickers with 24h volume below this value. `0` = no filter. | | `sortBy` | string | Rank tickers by this metric: `volume24h`, `openInterest`, `priceChangePercent24h` or `price`. Default `volume24h`. | | `maxTickers` | integer | Maximum number of tickers to save. `0` = all (22,000+). | ### 🚀 Example input ```json { "contractType": "perpetual", "minVolume24h": 100000, "sortBy": "volume24h", "maxTickers": 0 } ```` ### 📦 Output Each derivative ticker is saved as one structured record in the dataset. Export the full dataset to JSON, CSV or Excel. | Field | Description | |---|---| | `market` | Derivatives exchange / market name | | `symbol` | Contract symbol | | `indexId` | Underlying index identifier | | `contractType` | Contract type (e.g. perpetual, futures) | | `price` | Current contract price | | `priceChangePercent24h` | 24-hour price change (%) | | `index` | Underlying index price | | `basis` | Basis between contract price and index | | `spread` | Bid/ask spread | | `fundingRate` | Current funding rate | | `openInterest` | Open interest | | `volume24h` | 24-hour trading volume | | `lastTradedAt` | Timestamp of the last trade | | `expiredAt` | Contract expiry timestamp (for dated futures) | | `scrapedAt` | Timestamp when the record was scraped | ### 💡 Use cases - **Derivatives traders & bots** — monitor funding rates, open interest and basis across exchanges in one feed. - **Risk & arbitrage** — spot funding-rate and basis opportunities between markets. - **Market research** — track derivatives volume and positioning across the crypto market. - **Quant datasets** — schedule runs to build a historical derivatives market archive for backtesting. - **Dashboards & alerting** — power a derivatives analytics dashboard with continuously refreshed data. - **Exchange comparison** — compare pricing, funding and liquidity for the same contract across venues. ### ❓ Frequently Asked Questions **Do I need an API key or login?** No. This Actor uses the official, public CoinGecko API — no API key, no account and no login are required. **Is using CoinGecko data allowed?** The Actor consumes CoinGecko's public API directly. Always use the data responsibly and in line with CoinGecko's terms. **How much data can I get?** You can pull all 22,000+ derivative tickers in a single run. Set `maxTickers` to `0` for the full set, or a smaller number for a quick targeted run. **Can I filter by contract type or volume?** Yes. Use `contractType` to focus on perpetuals or futures, and `minVolume24h` to drop low-liquidity tickers. You can also sort by volume, open interest, price change or price. **How fresh is the data?** The data reflects CoinGecko's current values at the time of the run. Because derivatives data changes constantly, schedule the Actor to run frequently for an up-to-date feed. **Can I build a historical archive?** Yes. Schedule the Actor on a fixed interval and each run appends a fresh snapshot, giving you a longitudinal dataset of funding rates, open interest and volume. **What output formats are supported?** Results are stored as structured JSON and can be exported to JSON, CSV, Excel or XML, or accessed via the Apify API. ### ⏰ Scheduling & integration Schedule this Actor on Apify to run on an interval for a continuously fresh crypto derivatives feed. Export results to JSON, CSV or Excel, push them to Google Sheets, or connect the Apify API and webhooks to feed CoinGecko derivatives data directly into your trading models, dashboards and analytics pipelines. # Actor input Schema ## `contractType` (type: `string`): Filter by contract type, e.g. 'perpetual', 'futures'. Leave empty for all. ## `minVolume24h` (type: `integer`): Drop tickers with 24h volume below this. 0 = no filter. ## `sortBy` (type: `string`): Rank the tickers by this metric. ## `maxTickers` (type: `integer`): Maximum tickers to save. 0 = all (22,000+). ## Actor input object example ```json { "contractType": "", "minVolume24h": 0, "sortBy": "volume24h" } ``` # Actor output Schema ## `market` (type: `string`): market ## `symbol` (type: `string`): symbol ## `contractType` (type: `string`): contractType ## `price` (type: `string`): price ## `priceChangePercent24h` (type: `string`): priceChangePercent24h ## `fundingRate` (type: `string`): fundingRate ## `openInterest` (type: `string`): openInterest ## `volume24h` (type: `string`): volume24h # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("logiover/coingecko-derivatives-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 = {} # Run the Actor and wait for it to finish run = client.actor("logiover/coingecko-derivatives-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 '{}' | apify call logiover/coingecko-derivatives-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/coingecko-derivatives-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CoinGecko Derivatives Scraper", "description": "Scrape 22,000+ crypto derivative tickers from CoinGecko in one run — price, 24h change, funding rate, open interest, basis, spread and 24h volume across every derivatives exchange. Schedule it for a continuously fresh feed.", "version": "1.0", "x-build-id": "Gnno5Da8pBVJlauZx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~coingecko-derivatives-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-coingecko-derivatives-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/logiover~coingecko-derivatives-scraper/runs": { "post": { "operationId": "runs-sync-logiover-coingecko-derivatives-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/logiover~coingecko-derivatives-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-coingecko-derivatives-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": { "contractType": { "title": "Contract Type", "type": "string", "description": "Filter by contract type, e.g. 'perpetual', 'futures'. Leave empty for all.", "default": "" }, "minVolume24h": { "title": "Minimum 24h Volume", "minimum": 0, "type": "integer", "description": "Drop tickers with 24h volume below this. 0 = no filter.", "default": 0 }, "sortBy": { "title": "Sort By", "enum": [ "volume24h", "openInterest", "priceChangePercent24h", "price" ], "type": "string", "description": "Rank the tickers by this metric.", "default": "volume24h" }, "maxTickers": { "title": "Max Tickers", "minimum": 0, "type": "integer", "description": "Maximum tickers to save. 0 = all (22,000+)." } } }, "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 } } } } } } } } } } ```