# Crypto Volume Anomaly Scanner — Pump Detection, Top 50 Coins (`cryptosignals/crypto-signals`) Actor

Scans the top 50 coins by 24h volume and ranks them by volume-to-market-cap ratio — the classic pump fingerprint. Full market scan for $0.01, or deep-dive one token (BTC, ETH, SOL…) with an anomaly rating from LOW to CRITICAL. Clean JSON for trading bots, alerts, and dashboards.

- **URL**: https://apify.com/cryptosignals/crypto-signals.md
- **Developed by:** [Web Data Labs](https://apify.com/cryptosignals) (community)
- **Categories:** AI
- **Features:** Limited permissions
- **Stats:** 142 total users, 10 monthly users, 99.9% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 full market scans

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Crypto AI Signal Scanner — Pump Detection & Whale Alerts

The price for each result is on this actor's [Pricing tab](https://apify.com/cryptosignals/crypto-signals/pricing).

Detect crypto pump signals and whale movements before they hit mainstream attention. Scans 50+ tokens including BTC, ETH, SOL for volume anomalies in real-time. Bot-ready JSON output, zero setup — no API key needed. On-demand for cents per run.

***

### Features

- **Volume anomaly detection** — computes volume-to-market-cap ratio for every token and ranks them by signal strength
- **50+ tokens scanned** — covers the top 50 coins by trading volume in a single run
- **Anomaly classification** — each token is labelled LOW, MODERATE, HIGH, or CRITICAL based on its ratio
- **Single-token mode** — pass one symbol (e.g. `SOL`) for a focused, instant analysis
- **Full market scan mode** — leave the symbol blank to scan all 50 tokens at once
- **Real-time data** — powered by the free CoinGecko `/coins/markets` endpoint; no key needed
- **Pay-per-event pricing** — you pay only for what you use (one `analyze` charge per single-token run, one `scan` charge per full scan)
- **Dataset output** — results land in Apify's structured dataset, ready for webhooks, integrations, or downstream Actors

***

### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `symbol` | string | No | Token ticker to analyse (e.g. `BTC`, `ETH`, `SOL`). Leave empty to run a full 50-token scan. |

#### Example — Single Token

```json
{
  "symbol": "SOL"
}
```

#### Example — Full Market Scan

```json
{}
```

***

### Output Format

Results are pushed to the Apify dataset. Each record contains:

| Field | Type | Description |
|-------|------|-------------|
| `symbol` | string | Token ticker (e.g. `BTC`) |
| `price` | number | Current price in USD |
| `change_24h` | number | 24-hour price change (%) |
| `volume` | number | 24-hour trading volume (USD) |
| `market_cap` | number | Market capitalisation (USD) |
| `vol_mcap_ratio` | number | Volume ÷ market cap × 100 (%) |
| `anomaly_level` | string | `LOW` / `MODERATE` / `HIGH` / `CRITICAL` |

#### Anomaly Level Thresholds

| Level | Vol/MCap Ratio |
|-------|---------------|
| LOW | < 2% |
| MODERATE | 2% – 5% |
| HIGH | 5% – 20% |
| CRITICAL | > 20% |

#### Example Output Record

```json
{
  "symbol": "SOL",
  "price": 142.57,
  "change_24h": 8.34,
  "volume": 4820000000,
  "market_cap": 65000000000,
  "vol_mcap_ratio": 7.42,
  "anomaly_level": "HIGH",
  "found": true
}
```

Full-scan output is an array of such records, sorted by `vol_mcap_ratio` descending so the hottest signals appear first.

***

### Use Cases

#### Detect Pump-and-Dump Schemes

A sudden spike in volume relative to market cap (CRITICAL level) is a classic early indicator of a pump. Run this Actor on a schedule and alert yourself when any token crosses the CRITICAL threshold.

#### Monitor Whale Movements

Large players moving in or out of a position generate outsized volume. HIGH and CRITICAL signals can surface these movements before price reacts.

#### Build Trading Alerts

Connect the dataset output to a webhook or downstream Actor to push Telegram/Slack/email notifications the moment an anomaly appears.

#### DeFi Research & Backtesting

Pull historical snapshots into a dataset over time to study which anomaly levels preceded significant price moves.

#### Algorithmic Trading Systems

Integrate this Actor into a trading pipeline as a signal source. Low latency, no authentication overhead, clean structured output.

***

### How It Works

1. The Actor calls the CoinGecko `/coins/markets` endpoint, requesting the top 50 coins ordered by 24-hour trading volume.
2. For each token, it computes `vol_mcap_ratio = (24h_volume / market_cap) × 100`.
3. Tokens are sorted by this ratio in descending order — highest anomaly first.
4. Each token is labelled with an `anomaly_level` based on fixed thresholds (see table above).
5. Results are pushed to the Apify dataset. In single-token mode, only the matched token is returned.
6. A pay-per-event charge is recorded (`analyze` for single token, `scan` for full market scan).

No third-party API keys are required. CoinGecko's public endpoint is rate-limited; the Actor includes automatic retry with exponential back-off.

***

### Pricing

This Actor uses **pay-per-event** billing (when enabled by the publisher):

| Event | Description | Charge |
|-------|-------------|--------|
| `analyze` | Single-token analysis | Per run |
| `scan` | Full 50-token market scan | Per run |

You are never charged for failed runs or rate-limit retries. Standard Apify platform compute costs also apply.

***

### Scheduling

For continuous monitoring, add this Actor to an **Apify Schedule**:

- Every 15 minutes for active trading alert systems
- Every hour for daily research workflows
- Daily for backtesting data collection

***

### FAQ

**Q: Does this require a CoinGecko API key?**
A: No. The Actor uses CoinGecko's free public endpoint. No sign-up required.

**Q: Which tokens are covered?**
A: The top 50 tokens by 24-hour trading volume at the time of the run. This typically includes BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, MATIC, LINK, and many others.

**Q: Can I scan more than 50 tokens?**
A: Not in the current version. A future version will support configurable page count via the input.

**Q: How fresh is the data?**
A: CoinGecko updates market data roughly every 60 seconds. Each run fetches live data at execution time.

**Q: What does a CRITICAL anomaly mean?**
A: A vol/mcap ratio above 20% means that in the last 24 hours, more than 20% of the token's entire market cap changed hands. This is statistically unusual and often precedes significant price movement — in either direction.

**Q: Is this financial advice?**
A: No. Crypto Signals is a data tool. All trading decisions are your own responsibility.

***

### Related Resources

- [Apify Actor page](https://apify.com/cryptosignals/crypto-signals)
- [CoinGecko API docs](https://www.coingecko.com/en/api/documentation)
- [Apify Schedules](https://docs.apify.com/platform/schedules)
- [Apify Webhooks](https://docs.apify.com/platform/integrations/webhooks)

***

### Support

Found a bug or want a feature? Open an issue or contact the publisher through the Apify Store page.

### Using Proxies for Reliable Scanning

Crypto data endpoints can rate-limit or block repeated requests. For reliable, uninterrupted scanning, use residential proxies from [ThorData](https://thordata.partnerstack.com/partner/0a0x4nzh) to rotate IPs and avoid blocks.

ThorData offers affordable residential proxies with global coverage — ideal for running crypto scanners at scale without getting throttled.

***

*Found this actor useful? [Leave a review](https://apify.com/cryptosignals/crypto-signals#reviews) - it helps a lot. Something broken? Report it on the [Issues tab](https://apify.com/cryptosignals/crypto-signals/issues).*

# Actor input Schema

## `symbol` (type: `string`):

Optional token ticker (e.g. BTC, ETH, SOL). Leave empty for a full scan of top 50 tokens.

## Actor input object example

```json
{}
```

# Actor output Schema

## `cryptoSignals` (type: `string`):

Dataset containing crypto token volume anomaly signals with fields: symbol, price, change_24h, volume, market_cap, vol_mcap_ratio, anomaly_level, found.

# 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("cryptosignals/crypto-signals").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("cryptosignals/crypto-signals").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 cryptosignals/crypto-signals --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cryptosignals/crypto-signals"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JLRubZOreFa6sK14t/builds/RTeFxSrIdYIbooi9L/openapi.json