# Crypto Tracker 📈 - Real-time Prices & Historical Data (`tikitakaclaw/crypto-tracker`) Actor

Real-time cryptocurrency prices + historical OHLC for 2000+ coins. Combines CoinPaprika (deep coin data, market cap, supply) and Binance (live prices, 24h stats, candlesticks). Multi-quote: USD, EUR, BTC.

- **URL**: https://apify.com/tikitakaclaw/crypto-tracker.md
- **Developed by:** [TikitakaClaw Pikipiki](https://apify.com/tikitakaclaw) (community)
- **Categories:** E-commerce, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 coin snapshots

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

## Crypto Tracker 📈

**Real-time cryptocurrency prices + historical data** for 2000+ coins. Combines deep coin data from CoinPaprika with live prices from Binance. Multi-quote (USD, EUR, BTC, ETH). No API keys required.

---

### What you get

For each coin you track:

#### From CoinPaprika
- **Identity:** name, symbol, rank, slug
- **Supply:** total, max, circulating
- **Historical context:** first data at, beta value
- **Quotes (USD, EUR, BTC, ETH):**
  - Current price
  - Market cap + 24h change
  - 24h volume + 24h change
  - Price percent change: 15m, 30m, 1h, 6h, 12h, 24h, 7d, 30d, 1y

#### From Binance
- **Live price:** last, bid, ask
- **24h stats:** open, high, low, close, change, change %, volume, quote volume
- **Market data:** number of trades, weighted avg price

#### Optional: Historical Klines
- Daily OHLC candlesticks (open, high, low, close, volume)
- Up to 1000 days back
- 1 item per day per coin

---

### Input

```json
{
  "coins": "BTC,ETH,SOL,BNB",
  "vsCurrencies": "usd,eur,btc",
  "includeHistorical": false,
  "historicalDays": 30,
  "topN": 50
}
````

#### Field reference

| Field | Type | Default | Description |
|---|---|---|---|
| `coins` | string | `""` (empty) | Comma-separated symbols. Empty = top N by market cap. |
| `vsCurrencies` | string | `"usd,eur,btc"` | Quote currencies for pricing |
| `includeHistorical` | boolean | `false` | Fetch daily klines (1 item per day) |
| `historicalDays` | integer | `30` | Days of kline history (max 1000) |
| `topN` | integer | `50` | How many top coins if `coins` is empty |

***

### Output example

```json
{
  "type": "coin",
  "coinId": "btc-bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "rank": 1,
  "source": "coinpaprika+binance",
  "lastUpdated": "2026-07-05T19:44:15Z",
  "firstDataAt": "2010-07-17T00:00:00Z",
  "betaValue": 0.971797,
  "supply": {
    "total": 20052575,
    "max": 21000000,
    "circulating": 19947000
  },
  "quotes": {
    "usd": {
      "price": 62726.06,
      "marketCap": 1257819199104,
      "volume24h": 14336203611.52,
      "marketCapChange24h": -0.75,
      "volumeChange24h": -17.45,
      "percentChange": {
        "15m": -0.1,
        "30m": -0.2,
        "1h": -0.5,
        "24h": -0.8,
        "7d": 2.3,
        "30d": 5.1,
        "1y": 95.4
      }
    },
    "eur": {"price": 58000, "marketCap": 1162000000000, ...},
    "btc": {"price": 1.0, "marketCap": 20052575, ...}
  },
  "binance": {
    "lastPrice": 62815.64,
    "priceChange": -504.35,
    "priceChangePercent": -0.797,
    "highPrice": 63448,
    "lowPrice": 62436.59,
    "volume": 7901.56,
    "quoteVolume": 496779254,
    "trades": 1495920
  }
}
```

#### Kline example (when `includeHistorical: true`)

```json
{
  "type": "kline",
  "coinId": "btc-bitcoin",
  "symbol": "BTCUSDT",
  "date": "2025-07-05",
  "open": 62500.00,
  "high": 63100.00,
  "low": 62400.00,
  "close": 62815.64,
  "volume": 7901.56,
  "quoteVolume": 496779254,
  "trades": 1495920,
  "closeTime": "2025-07-06T00:00:00+00:00"
}
```

***

### Pricing

**Pay per event:**

| Event | Cost |
|---|---|
| Coin snapshot | $0.002 |
| Kline (per day) | $0.0005 |

> ℹ️ Apify's platform usage (CU) is **passed through to you** — no markup. You only pay the per-event fee on top of CU.

**Example:** tracking top 10 coins = 10 events × $0.002 = **$0.02/run**.
With historical (30 days × 10 coins = 300 klines) = 300 × $0.0005 = **$0.15** additional.

***

### Use cases

1. **📊 Trading dashboards** — power your crypto portfolio tracker
2. **🤖 Trading bots** — feed real-time prices into automated strategies
3. **📈 Market research** — analyze trends, market cap dominance, supply metrics
4. **🔔 Price alerts** — schedule this Actor to monitor price movements
5. **🤖 LLM training data** — historical price/OHLC data for crypto analysis models
6. **📰 News/journalism** — get current prices for articles
7. **🏦 Tax/accounting** — historical cost basis for crypto holdings

***

### Technical notes

- **APIs used:**
  - [CoinPaprika](https://coinpaprika.com) — deep coin data, no rate limits
  - [Binance public API](https://binance-docs.github.io/apidocs/spot/en/) — real-time prices, klines
- **No API keys required**
- **No proxies needed** — public APIs
- **Rate limits:** CoinPaprika has no documented limit, Binance public API allows 1200 requests/minute
- **Concurrency:** Sequential (no parallel fetches) to stay well under Binance rate limits
- **Build time:** ~30s
- **Memory:** 128 MB typical

***

### Changelog

- **0.1.0** (2026-07-05) — Initial release. Multi-coin, multi-quote, optional historical klines.

***

### Support

- 🐛 Report issues: Apify Console → this Actor → Issues tab
- 💬 Questions: [Apify Discord](https://discord.com/invite/jyEM2PRvMU)
- 📧 Author: [@tikitakaclaw](https://apify.com/tikitakaclaw) on Apify

***

### License

MIT License. Data from public APIs (CoinPaprika, Binance). Use at your own risk; not financial advice.

# Actor input Schema

## `coins` (type: `string`):

Comma-separated list of coin symbols (e.g. 'BTC,ETH,SOL'). Empty = top 50 by market cap.

## `vsCurrencies` (type: `string`):

Comma-separated list of fiat/crypto to quote against.

## `includeHistorical` (type: `boolean`):

If true, fetch historical daily OHLC for each coin (last 365 days). Adds 1 item per day per coin.

## `historicalDays` (type: `integer`):

How many days of historical data to fetch (only if includeHistorical=true).

## `topN` (type: `integer`):

If 'coins' field is empty, fetch the top N coins.

## Actor input object example

```json
{
  "coins": "BTC,ETH,SOL,BNB,ADA,XRP,DOGE,AVAX,MATIC,DOT",
  "vsCurrencies": "usd,eur,btc",
  "includeHistorical": false,
  "historicalDays": 30,
  "topN": 50
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("tikitakaclaw/crypto-tracker").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("tikitakaclaw/crypto-tracker").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 tikitakaclaw/crypto-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=tikitakaclaw/crypto-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Crypto Tracker 📈 - Real-time Prices & Historical Data",
        "description": "Real-time cryptocurrency prices + historical OHLC for 2000+ coins. Combines CoinPaprika (deep coin data, market cap, supply) and Binance (live prices, 24h stats, candlesticks). Multi-quote: USD, EUR, BTC.",
        "version": "0.2",
        "x-build-id": "Yu2suDs7HrNaynBr4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/tikitakaclaw~crypto-tracker/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-tikitakaclaw-crypto-tracker",
                "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/tikitakaclaw~crypto-tracker/runs": {
            "post": {
                "operationId": "runs-sync-tikitakaclaw-crypto-tracker",
                "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/tikitakaclaw~crypto-tracker/run-sync": {
            "post": {
                "operationId": "run-sync-tikitakaclaw-crypto-tracker",
                "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": [
                    "vsCurrencies"
                ],
                "properties": {
                    "coins": {
                        "title": "Coins to track (symbols)",
                        "type": "string",
                        "description": "Comma-separated list of coin symbols (e.g. 'BTC,ETH,SOL'). Empty = top 50 by market cap.",
                        "default": "BTC,ETH,SOL,BNB,ADA,XRP,DOGE,AVAX,MATIC,DOT"
                    },
                    "vsCurrencies": {
                        "title": "Quote currencies",
                        "type": "string",
                        "description": "Comma-separated list of fiat/crypto to quote against.",
                        "default": "usd,eur,btc"
                    },
                    "includeHistorical": {
                        "title": "Include historical klines (candlesticks)",
                        "type": "boolean",
                        "description": "If true, fetch historical daily OHLC for each coin (last 365 days). Adds 1 item per day per coin.",
                        "default": false
                    },
                    "historicalDays": {
                        "title": "Historical data period (days)",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "How many days of historical data to fetch (only if includeHistorical=true).",
                        "default": 30
                    },
                    "topN": {
                        "title": "Top N coins by market cap (if no specific list)",
                        "minimum": 1,
                        "maximum": 250,
                        "type": "integer",
                        "description": "If 'coins' field is empty, fetch the top N coins.",
                        "default": 50
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
