{ "openapi": "3.0.1", "info": { "title": "CoinGecko Scraper - Crypto Prices & Market Rankings", "description": "Crypto prices and rankings from CoinGecko: the top coins by market cap, one category, or the ids you name. Each row holds price, market cap, rank, 24h volume, 24h and 7d change, supply, all-time high and low. Coin ids are slugs, not tickers: BNB is binancecoin. $2.00 per 1,000 coins.", "version": "0.1", "x-build-id": "R4Yj3OuN9R2mR70Ds" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~coingecko-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-coingecko-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/dami_studio~coingecko-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-coingecko-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/dami_studio~coingecko-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-coingecko-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": { "mode": { "title": "Mode", "enum": [ "markets", "search", "coins" ], "type": "string", "description": "What to fetch: \"markets\" = top coins ranked by market cap (full ~15-field rows); \"search\" = look up coins by name/symbol (lighter 6-field rows: id, name, symbol, marketCapRank, image, url, no price/marketCap/volume); \"coins\" = fetch specific coins by their CoinGecko id (full rows).", "default": "markets" }, "vsCurrency": { "title": "Quote currency", "type": "string", "description": "The fiat or crypto currency that prices, market cap and volume are quoted in, e.g. usd, eur, gbp, btc, eth. Used by Markets and Coins modes.", "default": "usd" }, "query": { "title": "Search query", "type": "string", "description": "Coin name or symbol to search for (only used in Search mode), e.g. \"solana\", \"doge\", \"bitcoin\"." }, "coinIds": { "title": "Coin ids", "type": "array", "description": "List of CoinGecko coin ids to fetch (only used in Coins mode), e.g. [\"bitcoin\", \"ethereum\", \"solana\"]. The id is the slug from a coin's CoinGecko URL.", "items": { "type": "string" } }, "category": { "title": "Category (Markets mode)", "type": "string", "description": "Only the coins CoinGecko files under one category, such as meme-token, layer-1 or decentralized-finance-defi. Use the id from the end of the category's CoinGecko page (coingecko.com/en/categories/meme-token) or the name that page shows (Meme). Markets mode only. Leave empty for every coin." }, "order": { "title": "Sort order (Markets and Coins modes)", "enum": [ "market_cap_desc", "market_cap_asc", "volume_desc", "volume_asc", "id_asc", "id_desc" ], "type": "string", "description": "How CoinGecko ranks the coins. In Markets mode the run takes the first Max coins in this order. Market cap, largest first, is the usual leaderboard. Smallest first begins with the coins CoinGecko lists at a market cap of 0.", "default": "market_cap_desc" }, "maxItems": { "title": "Max coins (Markets mode)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of coins to return in Markets mode. The actor paginates 250 per request as needed.", "default": 100 }, "notionConnector": { "title": "Notion connector (optional)", "type": "string", "description": "Optional. Write each coin as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default), results are always saved to the dataset regardless." }, "notionParentId": { "title": "Notion target data source ID", "type": "string", "description": "Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional, and not needed for a normal run. Switch it on only if you hit rate limits on very large runs.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }