# Crypto Momentum & Volatility Ranker (`saint_person/crypto-momentum-volatility-ranker`) Actor Compare multiple cryptocurrencies by real price momentum and volatility in one call - 1h/24h/7d change and 24h price range, ranked side by side. - **URL**: https://apify.com/saint\_person/crypto-momentum-volatility-ranker.md - **Developed by:** [saint person](https://apify.com/saint_person) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 Momentum & Volatility Ranker > ๐Ÿš€ **Compare cryptocurrencies by real momentum and volatility, in one API call.** 1h/24h/7d price change and 24h range, ranked side by side. > ๐Ÿ•’ **Last updated:** 2026-07-07 ยท ๐Ÿ“Š **11 fields** per coin ยท Built on CoinGecko's public API (no key) > ๐ŸŽ **Try it free:** the free Apify plan returns up to **10 results per run** - enough to see the output quality. Any paid Apify plan unlocks full-size runs. Give it a list of coins and it fetches live price, momentum (1h/24h/7d % change), and volatility (24h high-low range) for each in a single batched call - so you can rank a watchlist by "which is surging" or "which is most volatile right now" instead of checking each coin's page one by one. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | | --- | --- | | Crypto traders/investors, content creators, portfolio dashboards, researchers | Watchlist screening, volatility/risk comparison, trading-content research, portfolio monitoring | --- ### ๐Ÿ“‹ What this Actor does - Fetches live price, market cap rank, and 1h/24h/7d % change for every coin you list, in one call - Computes a 24h volatility signal from the high-low price range - Labels each coin's momentum SURGING / RISING / STEADY / FALLING based on 24h change - Returns everything as one clean, ranked dataset > ๐Ÿ’ก **Why it matters:** price alone doesn't tell you which coin is moving fastest or swinging hardest right now - momentum and volatility do. --- ### ๐ŸŽฌ Full demo ๐Ÿšง Video walkthrough coming soon - the Quick Start below takes under 3 minutes end to end. --- ### โš™๏ธ Input | Input | Type | Default | Behavior | | --- | --- | --- | --- | | `coins` | string | (prefilled) | Comma-separated CoinGecko coin IDs, up to 20 | **Example: Compare 5 major coins** ```json { "coins": "bitcoin, ethereum, solana, dogecoin, ripple" } ```` **Example: Watchlist screen** ```json { "coins": "bitcoin, ethereum, cardano, polkadot, avalanche-2, chainlink" } ``` > โš ๏ธ **Good to know:** use CoinGecko coin IDs (the last part of a coin's coingecko.com URL), not ticker symbols - e.g. "ripple" not "xrp". *** ### ๐Ÿ“Š Output Each coin returns **11 fields**. Download as CSV, Excel, JSON, or XML, or consume via the Apify API. #### ๐Ÿงพ Schema | Field | Type | Example | | --- | --- | --- | | id / name / symbol | string | bitcoin / Bitcoin / btc | | currentPriceUsd | number | 63240 | | change1hPct / change24hPct / change7dPct | number | 0.03 / 0.61 / 6.78 | | volatilityPct | number | 4.82 | | marketCapRank | integer | 1 | | momentumLevel | string | STEADY | | generatedAt | string | 2026-07-07T10:45:00Z | #### ๐Ÿ“ฆ Sample record ```json {"id":"bitcoin","name":"Bitcoin","symbol":"btc","currentPriceUsd":63240,"change1hPct":0.03,"change24hPct":0.61,"change7dPct":6.78,"volatilityPct":4.82,"marketCapRank":1,"momentumLevel":"STEADY","generatedAt":"2026-07-07T10:45:00Z"} ``` *** ### โœจ Why choose this Actor | | Capability | | --- | --- | | ๐Ÿ† | **Momentum + volatility together.** Not just price - the two signals traders actually compare coins on. | | ๐Ÿ’ฐ | **Multi-coin in one call.** Compare up to 20 coins in a single efficient batched request. | | โšก | **Built on CoinGecko's public API.** Free, no key - stable and durable. | | ๐Ÿ” | **Automatic retries.** Transient failures retry with backoff. | | ๐Ÿ’ณ | **Pay per result.** No subscription. A typical 5-coin run costs about $0.03. | > ๐Ÿ“Š Turns 5 separate coin-page checks into 1 ranked table. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Setup | | --- | --- | --- | --- | --- | | **โญ Crypto Momentum & Volatility Ranker** *(this Actor)* | $5 free credit, then pay-per-use | Any coin, up to 20 per run | **Live per run** | โšก 2 min | | Checking CoinGecko/CoinMarketCap manually | Free | One coin at a time | Live | ๐Ÿข Manual, one by one | | Exchange app watchlist | Free | Coins listed on that exchange | Live | ๐Ÿข No cross-coin ranking | | Manual copy-paste | Free | Current session only | One-shot | ๐Ÿข Hours of clicking | Pick this Actor when you want a ranked, multi-coin momentum/volatility view without checking each coin individually. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** Create a free Apify account with $5 credit (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the Crypto Momentum & Volatility Ranker page on the Apify Store. 3. โœ๏ธ **Set your input.** List your coins - or just press Start, the prefilled example works. 4. ๐Ÿš€ **Run it.** Watch results stream into the Dataset tab. 5. ๐Ÿ“ฅ **Download.** Grab results as CSV, Excel, JSON, or XML - or pipe them anywhere via the Apify API. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases - **Traders/investors:** screen a watchlist for the most volatile or fastest-moving coin right now. - **Content creators:** back a "top movers today" post with real numbers. - **Portfolio dashboards:** feed live momentum/volatility data into a reporting pipeline. - **Researchers:** build reproducible crypto market snapshots for analysis. *** ### ๐ŸŒŸ Beyond business use cases - ๐ŸŽ“ **Research & academia** - market microstructure and volatility studies. - ๐ŸŽจ **Personal & creative** - personal portfolio tracking, crypto newsletter content. - ๐Ÿค **Non-profit & civic** - transparency reporting on crypto market behavior. - ๐Ÿงช **Experimentation** - prototype a trading-signal dashboard on real data. *** ### ๐Ÿ”Œ Automating Crypto Momentum & Volatility Ranker **Node.js** (`apify-client` on NPM): ```javascript const { ApifyClient } = require('apify-client'); const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('saint_person/crypto-momentum-volatility-ranker').call({ coins: "bitcoin, ethereum, solana" }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ``` **Python** (`apify-client` on PyPI): ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('saint_person/crypto-momentum-volatility-ranker').call(run_input={"coins": "bitcoin, ethereum, solana"}) items = client.dataset(run['defaultDatasetId']).list_items().items ``` ๐Ÿ“š [Full Apify API documentation](https://docs.apify.com/api/v2) [Apify Schedules](https://docs.apify.com/platform/schedules) triggers this Actor on any cron interval - hourly for a standing watchlist monitor. *** ### ๐Ÿง  Use via MCP (for AI agents) Crypto Momentum & Volatility Ranker is directly callable by any MCP-compatible AI agent (Claude, ChatGPT, Cursor, and others) through Apify's hosted MCP server - no custom integration code needed. ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/sse?actors=saint_person/crypto-momentum-volatility-ranker", "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" } } } } ``` Once connected, just ask your agent something like: *"Use the Crypto Momentum & Volatility Ranker Actor to tell me which of my 5 watchlist coins is most volatile right now."* ๐Ÿ“š [Apify MCP server docs](https://docs.apify.com/platform/integrations/mcp) *** ### ๐Ÿค– Ask an AI assistant about this Actor - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Crypto%20Momentum%20%26%20Volatility%20Ranker%20on%20Apify%3F) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Crypto%20Momentum%20%26%20Volatility%20Ranker%20on%20Apify%3F) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Crypto%20Momentum%20%26%20Volatility%20Ranker%20on%20Apify%3F) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? It calls CoinGecko's official public markets API once with all requested coin IDs, then computes a volatility signal from each coin's 24h high-low range. #### Is this financial advice? No. This Actor reports public market data only. It is not a recommendation to buy, sell, or hold any asset. #### What counts as "SURGING"? A 24h price change of +10% or more. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run this Actor on any cron interval. #### โš–๏ธ Is this data legal to collect? This Actor only collects data that is publicly accessible via CoinGecko's free API. No login, no bypass of access controls. #### ๐Ÿ’ณ Do I need a paid Apify plan? No. The free Apify plan is enough for testing and small runs. #### ๐Ÿ” What happens if a run fails? Transient errors retry automatically with backoff. If a run still fails, the log explains exactly why. #### ๐Ÿ†˜ What if I need help? Open an issue on this Actor's Issues tab. *** ### ๐Ÿ”Œ Integrate with any app - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - [**Make**](https://docs.apify.com/platform/integrations/make) - [**n8n**](https://docs.apify.com/platform/integrations) - [**Google Sheets**](https://docs.apify.com/platform/integrations/drive) - [**Slack**](https://docs.apify.com/platform/integrations/slack) - [**Gmail**](https://docs.apify.com/platform/integrations/gmail) - [**Webhooks**](https://docs.apify.com/platform/integrations/webhooks) - [**MCP**](https://docs.apify.com/platform/integrations/mcp) *** ### ๐Ÿ”— Recommended Actors Pairs well with [Public Company Financials](https://apify.com/saint_person/public-company-financials) for comparing traditional and crypto asset momentum side by side. > ๐Ÿ’ก **Pro tip:** browse the complete [saint\_person collection](https://apify.com/saint_person) for more tools like this. *** ### ๐Ÿ†˜ Help & custom requests - ๐Ÿ› **Something not working?** Open an issue on this Actor's **Issues tab**. - ๐Ÿ› ๏ธ **Need a custom feature or a different data source?** Open an issue describing what you need. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by CoinGecko. All trademarks are the property of their respective owners. Only publicly available data is collected. Not financial advice. # Actor input Schema ## `coins` (type: `string`): Comma-separated CoinGecko coin IDs to compare (up to 20), e.g. 'bitcoin, ethereum, solana'. Find IDs at coingecko.com (the last part of a coin's URL). Works out of the box with the prefilled example. ## Actor input object example ```json { "coins": "bitcoin, ethereum, solana, dogecoin, ripple" } ``` # 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 = { "coins": "bitcoin, ethereum, solana, dogecoin, ripple" }; // Run the Actor and wait for it to finish const run = await client.actor("saint_person/crypto-momentum-volatility-ranker").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 = { "coins": "bitcoin, ethereum, solana, dogecoin, ripple" } # Run the Actor and wait for it to finish run = client.actor("saint_person/crypto-momentum-volatility-ranker").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 '{ "coins": "bitcoin, ethereum, solana, dogecoin, ripple" }' | apify call saint_person/crypto-momentum-volatility-ranker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=saint_person/crypto-momentum-volatility-ranker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Crypto Momentum & Volatility Ranker", "description": "Compare multiple cryptocurrencies by real price momentum and volatility in one call - 1h/24h/7d change and 24h price range, ranked side by side.", "version": "1.0", "x-build-id": "nAG48OfEnehXbrB6P" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/saint_person~crypto-momentum-volatility-ranker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-saint_person-crypto-momentum-volatility-ranker", "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/saint_person~crypto-momentum-volatility-ranker/runs": { "post": { "operationId": "runs-sync-saint_person-crypto-momentum-volatility-ranker", "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/saint_person~crypto-momentum-volatility-ranker/run-sync": { "post": { "operationId": "run-sync-saint_person-crypto-momentum-volatility-ranker", "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": [ "coins" ], "properties": { "coins": { "title": "Coin IDs", "type": "string", "description": "Comma-separated CoinGecko coin IDs to compare (up to 20), e.g. 'bitcoin, ethereum, solana'. Find IDs at coingecko.com (the last part of a coin's URL). Works out of the box with the prefilled example." } } }, "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 } } } } } } } } } } ```