# AI Token Sector Tracker (`gochujang/ai-token-sector-tracker`) Actor Track the AI/Agent crypto token ecosystem. Returns market cap, volume, price changes for AI-category tokens across multiple CoinGecko categories. Includes sector summary and top movers. - **URL**: https://apify.com/gochujang/ai-token-sector-tracker.md - **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community) - **Categories:** Developer tools, Automation, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 token returneds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## AI Token Sector Tracker > Track the **AI/Agent crypto token ecosystem** — market cap, volume, 24h/7d/30d price changes, sector dominance, and top movers. Covers `artificial-intelligence`, `ai-agents`, `decentralized-ai`, and `large-language-model` categories from CoinGecko's public API. **No API key required.** --- ### ⚡ Run in 30 seconds Click **Start** with default settings — you get market cap, 24h/7d/30d price changes, and volume for every token across the AI/Agent crypto sector, plus aggregate sector dominance vs total crypto market cap. No API key needed. --- ### Why this exists The AI token sector moves in cycles distinct from the broader crypto market. When narrative rotates into AI (model releases, agent frameworks going live, big VC rounds), entire baskets of AI tokens pump together — often 2–5× faster than BTC or ETH. This actor gives you a single pull to monitor the whole sector: which tokens are leading, which are lagging, and how the aggregate AI sector dominance is shifting vs the total crypto market cap. --- ### What you get per row | Field | Example | Notes | |---|---|---| | `symbol` | `FET` | ticker | | `name` | `Fetch.ai` | full name | | `category` | `artificial-intelligence` | which CoinGecko category | | `price_usd` | `1.23` | current price | | `market_cap_usd` | `3100000000` | market cap | | `volume_24h_usd` | `85000000` | 24h trading volume | | `price_change_24h_pct` | `8.32` | % change vs 24h ago | | `price_change_7d_pct` | `-3.1` | % change vs 7d ago | | `price_change_30d_pct` | `42.5` | % change vs 30d ago | | `volume_to_mcap` | `0.027` | volume/mcap ratio (liquidity signal) | | `ath_change_pct` | `-68.4` | % from all-time high | --- ### SUMMARY key-value store Every run writes a `SUMMARY` record with: - `sector_total_mcap_usd` — aggregate AI token market cap - `sector_total_volume_24h` — aggregate 24h volume - `sector_avg_change_24h` — equal-weight average 24h change - `ai_dominance_pct` — AI sector as % of total crypto market cap - `top5_gainers_24h` / `top5_losers_24h` — top movers --- ### Categories covered | Category ID | Tokens include | |---|---| | `artificial-intelligence` | FET, TAO, RENDER, NEAR, GRT, WLD | | `ai-agents` | VIRTUAL, AI16Z, AIXBT, GOAT | | `decentralized-ai` | OCEAN, NMR, AGIX | | `large-language-model` | Tokens powering on-chain LLM infrastructure | --- ### Input parameters | Parameter | Type | Default | Description | |---|---|---|---| | `categories` | array | all 4 AI categories | CoinGecko category IDs to fetch | | `vsCurrency` | string | `usd` | Quote currency (usd, btc, eth) | | `perPage` | integer | `50` | Max tokens per category (max 250) | | `sortBy` | string | `market_cap_desc` | Sort: `market_cap_desc`, `volume_desc`, `price_change_24h_desc`, `price_change_24h_asc` | | `minMarketCapUsd` | number | `0` | Filter: min market cap | | `minVolume24hUsd` | number | `0` | Filter: min 24h volume | | `deduplicate` | boolean | `true` | Remove duplicates across categories | | `includeGlobalContext` | boolean | `true` | Compute AI dominance % vs global market | --- ### Quick start #### Default — all AI categories, top 50 each ```json {} ```` #### Top AI tokens by 24h gains ```json { "sortBy": "price_change_24h_desc", "minMarketCapUsd": 50000000 } ``` #### AI agents only, sorted by volume ```json { "categories": ["ai-agents"], "sortBy": "volume_desc", "perPage": 100 } ``` #### Large-cap AI sector overview ```json { "minMarketCapUsd": 500000000, "sortBy": "market_cap_desc" } ``` *** ### Use cases 1. **Sector rotation** — Compare `sector_avg_change_24h` vs BTC/ETH. When AI outperforms 2×+, rotation is live 2. **Narrative alerts** — Schedule daily runs; alert when `ai_dominance_pct` moves ±0.5% 3. **Top mover hunting** — Sort by `price_change_24h_desc` to catch breakouts early 4. **Liquidity screening** — Filter by `minVolume24hUsd` to avoid illiquid micro-caps 5. **Portfolio benchmarking** — Track your AI holdings vs the sector average *** ### Pricing **Pay-Per-Event**: `$0.001 per token returned` | Run | Tokens | Cost | |---|---|---| | Default (4 categories × 50, deduped ~80 unique) | ~80 | $0.08 | | Single category, top 50 | 50 | $0.05 | | All categories, 250 each | ~300 unique | $0.30 | *** ### Data source [CoinGecko Public API](https://www.coingecko.com/en/api) — free tier, no API key required. Data updates every 60 seconds on CoinGecko's side. *** ### Related actors (same author) - [Crypto Category Screener](https://apify.com/gochujang/crypto-category-screener) — any CoinGecko category - [Crypto Momentum Scanner](https://apify.com/gochujang/crypto-momentum-scanner) — multi-timeframe momentum - [Crypto News Sentiment](https://apify.com/gochujang/crypto-news-sentiment) — AI token news sentiment - [DeFi Yield APY Scanner](https://apify.com/gochujang/defi-yield-scanner) — yield opportunities # Actor input Schema ## `categories` (type: `array`): CoinGecko category IDs to fetch. Defaults to all 4 AI categories. ## `vsCurrency` (type: `string`): Currency for prices and market cap (e.g. usd, btc, eth). ## `perPage` (type: `integer`): Max tokens to fetch per category (max 250). ## `sortBy` (type: `string`): Sort order for output rows. ## `minMarketCapUsd` (type: `number`): Filter out tokens below this market cap. ## `minVolume24hUsd` (type: `number`): Filter out tokens below this 24h volume. ## `deduplicate` (type: `boolean`): Remove tokens that appear in multiple categories (keeps first occurrence by market cap). ## `includeGlobalContext` (type: `boolean`): Fetch global crypto market cap to compute AI sector dominance %. ## Actor input object example ```json { "categories": [ "artificial-intelligence", "ai-agents", "decentralized-ai", "large-language-model" ], "vsCurrency": "usd", "perPage": 50, "sortBy": "market_cap_desc", "minMarketCapUsd": 0, "minVolume24hUsd": 0, "deduplicate": true, "includeGlobalContext": true } ``` # 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 = { "categories": [ "artificial-intelligence", "ai-agents", "decentralized-ai", "large-language-model" ], "vsCurrency": "usd" }; // Run the Actor and wait for it to finish const run = await client.actor("gochujang/ai-token-sector-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "categories": [ "artificial-intelligence", "ai-agents", "decentralized-ai", "large-language-model", ], "vsCurrency": "usd", } # Run the Actor and wait for it to finish run = client.actor("gochujang/ai-token-sector-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 '{ "categories": [ "artificial-intelligence", "ai-agents", "decentralized-ai", "large-language-model" ], "vsCurrency": "usd" }' | apify call gochujang/ai-token-sector-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gochujang/ai-token-sector-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AI Token Sector Tracker", "description": "Track the AI/Agent crypto token ecosystem. Returns market cap, volume, price changes for AI-category tokens across multiple CoinGecko categories. Includes sector summary and top movers.", "version": "0.1", "x-build-id": "sdvpOecMHRgNGk72X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gochujang~ai-token-sector-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gochujang-ai-token-sector-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/gochujang~ai-token-sector-tracker/runs": { "post": { "operationId": "runs-sync-gochujang-ai-token-sector-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/gochujang~ai-token-sector-tracker/run-sync": { "post": { "operationId": "run-sync-gochujang-ai-token-sector-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", "properties": { "categories": { "title": "AI Categories", "type": "array", "description": "CoinGecko category IDs to fetch. Defaults to all 4 AI categories.", "default": [ "artificial-intelligence", "ai-agents", "decentralized-ai", "large-language-model" ], "items": { "type": "string" } }, "vsCurrency": { "title": "Quote Currency", "type": "string", "description": "Currency for prices and market cap (e.g. usd, btc, eth).", "default": "usd" }, "perPage": { "title": "Tokens Per Category", "minimum": 1, "maximum": 250, "type": "integer", "description": "Max tokens to fetch per category (max 250).", "default": 50 }, "sortBy": { "title": "Sort By", "enum": [ "market_cap_desc", "volume_desc", "price_change_24h_desc", "price_change_24h_asc" ], "type": "string", "description": "Sort order for output rows.", "default": "market_cap_desc" }, "minMarketCapUsd": { "title": "Min Market Cap (USD)", "type": "number", "description": "Filter out tokens below this market cap.", "default": 0 }, "minVolume24hUsd": { "title": "Min 24h Volume (USD)", "type": "number", "description": "Filter out tokens below this 24h volume.", "default": 0 }, "deduplicate": { "title": "Deduplicate Tokens", "type": "boolean", "description": "Remove tokens that appear in multiple categories (keeps first occurrence by market cap).", "default": true }, "includeGlobalContext": { "title": "Include Global Market Context", "type": "boolean", "description": "Fetch global crypto market cap to compute AI sector dominance %.", "default": true } } }, "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 } } } } } } } } } } ```