# DexScreener Boosted Tokens — Promoted, Boosts & Spend Tracker (`logiover/dexscreener-boosted-tokens-scraper`) Actor Snapshot every boosted/profile-active token on DexScreener. Combines top-boosted, latest-boosted, latest-profiles + orders endpoint — boost spend, payment timestamps, order history. Auto-enriches with top pair (price, liquidity, MC, FDV). For memecoin signals, pay-to-pump tracking, marketing intel. - **URL**: https://apify.com/logiover/dexscreener-boosted-tokens-scraper.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Marketing, Business, Lead generation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results 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 ## DexScreener Boosted Tokens Scraper — Promoted Tokens, Marketing Spend & Pay-to-Pump Tracker ![DexScreener Boosted Tokens — Promoted, Boosts & Spend Tracker](https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/GjS6nQ8qauOdq9KGy-actor-aRM1h4hp400lm2Qwt-uAf4JRmifX-unnamed.png) **Real-time snapshot of every token currently boosted, promoted, or with an active token profile on DexScreener — combined with full marketing-order history and live top-pair data.** Boost amounts, payment timestamps, community-takeover orders, profile orders, token ads, and price + liquidity + volume + market cap + FDV — all in one flat row per token. The single most comprehensive source of **paid promotion intent on DEX trading** — built for memecoin signal services, pay-to-pump detection systems, marketing intelligence platforms, trend discovery dashboards and on-chain alpha hunters across Solana, Ethereum, Base, BSC and 30+ chains. 🟢 No API key. No proxy. No login. Pure public REST API. --- ### 🚀 Why this scraper DexScreener doesn't just index DEX trading — it operates a **paid promotion marketplace** where projects can pay for visibility. Every payment is logged publicly through their `orders/v1` endpoint: - 🔼 **Boosts** — pure visibility credit (token rises in trending and featured slots) - 🏷️ **Token Profiles** — token gets a richer description, logo, links, banner image - 🤝 **Community Takeover** — badge declaring grassroots ownership change (paid) - 📢 **Token Ads** — banner / display ad placement The **pattern** of these payments is one of the strongest "paying-attention-now" signals on DeFi. A token paying $500 in boosts followed by a $1000 community-takeover order followed by a price pump is a textbook pay-to-pump cycle. Catching it early is alpha. This scraper pulls all three live promotion feeds (top-boosted, latest-boosted, latest-profiles), deduplicates them, fetches each unique token's **full marketing-order history**, and enriches each one with **live top-pair data** — so you can correlate spend vs. market response side-by-side, immediately. --- ### ✨ Key features | Feature | What it gives you | |---|---| | 🎯 **Three discovery feeds in one** | top-boosted, latest-boosted, latest-profiles — deduplicated and merged | | 💰 **Full marketing-order history** | Every order ever placed for each token — boosts, profiles, takeovers, ads — with payment timestamps | | 📊 **Auto top-pair enrichment** | Live price USD, liquidity USD, FDV, market cap, 24h volume, transactions for each token | | 🌍 **Multi-chain** | Solana, Ethereum, Base, BSC, Polygon, Arbitrum + 30 more | | 🔍 **Chain whitelist** | Filter to just the chains you care about | | 🎚️ **Boost-amount threshold** | Drop tokens with weak promotion spend | | ⚡ **Concurrent enrichment** | 6–10 parallel API calls keep throughput high | | 🗃️ **Flat ready-to-use rows** | 40+ columns, no nested JSON to wrangle | | 💾 **JSON, CSV, Excel exports** | Direct from Apify Dataset | | 🔓 **Public API only** | No auth, no proxy, no scraping | --- ### 🎯 Built for these use cases #### 1. Memecoin signal services & alpha alerts Subscribers want to be alerted when a token starts spending significantly on DexScreener boosts — historically a precursor to organized pumps. Schedule this scraper every 5–15 minutes, alert when `boostTotalAmount > N` AND `pairCreatedAt < 24h`. #### 2. Pay-to-pump detection Correlate boost timestamps with price action. Boost spent at T, price moved +50% within 2 hours? Likely orchestrated. Build the dataset, train the model. #### 3. Marketing intelligence Competitor intel: who's paying for visibility on DexScreener right now? What chains? What sizes? Build a dashboard tracking the paid-marketing landscape on DEX. #### 4. Pump.fun trend tracking on Solana Solana memecoin launches that take marketing seriously stand out. Filter `chainId=solana`, `boostTotalAmount > 500` → freshly launched tokens with serious marketing intent. #### 5. Anti-rug intelligence Fresh `tokenProfile` orders by brand-new pools (hours old) with low organic liquidity = yellow flag. Combine with our `dexscreener-pair-security-scraper` for full risk picture. #### 6. Newsletter & content data Daily "What's being promoted on DexScreener right now" reports. Top 10 by boost spend. Movers of the day. #### 7. Listing & directory products Power "Hot on DEX" feeds for crypto sites, Telegram bots, Discord communities. #### 8. Research & academic work Quantify the paid-promotion ecosystem on DEXes. Spend distributions. Pump correlations. --- ### 📥 Inputs | Field | Type | Required | Description | |---|---|---|---| | `sources` | string[] | No | Which feeds to pull. Choose any subset of `top-boosted`, `latest-boosted`, `latest-profiles`. Default: all three (best coverage). | | `onlyChains` | string[] | No | Whitelist chains. Examples: `solana`, `ethereum`, `base`, `bsc`. Leave empty for all. | | `minBoostAmount` | int | No | Skip tokens with `totalAmount` below this threshold. Default `0`. | | `includeOrders` | bool | No | Fetch full marketing-order history per token (1 extra API call). Default `true`. | | `enrichWithPairData` | bool | No | Fetch live top-pair data per token (1 extra API call). Default `true`. | | `maxConcurrency` | int | No | Parallel enrichment requests (1–30). Default `6`. | #### Example inputs **Default — full snapshot, all sources, all chains:** ```json {} ```` **Solana-only memecoin signal:** ```json { "sources": ["top-boosted", "latest-boosted"], "onlyChains": ["solana"], "minBoostAmount": 100 } ``` **Lightweight (no enrichment, just IDs):** ```json { "enrichWithPairData": false, "includeOrders": false } ``` **Heavily promoted only:** ```json { "sources": ["top-boosted"], "minBoostAmount": 1000 } ``` *** ### 📤 Output (per boosted token) ```json { "source": "top-boosted,latest-boosted", "chainId": "solana", "tokenAddress": "jvKtLFLnNGPM7edS9KEpYqPxuY8HPGTZohLFM4Spump", "url": "https://dexscreener.com/solana/jvktlf...", "icon": "l9_kCTGxMR3jBKym", "header": "https://cdn.dexscreener.com/cms/images/...", "openGraph": "https://cdn.dexscreener.com/token-images/og/...", "description": "Andes virus is the only type of hantavirus...", "links": [ { "url": "https://andes-virus.online/" }, { "type": "twitter", "url": "https://x.com/AndesVirus" }, { "type": "telegram", "url": "https://t.me/AndesVirusOnSol" } ], "boostAmount": 100, "boostTotalAmount": 1500, "ordersCount": 8, "boostsCount": 5, "approvedOrdersCount": 4, "lastOrderType": "communityTakeover", "lastOrderStatus": "approved", "lastOrderPaidAt": "2026-05-15T09:13:17.907Z", "firstOrderPaidAt": "2026-05-08T11:23:51.596Z", "orders": [ { "type": "communityTakeover", "status": "approved", "paymentTimestamp": 1778221997907 }, { "type": "tokenProfile", "status": "approved", "paymentTimestamp": 1778061033596 } ], "boosts": [ { "id": "kVAP240vHbWB2qDlvZ59", "amount": 100, "paymentTimestamp": 1778875339059 } ], "topPairAddress": "jHmCrrLMPtE1qvYpwe1yjtjzM2k44EorPDUcJ6j8pWC", "topPairDexId": "pumpswap", "topPairUrl": "https://dexscreener.com/solana/jhmcrrl...", "baseTokenSymbol": "ANDV", "baseTokenName": "Andes Virus", "quoteTokenSymbol": "SOL", "priceUsd": 0.0006267, "liquidityUsd": 75000, "marketCap": 626700, "fdv": 626700, "volumeH24": 371792.92, "volumeH6": 92000, "volumeH1": 18500, "priceChangeH24": 8.4, "priceChangeH6": -1.2, "priceChangeH1": 0.5, "txnsH24Buys": 2012, "txnsH24Sells": 1755, "pairCreatedAt": "2026-04-12T08:23:11.000Z", "scrapedAt": "2026-05-16T08:42:00.000Z" } ``` *** ### 📚 Marketing-order types explained | Order type | What it means | Cost signal | |---|---|---| | `boost` | Pure visibility — token rises in trending and featured slots for ~24h per boost unit | Cheap, frequent — often used in clusters | | `tokenProfile` | Token gets a verified profile page (logo, banner, description, links) | One-time setup, ~$300–500 | | `communityTakeover` | Badge declaring grassroots community control of a previously-claimed project | Higher cost, often signals "new wave" of holders organizing | | `tokenAd` | Banner / display ad placement on DexScreener pages | Premium, usually $1000+ for serious promotion | | `approved` status | Payment received, order live | The signal that matters | | `cancelled` status | Order rejected or refunded | Filter these out or use for fraud-pattern detection | *** ### ⚙️ How it works 1. **Hits enabled discovery endpoints** sequentially: - `/token-boosts/top/v1` (top by spend) - `/token-boosts/latest/v1` (most recently boosted) - `/token-profiles/latest/v1` (newly created profile pages) 2. **Deduplicates by** `(chainId, tokenAddress)` and merges metadata 3. **Filters** by chain whitelist and `minBoostAmount` 4. **For each unique token**, in parallel (concurrency 6 by default): - Fetches `/orders/v1/{chain}/{token}` (marketing-order history) - Fetches `/latest/dex/tokens/{token}` (top pair) 5. **Picks the top pair** on the matching chain by USD liquidity desc 6. **Flattens** marketing + pair data into a single row 7. **Streams** results to the Apify Dataset Public API only — no auth, no proxy, no scraping. *** ### ⚡ Performance | Workload | Time | API calls | |---|---|---| | All 3 sources, full enrichment | ~30 seconds | ~3 + (2 × ~60 unique tokens) ≈ 123 | | Lightweight (no enrichment) | ~3 seconds | 3 | | All 3 sources, chain-filtered | ~25 seconds | ~3 + (2 × N tokens) | Total unique tokens after dedup typically lands around 50–90. *** ### 💰 Cost model **Pay-Per-Result** — billed only on actual token rows saved. Typical run: ~50–90 rows. Schedule every 5–15 minutes for active signal services; results compound to thousands of rows per day. *** ### 🔄 Schedule for continuous monitoring - **Every 5 minutes** — high-frequency memecoin signal services - **Every 15 minutes** — most alpha alerters - **Hourly** — marketing-intelligence dashboards - **Daily** — newsletter / content data Each scheduled run captures a new snapshot. The `paymentTimestamp` fields let you correlate exact moments across history. *** ### 🚨 Pay-to-pump detection recipe ```pseudo For each new run output: Compare token's boostTotalAmount to its value 30 minutes ago If delta > $500 AND pairCreatedAt < 24h ago: ALERT: "fresh token with spiking boost spend" If delta > $1000 AND lastOrderType == communityTakeover: ALERT: "active takeover with serious spend" If priceChangeH1 > 30% AND lastOrderPaidAt within 2 hours: ALERT: "potential paid-promotion pump in progress" ``` Schedule the actor every 15 minutes. Diff outputs in your downstream pipeline. The signal is in the deltas. *** ### 🛠️ FAQ **How fresh is the data?** DexScreener's promotion feeds update within seconds of payment confirmation on-chain. By the time you see a boost in `latest-boosted`, the token's visibility has already increased. **What's the difference between top-boosted, latest-boosted, latest-profiles?** - `top-boosted` = currently leading by lifetime spend (rotation every few hours) - `latest-boosted` = most recently boosted tokens (rotation every few minutes) - `latest-profiles` = newly created token profile pages (rotation when paid) **Are the listed amounts in USD?** Boost units roughly equate to USD spent at DexScreener's standard rates, but the official rate card can vary. Treat `boostAmount` and `boostTotalAmount` as marketing-spend signals in DexScreener's internal units. The relative ordering (which tokens spent more) is reliable. **Why are some tokens listed without pair data?** A few promoted tokens have no live DEX pair (pre-launch, just rugged, removed). They still appear in the output with marketing data; price/liquidity fields will be `null`. **Does community takeover always mean the project is legit?** No. It just means someone paid to claim grassroots ownership. Use it as ONE signal among others (audit, holders, liquidity locks via our pair-security scraper). **Can I get historical boost data?** The `orders` array includes ALL orders ever placed for each token (the full history). To build time-series of how boost spend evolved, schedule the actor and aggregate downstream. **What chains are covered?** All DexScreener-supported chains. Most paid promotion is concentrated on Solana (~70%) and Ethereum/Base (~20%), with the rest spread across BSC, Polygon, Arbitrum, etc. **Does the orders endpoint always return data?** For tokens with at least one promotion, yes. Tokens with no payment history return empty arrays. **How does this compare to manually checking DexScreener?** DexScreener's UI shows you ~30 boosted tokens at a time and doesn't expose order history or chain mix. This scraper gives you the full picture in one batched API run. *** ### 📚 Related scrapers in the DexScreener suite | Scraper | Purpose | |---|---| | `dexscreener-token-pairs-scraper` | Token address → ALL pairs (multi-chain). | | `dexscreener-search-pairs-scraper` | Free-text query → matching pairs. | | `dexscreener-pair-watchlist-scraper` | Pair address → current data. | | **`dexscreener-boosted-tokens-scraper`** | **You are here.** Boosted/promoted tokens + marketing spend. | | `dexscreener-pair-security-scraper` | Deep security audit, holders, locks, CG/CMC metadata. | *** ### 🔑 Keyword cloud **Core:** dexscreener boosted tokens, pay to pump tracker, memecoin signal, dex marketing spend, pumpfun trending, solana memecoin scanner, dex token profiles, dexscreener trending api, dex ads tracker, crypto promotion data. **Per chain / DEX:** solana memecoin alpha, pumpswap trending, raydium memecoin, ethereum memecoin scanner, base memecoin tracker, bsc promoted tokens, pancakeswap memecoin. **Per use case:** memecoin alert service, alpha signal api, pump detection, marketing intelligence defi, crypto promotion intel, defi anti-rug, solana pump fun signals, dex featured tokens, paid promotion tracker, marketing analytics crypto. **Per audience:** memecoin trader, crypto signal service, web3 marketing analyst, defi researcher, pump trader, alpha hunter, sol memecoin sniper. # Actor input Schema ## `sources` (type: `array`): Which DexScreener listings to pull. Combine freely. Available sources: 'top-boosted' (the top boosted tokens by spend, ~30 results), 'latest-boosted' (the most recently boosted tokens, ~30 results), 'latest-profiles' (tokens with a recently created DexScreener profile page, ~30 results). Each source is hit independently then results are deduplicated by (chainId, tokenAddress). ## `onlyChains` (type: `array`): Whitelist of chain IDs. Filters out boosted tokens on other chains. Examples: 'solana', 'ethereum', 'base', 'bsc'. Leave empty to include all. ## `minBoostAmount` (type: `integer`): Skip tokens with `totalAmount` (lifetime boost units paid) below this threshold. DexScreener boost units roughly equate to USD spent. Example: 100 to drop weakly promoted tokens, 1000 to focus on serious marketing spend. ## `includeOrders` (type: `boolean`): When enabled, fetches the `orders/v1/{chain}/{token}` endpoint for each boosted token and includes full marketing-order history: order type (`tokenProfile`, `communityTakeover`, `tokenAd`), status (`approved`, `cancelled`), payment timestamp, and boost IDs/amounts. Adds one extra API call per token. ## `enrichWithPairData` (type: `boolean`): When enabled, fetches each boosted token's top trading pair (`latest/dex/tokens/{token}`) to add live price USD, liquidity USD, FDV, market cap, 24h volume, 24h price change and transaction counts. Adds one extra API call per token. Highly recommended — most users want price + boost data together. ## `maxConcurrency` (type: `integer`): Parallel enrichment requests. Recommended 5–10. DexScreener allows ~300 req/min on token endpoints. ## Actor input object example ```json { "sources": [ "top-boosted", "latest-boosted", "latest-profiles" ], "onlyChains": [], "minBoostAmount": 0, "includeOrders": true, "enrichWithPairData": true, "maxConcurrency": 6 } ``` # Actor output Schema ## `chainId` (type: `string`): Chain ID ## `tokenAddress` (type: `string`): Token contract address ## `baseTokenSymbol` (type: `string`): Base token symbol ## `boostTotalAmount` (type: `string`): Total boost units spent ## `priceUsd` (type: `string`): Current USD price ## `liquidityUsd` (type: `string`): Top pair USD liquidity ## `volumeH24` (type: `string`): 24h USD volume ## `priceChangeH24` (type: `string`): 24h price change % ## `marketCap` (type: `string`): Market cap USD ## `url` (type: `string`): DexScreener token URL ## `scrapedAt` (type: `string`): ISO 8601 timestamp # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("logiover/dexscreener-boosted-tokens-scraper").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 = {} # Run the Actor and wait for it to finish run = client.actor("logiover/dexscreener-boosted-tokens-scraper").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 logiover/dexscreener-boosted-tokens-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/dexscreener-boosted-tokens-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DexScreener Boosted Tokens — Promoted, Boosts & Spend Tracker", "description": "Snapshot every boosted/profile-active token on DexScreener. Combines top-boosted, latest-boosted, latest-profiles + orders endpoint — boost spend, payment timestamps, order history. Auto-enriches with top pair (price, liquidity, MC, FDV). For memecoin signals, pay-to-pump tracking, marketing intel.", "version": "1.0", "x-build-id": "kYHR0577THbatzqkk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~dexscreener-boosted-tokens-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-dexscreener-boosted-tokens-scraper", "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/logiover~dexscreener-boosted-tokens-scraper/runs": { "post": { "operationId": "runs-sync-logiover-dexscreener-boosted-tokens-scraper", "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/logiover~dexscreener-boosted-tokens-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-dexscreener-boosted-tokens-scraper", "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": { "sources": { "title": "Data Sources", "type": "array", "description": "Which DexScreener listings to pull. Combine freely. Available sources: 'top-boosted' (the top boosted tokens by spend, ~30 results), 'latest-boosted' (the most recently boosted tokens, ~30 results), 'latest-profiles' (tokens with a recently created DexScreener profile page, ~30 results). Each source is hit independently then results are deduplicated by (chainId, tokenAddress).", "default": [ "top-boosted", "latest-boosted", "latest-profiles" ], "items": { "type": "string" } }, "onlyChains": { "title": "Only Include These Chains", "type": "array", "description": "Whitelist of chain IDs. Filters out boosted tokens on other chains. Examples: 'solana', 'ethereum', 'base', 'bsc'. Leave empty to include all.", "default": [], "items": { "type": "string" } }, "minBoostAmount": { "title": "Minimum Total Boost Amount", "minimum": 0, "type": "integer", "description": "Skip tokens with `totalAmount` (lifetime boost units paid) below this threshold. DexScreener boost units roughly equate to USD spent. Example: 100 to drop weakly promoted tokens, 1000 to focus on serious marketing spend.", "default": 0 }, "includeOrders": { "title": "Include Marketing Order History", "type": "boolean", "description": "When enabled, fetches the `orders/v1/{chain}/{token}` endpoint for each boosted token and includes full marketing-order history: order type (`tokenProfile`, `communityTakeover`, `tokenAd`), status (`approved`, `cancelled`), payment timestamp, and boost IDs/amounts. Adds one extra API call per token.", "default": true }, "enrichWithPairData": { "title": "Enrich With Top Pair Data", "type": "boolean", "description": "When enabled, fetches each boosted token's top trading pair (`latest/dex/tokens/{token}`) to add live price USD, liquidity USD, FDV, market cap, 24h volume, 24h price change and transaction counts. Adds one extra API call per token. Highly recommended — most users want price + boost data together.", "default": true }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parallel enrichment requests. Recommended 5–10. DexScreener allows ~300 req/min on token endpoints.", "default": 6 } } }, "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 } } } } } } } } } } ```