# Coingecko Crypto Intelligence (`viralanalyzer/coingecko-crypto-intelligence`) Actor
Extract cryptocurrency data from CoinGecko: prices, market cap, volume, supply, and historical trends. Track any coin or token.
- **URL**: https://apify.com/viralanalyzer/coingecko-crypto-intelligence.md
- **Developed by:** [viralanalyzer](https://apify.com/viralanalyzer) (community)
- **Categories:** Business, Developer tools, AI
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
from $15.75 / 1,000 coin data scrapeds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
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 Crypto Intelligence — Market Data, Prices & Trends
> 🔗 [View on Apify Store](https://apify.com/viralanalyzer/coingecko-crypto-intelligence) | 🇺🇸 English | [🇧🇷 Português](#português)
Fetch **real-time cryptocurrency market data** from CoinGecko's public API. Track prices, market cap, volume, price changes (24h/7d/30d), ATH/ATL, supply metrics, and trending coins. Three modes: top coins by market cap, trending coins (24h), or specific coins by ID. No API key required.
### ✨ Features
- 📊 **Market overview** — Top coins ranked by market cap with full metrics
- 🔥 **Trending coins** — Currently hot coins and NFTs (24h trends)
- 🔍 **Specific coins** — Look up any coin by CoinGecko ID (bitcoin, ethereum, solana, etc.)
- 💱 **Multi-currency** — Prices in USD, EUR, BRL, GBP, JPY, or any supported fiat
- 📈 **Price changes** — 24h, 7d, and 30d percentage changes
- 🏔️ **ATH/ATL tracking** — All-time high and low with distance percentages
- 💎 **Supply data** — Circulating, total, and max supply + fully diluted valuation
- 📉 **7-day sparkline** — Optional price chart data (168 data points)
- 🛡️ **Anti-placeholder guardrails** — Every result validated for real data
- ⚡ **No API key** — Uses CoinGecko free public API
### 📥 Input
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `mode` | string | ✅ | `"market"` | Scraping mode: `market`, `trending`, or `coins` |
| `coinIds` | string[] | ❌ | — | CoinGecko coin IDs (only for `coins` mode, max 50) |
| `vsCurrency` | string | ❌ | `"usd"` | Target currency for prices (usd, eur, brl, etc.) |
| `maxCoins` | integer | ❌ | `100` | Max coins to fetch in market mode (1-250) |
| `includeSparkline` | boolean | ❌ | `false` | Include 7-day price sparkline array |
#### Input Example
```json
{
"mode": "market",
"vsCurrency": "usd",
"maxCoins": 50,
"includeSparkline": false
}
````
**Trending mode:**
```json
{
"mode": "trending",
"vsCurrency": "usd"
}
```
**Specific coins:**
```json
{
"mode": "coins",
"coinIds": ["bitcoin", "ethereum", "solana", "cardano"],
"vsCurrency": "usd"
}
```
### 📤 Output
Every coin includes these fields:
| Field | Type | Description |
|---|---|---|
| `coinId` | string | CoinGecko coin identifier |
| `symbol` | string | Ticker symbol (BTC, ETH, SOL) |
| `name` | string | Full coin name |
| `currentPrice` | number | Current price in target currency |
| `marketCap` | number | Total market capitalization |
| `marketCapRank` | number | Global rank by market cap |
| `totalVolume` | number | 24h trading volume |
| `high24h` | number | 24h price high |
| `low24h` | number | 24h price low |
| `priceChange24h` | number | Absolute price change (24h) |
| `priceChangePercent24h` | number | Price change percentage (24h) |
| `priceChangePercent7d` | number | Price change percentage (7d) |
| `priceChangePercent30d` | number | Price change percentage (30d) |
| `ath` | number | All-time high price |
| `athChangePercent` | number | Percentage from ATH |
| `athDate` | string | Date of all-time high |
| `atl` | number | All-time low price |
| `atlChangePercent` | number | Percentage from ATL |
| `atlDate` | string | Date of all-time low |
| `circulatingSupply` | number | Coins currently in circulation |
| `totalSupply` | number | Total supply of coins |
| `maxSupply` | number/null | Maximum supply (null if unlimited) |
| `fullyDilutedValuation` | number | Fully diluted market cap |
| `imageUrl` | string | Coin logo URL |
| `lastUpdated` | string | Last data update timestamp |
| `currency` | string | Target currency used |
| `platform` | string | Always `"coingecko"` |
| `scrapedAt` | string | ISO 8601 scrape timestamp |
#### Output Example
```json
{
"coinId": "bitcoin",
"symbol": "BTC",
"name": "Bitcoin",
"currentPrice": 97432.18,
"marketCap": 1932847561234,
"marketCapRank": 1,
"totalVolume": 28453000000,
"high24h": 98100.00,
"low24h": 96200.50,
"priceChange24h": 1232.18,
"priceChangePercent24h": 1.28,
"priceChangePercent7d": 4.52,
"priceChangePercent30d": -2.13,
"ath": 108786.00,
"athChangePercent": -10.43,
"athDate": "2025-01-20T09:11:54.494Z",
"atl": 67.81,
"atlChangePercent": 143572.41,
"atlDate": "2013-07-06T00:00:00.000Z",
"circulatingSupply": 19832456,
"totalSupply": 19832456,
"maxSupply": 21000000,
"fullyDilutedValuation": 2046075762000,
"imageUrl": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png",
"lastUpdated": "2026-03-06T14:30:00.000Z",
"currency": "usd",
"platform": "coingecko",
"scrapedAt": "2026-03-06T14:30:15.123Z"
}
```
### 📋 Use Cases
- **Portfolio Tracking** — Monitor prices and performance of your crypto holdings
- **Market Research** — Analyze top coins by market cap, volume, and price trends
- **Trend Detection** — Spot trending coins before they go mainstream
- **Price Alerts** — Feed data into automation workflows for price monitoring
- **Investment Analysis** — Compare ATH/ATL distances, supply metrics, and valuations
- **Data Pipelines** — Integrate crypto data into dashboards, spreadsheets, or databases
### ❓ FAQ
**Q: Do I need a CoinGecko API key?**
A: No. This actor uses CoinGecko's free public API, which requires no authentication. Rate limits are handled automatically with retries and backoff.
**Q: What is the difference between the three modes?**
A: `market` returns top coins ranked by market cap (up to 250). `trending` returns the coins and NFTs that are currently hot on CoinGecko in the last 24 hours. `coins` lets you look up specific coins by their CoinGecko ID (e.g., "bitcoin", "ethereum", "solana").
**Q: How often is the data updated?**
A: CoinGecko updates market data approximately every 1-5 minutes. The `lastUpdated` field in each result shows the exact timestamp of the most recent data from CoinGecko.
**Q: Can I get prices in my local currency?**
A: Yes. Set the `vsCurrency` parameter to any fiat currency supported by CoinGecko (e.g., "brl", "eur", "gbp", "jpy"). All price fields will be converted to your chosen currency.
**Q: What does the sparkline data contain?**
A: When `includeSparkline` is enabled, each coin includes a `sparkline7d` array with 168 price data points (one per hour for the past 7 days), which you can use to render mini price charts.
### 💰 Pricing
This actor uses **Pay Per Event (PPE)** pricing:
| Metric | Cost |
|--------|------|
| Per coin scraped | $0.03 |
### 🔗 Related Actors
- [Steam Game Intelligence](https://apify.com/viralanalyzer/steam-game-intelligence) — Steam game market data
- [eBay Product Scraper](https://apify.com/viralanalyzer/ebay-product-scraper) — eBay product prices and listings
- [Google Trends Scraper](https://apify.com/viralanalyzer/google-trends-scraper) — Search trend analysis
- [YouTube Fast Scraper](https://apify.com/viralanalyzer/youtube-fast-scraper) — YouTube video metrics
### 📝 Changelog
#### v1.0 (Current)
- ✅ Market mode — top coins by market cap (up to 250)
- ✅ Trending mode — 24h hot coins and NFTs
- ✅ Coins mode — specific coin lookup by CoinGecko ID
- ✅ Multi-currency support (USD, EUR, BRL, GBP, etc.)
- ✅ Price change tracking (24h, 7d, 30d)
- ✅ ATH/ATL with distance percentages
- ✅ Supply metrics and fully diluted valuation
- ✅ Optional 7-day sparkline data
- ✅ Rate limit handling with automatic retries
- ✅ Anti-placeholder guardrails
***
## 🪙 CoinGecko Crypto Intelligence — Dados de Mercado, Preços & Tendências
> [🇺🇸 English](#-coingecko-crypto-intelligence--market-data-prices--trends) | 🇧🇷 Português
Obtenha **dados de mercado de criptomoedas em tempo real** da API pública do CoinGecko. Acompanhe preços, capitalização de mercado, volume, variações de preço (24h/7d/30d), ATH/ATL, métricas de oferta e moedas em tendência. Três modos: top moedas por capitalização, moedas em alta (24h) ou moedas específicas por ID. Sem necessidade de API key.
### ✨ Funcionalidades
- 📊 **Visão de mercado** — Top moedas ranqueadas por market cap com métricas completas
- 🔥 **Moedas em tendência** — Moedas e NFTs em alta nas últimas 24h
- 🔍 **Moedas específicas** — Consulte qualquer moeda por ID do CoinGecko (bitcoin, ethereum, solana, etc.)
- 💱 **Multi-moeda** — Preços em USD, EUR, BRL, GBP, JPY ou qualquer fiat suportado
- 📈 **Variações de preço** — Percentuais de 24h, 7d e 30d
- 🏔️ **ATH/ATL** — Máximas e mínimas históricas com percentual de distância
- 💎 **Dados de oferta** — Oferta circulante, total e máxima + avaliação totalmente diluída
- 📉 **Sparkline 7 dias** — Dados opcionais de gráfico de preço (168 pontos)
- 🛡️ **Proteção anti-placeholder** — Todo resultado validado com dados reais
- ⚡ **Sem API key** — Usa a API pública gratuita do CoinGecko
### 📥 Entrada
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| `mode` | string | ✅ | `"market"` | Modo: `market`, `trending` ou `coins` |
| `coinIds` | string\[] | ❌ | — | IDs do CoinGecko (apenas para modo `coins`, máximo 50) |
| `vsCurrency` | string | ❌ | `"usd"` | Moeda-alvo para preços (usd, eur, brl, etc.) |
| `maxCoins` | inteiro | ❌ | `100` | Máximo de moedas no modo market (1-250) |
| `includeSparkline` | boolean | ❌ | `false` | Incluir sparkline de 7 dias |
#### Exemplo de Entrada
```json
{
"mode": "market",
"vsCurrency": "brl",
"maxCoins": 50,
"includeSparkline": false
}
```
**Modo tendências:**
```json
{
"mode": "trending",
"vsCurrency": "brl"
}
```
**Moedas específicas:**
```json
{
"mode": "coins",
"coinIds": ["bitcoin", "ethereum", "solana", "cardano"],
"vsCurrency": "brl"
}
```
### 📤 Saída
Cada moeda inclui estes campos:
| Campo | Tipo | Descrição |
|---|---|---|
| `coinId` | string | Identificador CoinGecko da moeda |
| `symbol` | string | Símbolo ticker (BTC, ETH, SOL) |
| `name` | string | Nome completo da moeda |
| `currentPrice` | número | Preço atual na moeda-alvo |
| `marketCap` | número | Capitalização total de mercado |
| `marketCapRank` | número | Ranking global por market cap |
| `totalVolume` | número | Volume de negociação 24h |
| `high24h` | número | Máxima do preço em 24h |
| `low24h` | número | Mínima do preço em 24h |
| `priceChange24h` | número | Variação absoluta de preço (24h) |
| `priceChangePercent24h` | número | Variação percentual (24h) |
| `priceChangePercent7d` | número | Variação percentual (7d) |
| `priceChangePercent30d` | número | Variação percentual (30d) |
| `ath` | número | Máxima histórica (All-Time High) |
| `athChangePercent` | número | Percentual de distância do ATH |
| `athDate` | string | Data da máxima histórica |
| `atl` | número | Mínima histórica (All-Time Low) |
| `atlChangePercent` | número | Percentual de distância do ATL |
| `atlDate` | string | Data da mínima histórica |
| `circulatingSupply` | número | Moedas em circulação |
| `totalSupply` | número | Oferta total |
| `maxSupply` | número/null | Oferta máxima (null se ilimitada) |
| `fullyDilutedValuation` | número | Market cap totalmente diluído |
| `imageUrl` | string | URL do logo da moeda |
| `lastUpdated` | string | Timestamp da última atualização |
| `currency` | string | Moeda-alvo utilizada |
| `platform` | string | Sempre `"coingecko"` |
| `scrapedAt` | string | Timestamp ISO 8601 da coleta |
#### Exemplo de Saída
```json
{
"coinId": "bitcoin",
"symbol": "BTC",
"name": "Bitcoin",
"currentPrice": 97432.18,
"marketCap": 1932847561234,
"marketCapRank": 1,
"totalVolume": 28453000000,
"high24h": 98100.00,
"low24h": 96200.50,
"priceChange24h": 1232.18,
"priceChangePercent24h": 1.28,
"priceChangePercent7d": 4.52,
"priceChangePercent30d": -2.13,
"ath": 108786.00,
"athChangePercent": -10.43,
"athDate": "2025-01-20T09:11:54.494Z",
"atl": 67.81,
"atlChangePercent": 143572.41,
"atlDate": "2013-07-06T00:00:00.000Z",
"circulatingSupply": 19832456,
"totalSupply": 19832456,
"maxSupply": 21000000,
"fullyDilutedValuation": 2046075762000,
"imageUrl": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png",
"lastUpdated": "2026-03-06T14:30:00.000Z",
"currency": "usd",
"platform": "coingecko",
"scrapedAt": "2026-03-06T14:30:15.123Z"
}
```
### 📋 Casos de Uso
- **Acompanhamento de Portfólio** — Monitore preços e performance das suas criptomoedas
- **Pesquisa de Mercado** — Analise top moedas por market cap, volume e tendências
- **Detecção de Tendências** — Identifique moedas em alta antes de viralizarem
- **Alertas de Preço** — Alimente workflows de automação para monitoramento
- **Análise de Investimento** — Compare distâncias ATH/ATL, métricas de oferta e valuations
- **Pipelines de Dados** — Integre dados cripto em dashboards, planilhas ou bancos de dados
### ❓ Perguntas Frequentes
**P: Preciso de uma API key do CoinGecko?**
R: Não. Este actor usa a API pública gratuita do CoinGecko, que não requer autenticação. Limites de requisição são tratados automaticamente com retentativas e backoff.
**P: Qual a diferença entre os três modos?**
R: `market` retorna as top moedas ranqueadas por capitalização de mercado (até 250). `trending` retorna as moedas e NFTs que estão em alta no CoinGecko nas últimas 24 horas. `coins` permite consultar moedas específicas pelo ID do CoinGecko (ex: "bitcoin", "ethereum", "solana").
**P: Com que frequência os dados são atualizados?**
R: O CoinGecko atualiza os dados de mercado aproximadamente a cada 1-5 minutos. O campo `lastUpdated` em cada resultado mostra o timestamp exato da atualização mais recente do CoinGecko.
**P: Posso obter preços na minha moeda local?**
R: Sim. Defina o parâmetro `vsCurrency` para qualquer moeda fiat suportada pelo CoinGecko (ex: "brl", "eur", "gbp", "jpy"). Todos os campos de preço serão convertidos para a moeda escolhida.
**P: O que contém os dados de sparkline?**
R: Quando `includeSparkline` está ativado, cada moeda inclui um array `sparkline7d` com 168 pontos de preço (um por hora nos últimos 7 dias), que você pode usar para renderizar mini gráficos de preço.
### 💰 Preços
Este actor usa precificação **Pay Per Event (PPE)**:
| Métrica | Custo |
|---------|-------|
| Por moeda coletada | $0.03 |
### 🔗 Actors Relacionados
- [Steam Game Intelligence](https://apify.com/viralanalyzer/steam-game-intelligence) — Dados de mercado de jogos Steam
- [eBay Product Scraper](https://apify.com/viralanalyzer/ebay-product-scraper) — Preços e anúncios do eBay
- [Google Trends Scraper](https://apify.com/viralanalyzer/google-trends-scraper) — Análise de tendências de busca
- [YouTube Fast Scraper](https://apify.com/viralanalyzer/youtube-fast-scraper) — Métricas do YouTube
### 📝 Changelog
#### v1.0 (Atual)
- ✅ Modo market — top moedas por market cap (até 250)
- ✅ Modo trending — moedas e NFTs em alta nas últimas 24h
- ✅ Modo coins — consulta de moedas específicas por ID
- ✅ Suporte multi-moeda (USD, EUR, BRL, GBP, etc.)
- ✅ Rastreamento de variação de preço (24h, 7d, 30d)
- ✅ ATH/ATL com percentuais de distância
- ✅ Métricas de oferta e avaliação totalmente diluída
- ✅ Sparkline de 7 dias (opcional)
- ✅ Tratamento de rate limit com retentativas automáticas
- ✅ Proteção anti-placeholder
# Actor input Schema
## `mode` (type: `string`):
What data to collect.
## `coinIds` (type: `array`):
CoinGecko coin IDs (e.g., bitcoin, ethereum, solana). Only used in 'coins' mode.
## `vsCurrency` (type: `string`):
Currency for prices (e.g., usd, eur, brl, gbp).
## `maxCoins` (type: `integer`):
How many top coins to fetch in market mode (max 250).
## `includeSparkline` (type: `boolean`):
Include 7-day price sparkline data (array of prices).
## Actor input object example
```json
{
"mode": "market",
"coinIds": [
"bitcoin",
"ethereum",
"solana"
],
"vsCurrency": "usd",
"maxCoins": 100,
"includeSparkline": false
}
```
# Actor output Schema
## `results` (type: `string`):
Dataset containing all scraped results. Each item follows the dataset schema.
# 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 = {
"coinIds": [
"bitcoin",
"ethereum",
"solana"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("viralanalyzer/coingecko-crypto-intelligence").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 = { "coinIds": [
"bitcoin",
"ethereum",
"solana",
] }
# Run the Actor and wait for it to finish
run = client.actor("viralanalyzer/coingecko-crypto-intelligence").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 '{
"coinIds": [
"bitcoin",
"ethereum",
"solana"
]
}' |
apify call viralanalyzer/coingecko-crypto-intelligence --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=viralanalyzer/coingecko-crypto-intelligence",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Coingecko Crypto Intelligence",
"description": "Extract cryptocurrency data from CoinGecko: prices, market cap, volume, supply, and historical trends. Track any coin or token.",
"version": "1.0",
"x-build-id": "Y7DNN1TbiRiJFHAwN"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/viralanalyzer~coingecko-crypto-intelligence/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-viralanalyzer-coingecko-crypto-intelligence",
"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/viralanalyzer~coingecko-crypto-intelligence/runs": {
"post": {
"operationId": "runs-sync-viralanalyzer-coingecko-crypto-intelligence",
"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/viralanalyzer~coingecko-crypto-intelligence/run-sync": {
"post": {
"operationId": "run-sync-viralanalyzer-coingecko-crypto-intelligence",
"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",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "Scraping Mode",
"enum": [
"market",
"trending",
"coins"
],
"type": "string",
"description": "What data to collect.",
"default": "market"
},
"coinIds": {
"title": "Coin IDs",
"maxItems": 50,
"type": "array",
"description": "CoinGecko coin IDs (e.g., bitcoin, ethereum, solana). Only used in 'coins' mode.",
"items": {
"type": "string"
}
},
"vsCurrency": {
"title": "Target Currency",
"type": "string",
"description": "Currency for prices (e.g., usd, eur, brl, gbp).",
"default": "usd"
},
"maxCoins": {
"title": "Max Coins (Market Mode)",
"minimum": 1,
"maximum": 250,
"type": "integer",
"description": "How many top coins to fetch in market mode (max 250).",
"default": 100
},
"includeSparkline": {
"title": "Include 7-day Sparkline",
"type": "boolean",
"description": "Include 7-day price sparkline data (array of prices).",
"default": 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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```