# GMGN Smart Money Buy Signals — Live Whale & KOL Feed (`logiover/gmgn-smart-money-buy-signals`) Actor Live feed of tokens where smart-money, KOL, whale wallets are buying RIGHT NOW. Pulls GMGN.ai smart-money cards (last 24h) and live trade stream across all 6 chains. Each token comes with security audit, social links, list of smart wallets that bought with tags, net inflow, timestamps. - **URL**: https://apify.com/logiover/gmgn-smart-money-buy-signals.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Automation, Lead generation, News - **Stats:** 2 total users, 1 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 ## GMGN Smart Money Buy Signals — Live Whale, KOL & Smart-Wallet Crypto Buy Feed ![GMGN Smart Money Buy Signals — Live Whale & KOL Feed](https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/GjS6nQ8qauOdq9KGy-actor-afc9WdFQanxUvEl74-ydXkjQrREr-images.png) **Watch the smartest crypto wallets in real time.** This actor scrapes [GMGN.ai](https://gmgn.ai)'s **smart-money cards** (tokens where verified smart wallets are buying) and the **live smart-money trade stream** across all six chains GMGN supports — Solana, BSC, Ethereum, Base, Tron, Monad. > The fastest copy-trade / alpha-feed input on Apify. Per run: up to **100 tokens × 5-20 wallets each = 500-2,000 buy-signal records**, refreshed continuously. --- ### 🚀 What this actor does Smart money on-chain is real money. GMGN tags wallets that consistently make profit, follow KOLs, or carry verified Twitter / fund profiles. When those wallets are concentrated on a single token, it's a high-conviction signal. This actor pulls two complementary GMGN feeds: 1. **Smart-money cards** (`/api/v1/smartmoney_cards/cards/{chain}/24h`) — per token: the token's full security audit, market cap / liquidity / swaps / holders, AND a list of smart wallets that bought in the last 24 hours (each wallet with tags, net inflow, buy/sell counts, side, timestamps). 2. **Live trade feed** (`/api/v1/smartmoney_cards/trades/{chain}`) — every individual smart-money trade as it happens, with token info, USD amount, price, side, transaction hash, and maker (wallet) info. You pick which mode (`cards`, `trades`, or `both`) and which chains. With `explodeWallets: true` the cards mode emits one row per (token × wallet) — the most actionable format for copy-trade bots. --- ### 💡 Use cases - **Copy-trade bots** — auto-buy when ≥ 3 smart wallets accumulate a token in the last hour. - **Discord / Telegram alpha bots** — auto-post "👀 Smart money buying X" when a card has ≥ N wallets. - **Alpha-feed Substack / X newsletter** — daily roundup of smart-money picks across chains. - **AI signal training** — collect labelled smart-money trades over months to train classifiers. - **Whale watching dashboard** — power your own SaaS with the live smart-money trade stream. - **Anti-frontrun detector** — track fresh-wallet smart trades; correlate with subsequent KOL tweets. - **Compliance / forensics** — audit which "smart" wallets are buying questionable tokens. - **Memecoin sniper backtest** — backfill historical smart-money cards into ML training data. --- ### 🌐 Supported chains `sol`, `bsc`, `eth`, `base`, `tron`, `monad`. Solana and BSC carry the highest smart-money volume — default to those for live feeds. Add the others for cross-chain dashboards. --- ### 🎛️ Output modes | Mode | What you get | Rows per run | |------|------|------| | `cards` (default) | One row per token, with `wallets[]` array embedded. Rich. | ~100 per chain | | `cards` + `explodeWallets: true` | One row per (token × wallet) buy. Best for copy-trade bots. | ~500-2000 per chain | | `trades` | One row per individual trade (atomic, time-ordered). | up to 100 per chain | | `both` | Both feeds, each row tagged with `_kind`. | 600-2100 per chain | --- ### ⚙️ Input configuration | Field | Type | Default | Description | |-------|------|---------|-------------| | `chains` | `string[]` | `["sol","bsc"]` | Which chains to scan. | | `mode` | `string` | `"cards"` | `cards`, `trades`, or `both`. | | `cardsPeriod` | `string` | `"24h"` | Lookback for cards. | | `tradesLimit` | `integer` | `100` | Max trades per chain (10-100). | | `explodeWallets` | `boolean` | `false` | Emit one row per wallet in cards mode. | | `minSmartWallets` | `integer` | `0` | Drop cards with fewer wallets. | | `minMarketCapUsd` | `integer` | `0` | Drop low-cap tokens. | | `minLiquidityUsd` | `integer` | `0` | Drop low-liquidity tokens. | | `excludeHoneypots` | `boolean` | `true` | Drop honeypots. | | `onlyNewBuys` | `boolean` | `true` | Trades mode: keep only position-opening buys (drops close/reduce). | | `tagFilter` | `string[]` | `[]` | Keep only wallets with these tags. | | `useProxy` | `boolean` | `true` | Apify Proxy on/off. | | `proxyConfiguration` | `object` | residential | | | `maxConcurrency` | `integer` | `5` | | --- ### 📦 Output fields #### Card row (token-level) | Field | Description | |-------|-------------| | `_kind` | Always `"card"`. | | `chain`, `address`, `symbol`, `name`, `logo` | Token identity. | | `price`, `historyPrice`, `firstBuyPriceUsd`, `firstBuyTimestamp` | Price context. | | `marketCap`, `totalSupply`, `liquidity`, `initialLiquidity`, `quoteSymbol` | Pool info. | | `swaps`, `swaps1h`, `buys`, `sells`, `volume`, `holderCount`, `hotLevel` | Activity. | | `launchpad`, `launchpadPlatform`, `launchpadStatus`, `isOg` | Launchpad. | | `createTimestamp`, `openTimestamp` | Launch times. | | `isHoneypot`, `isRenounced`, `isOpenSource`, `isBlacklist`, `buyTax`, `sellTax`, `averageTax`, `highTax`, `canSell`, `canNotSell` | Security flags. | | `top10HolderRate`, `lockPercent`, `isLocked`, `securityFlags`, `auditDescription`, `auditEngine`, `taxAllocation` | Detailed security. | | `telegramUrl`, `twitterUrl`, `verifyStatus`, `gmgnUrl`, `dexscreenerUrl` | Links. | | `smartWalletCount`, `smartWalletTags` | Smart-money summary. | | `wallets` *(when not exploded)* | Array of wallet objects (see below). | #### Wallet object inside `wallets` (or fields when exploded) | Field | Description | |-------|-------------| | `walletAddress`, `walletEns`, `walletName`, `walletAvatar` | Wallet identity. | | `walletTwitterUsername`, `walletTwitterName` | Twitter metadata. | | `walletTags` | e.g. `smart_degen`, `renowned`, `fresh`, `kol`. | | `walletBalance`, `walletBalanceAt` | Native balance snapshot. | | `walletNetInflow`, `walletNetAmount`, `walletAmountTotal` | Position metrics for THIS token. | | `walletBuys`, `walletSells`, `walletSide` | Trade direction. | | `walletIsOpenOrClose` | `1` = opened new position, `0` = closed. | | `walletTimestamp` | When the wallet last touched this token. | #### Trade row (when `mode: trades` / `both`) | Field | Description | |-------|-------------| | `_kind` | Always `"trade"`. | | `transactionHash` | On-chain tx hash. | | `tradeSide` | `buy` or `sell`. | | `tradeIsOpenOrClose` | `1` = open new position, `0` = close. | | `tradeAmountUsd` | USD volume of the trade. | | `tradePriceUsd`, `tradePrice` | Trade price. | | `tradeBaseAmount`, `tradeQuoteAmount`, `tradeTokenAmount` | Atomic amounts. | | `tradeBalance` | Wallet's post-trade balance. | | `tradeTimestamp` | ISO trade time. | | `walletAddress`, `walletName`, `walletAvatar`, `walletTags`, `walletTwitterUsername`, `walletTwitterName` | Maker (wallet) info. | | `address`, `symbol`, `logo`, `totalSupply`, `launchpad` | Token info. | | `gmgnUrl`, `dexscreenerUrl` | Links. | --- ### 🧪 Example output (cards, exploded) ```json { "_kind": "card", "chain": "bsc", "address": "0xe966ee565bc27e984a6ca3b65509c3656e1e7777", "symbol": "KOR", "name": "KOR", "price": 0.000012158, "marketCap": 12158.68, "liquidity": 6280.47, "swaps1h": 147, "holderCount": 88, "isHoneypot": false, "isRenounced": true, "buyTax": "0.03", "sellTax": "0.03", "lockPercent": 0.95, "launchpad": "flap", "smartWalletCount": 1, "smartWalletTags": ["smart_degen"], "walletAddress": "0x03e2c6bb2e8e4abde61b2df149c2859d39e7a1ac", "walletTags": ["smart_degen"], "walletBalance": 11487563.32, "walletNetInflow": -0.11, "walletAmountTotal": 537.73, "walletBuys": 4, "walletSells": 1, "walletSide": "buy", "walletIsOpenOrClose": 1, "walletTimestamp": "2026-05-15T12:04:39.000Z", "telegramUrl": "https://t.me/+k2R9t4vSa6UxYTNh", "gmgnUrl": "https://gmgn.ai/bsc/token/0xe966ee565bc27e984a6ca3b65509c3656e1e7777", "scrapedAt": "2026-05-15T12:05:00.000Z" } ```` ### 🧪 Example output (trade) ```json { "_kind": "trade", "chain": "bsc", "transactionHash": "0x6b688173fc51169c4e7ce1f6eb8a7278995e55622f5cee0241443e986c822be9", "tradeSide": "buy", "tradeIsOpenOrClose": 1, "tradeAmountUsd": 67.83, "tradePriceUsd": 0.00000802, "tradeBaseAmount": 8454269.97, "tradeBalance": 0, "tradeTimestamp": "2026-05-15T12:04:39.000Z", "walletAddress": "0xcfef50362edfae51d751f298ea3864975a0a5b60", "walletTags": ["smart_degen"], "address": "0x8d21ce4993d4aab34446c4716575e02af2e94444", "symbol": "罗永浩🔶BNB", "launchpad": "fourmeme", "gmgnUrl": "https://gmgn.ai/bsc/token/0x8d21ce4993d4aab34446c4716575e02af2e94444", "scrapedAt": "2026-05-15T12:05:00.000Z" } ``` *** ### 🧰 Recipes #### 1. High-conviction signal: ≥3 smart wallets buying a token ```json { "chains": ["sol","bsc"], "mode": "cards", "minSmartWallets": 3, "minLiquidityUsd": 5000, "excludeHoneypots": true } ``` #### 2. Live whale-buy feed (Telegram) ```json { "chains": ["sol"], "mode": "trades", "tradesLimit": 100, "onlyNewBuys": true, "tagFilter": ["renowned", "kol"] } ``` Schedule every 30 seconds, webhook each trade to your Telegram channel. #### 3. Cross-chain copy-trade input ```json { "chains": ["sol","bsc","eth","base","tron","monad"], "mode": "cards", "explodeWallets": true, "tagFilter": ["smart_degen"] } ``` Emits ~1,000-2,000 wallet-token rows per run. Feed straight into your bot's "watch wallets" list. #### 4. Fresh-wallet (insider?) signal hunt ```json { "chains": ["sol"], "mode": "trades", "tagFilter": ["fresh_wallet"], "onlyNewBuys": true } ``` Fresh wallets making new buys — often pre-launch insider activity. #### 5. Backfill historical signals (research / ML) Schedule every hour for 30 days. Store outputs by `(chain, address, walletAddress, walletTimestamp)` to build a labelled training dataset. *** ### 🛡️ Under the hood - **Endpoints** — `GET /api/v1/smartmoney_cards/cards/{chain}/24h`, `GET /api/v1/smartmoney_cards/trades/{chain}?limit=100`. - **Auth** — none (Cloudflare-fronted, fingerprint-gated). - **Proxy** — Apify Residential default. Datacenter works but with higher rate-limit risk for this endpoint. - **Retries** — 5 attempts with exponential backoff on 403 / 429 / 5xx. - **Decompression** — Brotli auto-handled. *** ### ⚡ Performance | Configuration | Rows | Time | Cost | |--------------|------|------|------| | 1 chain, cards mode | ~100 | <30s | <$0.01 | | 2 chains, cards exploded | ~500-1000 | <1 min | ~$0.02 | | All 6 chains, both modes, exploded | ~2000-5000 | ~2-3 min | ~$0.08 | *** ### 📅 Recommended schedules - **Real-time signal feed** — every 30 seconds to 2 minutes. - **Hourly snapshot** — every hour for backfill / archive. - **Daily archive** — once per day. *** ### ❓ FAQ #### What's the difference between "cards" and "trades"? **Cards** = per-token aggregation ("which tokens are smart wallets buying?"). **Trades** = atomic events ("here are the last 100 smart-money trades"). Use cards for token-level alerts, trades for trade-by-trade telemetry. #### What does `isOpenOrClose: 1` mean? The wallet opened a NEW position with this trade (`1`) vs closed/reduced an existing one (`0`). When sniping copy-trades, only `1` is interesting. #### How fresh is the data? The 24h cards refresh every ~30 seconds. Trades refresh every block. Actor pulls whatever's current at call time. #### Why are some cards showing only 1 wallet? GMGN's algorithm surfaces tokens where AT LEAST one tagged smart wallet bought in 24h — single-wallet cards are common. Use `minSmartWallets: 3` to filter to multi-wallet conviction. #### Can I filter by wallet ENS / nickname? Not server-side, but the `walletEns` and `walletName` fields are exposed — filter client-side. #### Does the actor catch sells too? Yes — the trades feed includes both buys and sells. Set `onlyNewBuys: false` to keep position closes. #### What's `walletNetInflow` (negative)? Negative net inflow means the wallet has net-bought (more outflow of quote = SOL/BNB → more inflow of token). It's how GMGN tracks USD-equivalent position direction. #### Can I follow a specific wallet over time? Not directly through this actor — use **GMGN Wallet Portfolio & PnL Tracker** for wallet-centric scraping. #### What's `tradeBalance`? The wallet's balance of the token *after* the trade. Useful to spot full exits (`tradeBalance == 0` and `tradeSide == "sell"`). #### How do I correlate buys with Twitter / TG chatter? Combine this actor's output with **GMGN Crypto KOL Twitter & Telegram Signal Feed** — join on `address` to see which tokens have both smart-money buys AND KOL mentions. *** ### 🔗 Related actors - **GMGN Smart Money Wallet Leaderboard** — top traders ranked by PnL. - **GMGN Wallet Portfolio & PnL Tracker** — full holdings of any wallet. - **GMGN Token Holders Intelligence** — every holder of a token with PnL & tags. - **GMGN Trending Memecoin Scanner** — what's heating up across chains. - **GMGN New Token Launch Detector** — every new pair, every chain. - **GMGN Token Rugcheck & Deep Analytics** — security audit + dev history. - **GMGN Crypto KOL Twitter & Telegram Signal Feed** — KOL tweets / TG posts. *** ### 🆘 Support Found a bug? Want a new chain or tag? Open an issue on the actor's Apify page. *** ### Changelog - **2026-05-20** — Maintenance pass: reviewed the input schema and default values for a smooth one-click start, and rebuilt the Actor on the latest base image. *Last reviewed: 2026-05-20.* # Actor input Schema ## `chains` (type: `array`): Chains to monitor. Solana and BSC have the most smart-money activity. Default scans both. All six chains supported. ## `mode` (type: `string`): 'cards' = one row per token (rich: token info + array of smart wallets that bought). 'trades' = one row per individual trade (atomic feed). 'both' = both, with a `_kind` discriminator field. ## `cardsPeriod` (type: `string`): Lookback for smart-money cards. GMGN currently exposes only '24h' on the API. ## `tradesLimit` (type: `integer`): Max trades returned per chain in 'trades' / 'both' mode. GMGN caps this at 100. ## `explodeWallets` (type: `boolean`): When ON and mode=cards, each smart-money wallet that bought a token is emitted as its own row (one card with 5 wallets → 5 rows). When OFF, the wallets are kept as a nested array inside the card row. ## `minSmartWallets` (type: `integer`): Drop cards (tokens) where fewer than N smart wallets have bought. Set 2-3 to focus on multi-wallet conviction. ## `minMarketCapUsd` (type: `integer`): Drop rows whose market cap is below this threshold. Default 0 = no filter. ## `minLiquidityUsd` (type: `integer`): Drop rows whose pool liquidity is below this threshold. Default 0 = no filter. ## `excludeHoneypots` (type: `boolean`): Drop tokens flagged as honeypots (cannot-sell scams) by GMGN's security check. ## `onlyNewBuys` (type: `boolean`): When ON and mode=trades, drop trades where the wallet is closing/reducing a position (is\_open\_or\_close = 0). ## `tagFilter` (type: `array`): Keep only trades/wallets carrying these GMGN tags (e.g. smart\_degen, renowned, fresh\_wallet, kol). Empty = all. ## `useProxy` (type: `boolean`): Route requests through Apify Proxy. Strongly recommended ON — residential proxy is the most reliable way to bypass Cloudflare rate limits. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Residential proxy group is recommended for the highest success rate against Cloudflare. ## `maxConcurrency` (type: `integer`): Maximum number of API calls running in parallel. Higher = faster runs but more chance of hitting rate limits. 3-5 is safe. ## Actor input object example ```json { "chains": [ "sol", "bsc", "eth", "base", "tron", "monad" ], "mode": "both", "cardsPeriod": "24h", "tradesLimit": 100, "explodeWallets": true, "minSmartWallets": 0, "minMarketCapUsd": 0, "minLiquidityUsd": 0, "excludeHoneypots": true, "onlyNewBuys": false, "tagFilter": [], "useProxy": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 5 } ``` # Actor output Schema ## `_kind` (type: `string`): Row kind: card or trade ## `chain` (type: `string`): Blockchain slug ## `symbol` (type: `string`): Token symbol ## `name` (type: `string`): Token name ## `address` (type: `string`): Token contract address ## `price` (type: `string`): Current price ## `marketCap` (type: `string`): Market cap USD ## `liquidity` (type: `string`): Pool liquidity USD ## `swaps1h` (type: `string`): Swap count last hour ## `holderCount` (type: `string`): Unique holders ## `smartWalletCount` (type: `string`): Number of smart-money wallets that bought ## `smartWalletTags` (type: `string`): Union of tags from smart wallets ## `isHoneypot` (type: `string`): Honeypot flag ## `isRenounced` (type: `string`): Renounced flag ## `buyTax` (type: `string`): Buy tax % ## `sellTax` (type: `string`): Sell tax % ## `lockPercent` (type: `string`): LP lock percentage ## `launchpad` (type: `string`): Launchpad slug ## `walletAddress` (type: `string`): Smart-money wallet address ## `walletTags` (type: `string`): Wallet's GMGN tags ## `walletNetInflow` (type: `string`): Net inflow to this wallet ## `walletBuys` (type: `string`): Buy count by this wallet ## `walletSells` (type: `string`): Sell count by this wallet ## `walletSide` (type: `string`): buy or sell ## `walletTimestamp` (type: `string`): When the wallet last touched the token ## `transactionHash` (type: `string`): Trade tx hash (trade rows only) ## `tradeSide` (type: `string`): buy or sell (trade rows) ## `tradeAmountUsd` (type: `string`): Trade USD amount (trade rows) ## `tradeTimestamp` (type: `string`): Trade timestamp (trade rows) ## `telegramUrl` (type: `string`): Telegram URL ## `gmgnUrl` (type: `string`): GMGN token page ## `scrapedAt` (type: `string`): Scrape 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/gmgn-smart-money-buy-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("logiover/gmgn-smart-money-buy-signals").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/gmgn-smart-money-buy-signals --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/gmgn-smart-money-buy-signals", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GMGN Smart Money Buy Signals — Live Whale & KOL Feed", "description": "Live feed of tokens where smart-money, KOL, whale wallets are buying RIGHT NOW. Pulls GMGN.ai smart-money cards (last 24h) and live trade stream across all 6 chains. Each token comes with security audit, social links, list of smart wallets that bought with tags, net inflow, timestamps.", "version": "1.0", "x-build-id": "Bcj2Q8vu1riKBuVRV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~gmgn-smart-money-buy-signals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-gmgn-smart-money-buy-signals", "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~gmgn-smart-money-buy-signals/runs": { "post": { "operationId": "runs-sync-logiover-gmgn-smart-money-buy-signals", "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~gmgn-smart-money-buy-signals/run-sync": { "post": { "operationId": "run-sync-logiover-gmgn-smart-money-buy-signals", "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": { "chains": { "title": "Chains", "uniqueItems": true, "type": "array", "description": "Chains to monitor. Solana and BSC have the most smart-money activity. Default scans both. All six chains supported.", "items": { "type": "string", "enum": [ "sol", "bsc", "eth", "base", "tron", "monad" ], "enumTitles": [ "Solana", "BSC", "Ethereum", "Base", "Tron", "Monad" ] }, "default": [ "sol", "bsc", "eth", "base", "tron", "monad" ] }, "mode": { "title": "Output Mode", "enum": [ "cards", "trades", "both" ], "type": "string", "description": "'cards' = one row per token (rich: token info + array of smart wallets that bought). 'trades' = one row per individual trade (atomic feed). 'both' = both, with a `_kind` discriminator field.", "default": "both" }, "cardsPeriod": { "title": "Cards Lookback", "enum": [ "24h" ], "type": "string", "description": "Lookback for smart-money cards. GMGN currently exposes only '24h' on the API.", "default": "24h" }, "tradesLimit": { "title": "Trades Limit per Chain", "minimum": 10, "maximum": 100, "type": "integer", "description": "Max trades returned per chain in 'trades' / 'both' mode. GMGN caps this at 100.", "default": 100 }, "explodeWallets": { "title": "Explode Wallets (Cards Mode)", "type": "boolean", "description": "When ON and mode=cards, each smart-money wallet that bought a token is emitted as its own row (one card with 5 wallets → 5 rows). When OFF, the wallets are kept as a nested array inside the card row.", "default": true }, "minSmartWallets": { "title": "Minimum Smart Wallets per Card", "minimum": 0, "type": "integer", "description": "Drop cards (tokens) where fewer than N smart wallets have bought. Set 2-3 to focus on multi-wallet conviction.", "default": 0 }, "minMarketCapUsd": { "title": "Minimum Market Cap (USD)", "minimum": 0, "type": "integer", "description": "Drop rows whose market cap is below this threshold. Default 0 = no filter.", "default": 0 }, "minLiquidityUsd": { "title": "Minimum Liquidity (USD)", "minimum": 0, "type": "integer", "description": "Drop rows whose pool liquidity is below this threshold. Default 0 = no filter.", "default": 0 }, "excludeHoneypots": { "title": "Exclude Honeypots", "type": "boolean", "description": "Drop tokens flagged as honeypots (cannot-sell scams) by GMGN's security check.", "default": true }, "onlyNewBuys": { "title": "Only New Buys (Trades Mode)", "type": "boolean", "description": "When ON and mode=trades, drop trades where the wallet is closing/reducing a position (is_open_or_close = 0).", "default": false }, "tagFilter": { "title": "Wallet Tag Filter", "type": "array", "description": "Keep only trades/wallets carrying these GMGN tags (e.g. smart_degen, renowned, fresh_wallet, kol). Empty = all.", "default": [], "items": { "type": "string" } }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy. Strongly recommended ON — residential proxy is the most reliable way to bypass Cloudflare rate limits.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy configuration. Residential proxy group is recommended for the highest success rate against Cloudflare.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Max Concurrent Requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of API calls running in parallel. Higher = faster runs but more chance of hitting rate limits. 3-5 is safe.", "default": 5 } } }, "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 } } } } } } } } } } ```