# GMGN New Token Launch Detector — Pump.fun & Four.meme (`logiover/gmgn-new-token-launch-detector`) Actor

Detect every newly-launched memecoin pair on Solana, BSC, Ethereum, Base, Tron, Monad in real-time. Covers pump.fun, four.meme, bonk.fun, flap, Raydium, PancakeSwap and more. 60+ fields per pair: token info, launchpad, dev wallet, liquidity, security flags, social links, sniper exposure.

- **URL**: https://apify.com/logiover/gmgn-new-token-launch-detector.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Automation, News, Developer tools
- **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 New Token Launch Detector — Pump.fun, Four.meme, Raydium, Pancake & 20+ Launchpads

![GMGN New Token Launch Detector — Pump.fun & Four.meme](https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/GjS6nQ8qauOdq9KGy-actor-qQ2v9JaZGAftUUuLy-KoWe1Z4QHr-images.png)

**Detect every freshly-launched memecoin pair on Solana, BSC, Ethereum, Base, Tron, and Monad — the moment it lists.** Pulls [GMGN.ai](https://gmgn.ai)'s `new_pairs` feed across every chain and launchpad they index, normalizes 60+ fields per pair, and pushes structured data into your Apify dataset.

> The fastest open data feed for **new memecoin launches** across **pump.fun, four.meme, bonk.fun, flap, sun.io, Raydium, PancakeSwap**, and every other launchpad GMGN tracks.

---

### 🚀 What this actor does

Every minute, hundreds of new token pairs are deployed across Solana, BSC, Base, and the rest. Most die within an hour. The few that don't are the next 100x. This actor gives you the **complete list** — every new pair, every launchpad, every chain — with the data you need to triage them: liquidity, creator wallet, sniper exposure, top-10 holder concentration, lock status, taxes, socials.

It calls GMGN's `pairs/{chain}/new_pairs/{period}` endpoint for each (chain × period) combination you select. Default — Solana + BSC, last 1 hour — returns up to **200 fresh pairs per run**. Full sweep across all six chains and three periods yields **1,200-1,800 pairs** in a single run.

Pair this actor with the [GMGN Trending Memecoin Scanner](#related-actors) for a complete view: this one shows what just launched; the trending scanner shows what's heating up.

---

### 💡 Use cases

- **Sniper bot input** — schedule every 30 seconds, filter by `minLiquidityUsd: 1000` and `launchpads: ["pump"]`, pipe to your bot.
- **Launchpad performance analytics** — compare how many tokens four.meme launches per day vs pump.fun, with what initial liquidity and survival rates.
- **Anti-rug research** — flag tokens with `top10HolderRate > 0.5` or `creatorBalanceRate > 0.1` for risk dashboards.
- **Memecoin alpha-call Telegram channels** — auto-post new pairs that pass quality filters.
- **AI training datasets** — collect labelled launch data over months for ML models predicting 100x runners.
- **Token launch monitoring services** — power your own SaaS dashboard with GMGN's new-pair data.
- **Liquidity provider scouts** — surface fresh pools with healthy initial liquidity for LP staking.
- **VC / fund deal-flow** — capture every new token on-chain for sourcing.

---

### 🌐 Supported chains and launchpads

GMGN indexes new pairs from every major launchpad on each supported chain:

| Chain | Major launchpads tracked |
|-------|------------------------|
| Solana (`sol`) | pump.fun, pumpamm/pumpswap, Raydium, Meteora, bonk.fun, jup.studio, Believe, daos.fun |
| BSC (`bsc`) | four.meme (fourmeme), flap, PancakeSwap, Binance Alpha |
| Ethereum (`eth`) | Uniswap V2/V3, virtual.io, clanker |
| Base (`base`) | clanker, virtual.io, Uniswap, Aerodrome |
| Tron (`tron`) | SunPump, sun.io |
| Monad (`monad`) | NadFun, monoswap |

Use the `launchpads` input parameter to filter to specific launchpads (e.g. `["pump", "fourmeme"]`).

---

### ⏱ Lookback periods

| Period | Best for |
|--------|---------|
| `1h` | Real-time sniper feeds — pairs launched in the last hour. |
| `6h` | Half-day rollup — research and catching up after sleep. |
| `24h` | Daily research export — every launch in the past day. |

---

### ⚙️ Input configuration

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `chains` | `string[]` | `["sol","bsc"]` | `sol`, `bsc`, `eth`, `base`, `tron`, `monad` |
| `periods` | `string[]` | `["1h"]` | `1h`, `6h`, `24h` |
| `launchpads` | `string[]` | `[]` | Filter by launchpad slug (e.g. `pump`, `fourmeme`, `raydium`, `pancakeswap`, `bonk`). |
| `filters` | `string[]` | `[]` | Server-side security filters: `not_honeypot`, `verified`, `renounced`, `frozen`, `burnt`, `no_mint_authority`. |
| `orderBy` | `string` | `"open_timestamp"` | `open_timestamp`, `liquidity`, `market_cap`, `swaps`, `volume`, `holder_count`. |
| `direction` | `string` | `"desc"` | `desc` (newest/highest first) or `asc`. |
| `maxResultsPerCall` | `integer` | `100` | Max 100 (GMGN limit). |
| `minLiquidityUsd` | `integer` | `0` | Drop pairs below this liquidity. |
| `minHolderCount` | `integer` | `0` | Drop pairs with fewer holders. |
| `minMarketCapUsd` | `integer` | `0` | Drop pairs with smaller market cap. |
| `onlyWithSocials` | `boolean` | `false` | Drop pairs without any Twitter / TG / website. |
| `excludeHoneypots` | `boolean` | `true` | Post-filter honeypots. |
| `deduplicate` | `boolean` | `true` | Merge same pair across periods. |
| `useProxy` | `boolean` | `true` | Apify Proxy on/off. |
| `proxyConfiguration` | `object` | `residential` | Apify proxy config. |
| `maxConcurrency` | `integer` | `5` | Parallel API calls. |

---

### 📦 Output fields (60+ per pair)

#### Identity
| Field | Description |
|-------|-------------|
| `symbol` | Token symbol. |
| `name` | Token name. |
| `chain` | `sol`, `bsc`, `eth`, `base`, `tron`, `monad`. |
| `address` | Token contract address. |
| `logo` | Logo URL. |

#### Pair info
| Field | Description |
|-------|-------------|
| `pairAddress` | DEX pair / pool address. |
| `baseAddress` | Base token (the launched token). |
| `quoteAddress` | Quote token (WBNB, SOL, WETH, etc.). |
| `quoteSymbol` | e.g. `BNB`, `SOL`. |
| `quoteReserve` | Quote token in the pool. |
| `launchQuoteAddress` | Quote token at launch time. |
| `exchange` | AMM contract address. |
| `totalFee` | Pool fee rate. |

#### Launchpad
| Field | Description |
|-------|-------------|
| `launchpad` | `pump`, `fourmeme`, `flap`, `raydium`, etc. |
| `launchpadPlatform` | Platform identifier (same field, sometimes more granular). |
| `launchpadStatus` | `bonding_curve` (still on launchpad) or `migrated` (graduated to AMM). |

#### Pricing
| Field | Description |
|-------|-------------|
| `price` | Current USD price. |
| `price1m` / `5m` / `1h` / `6h` / `24h` | Historic prices by window. |
| `priceChangePercent1m` / `5m` / `1h` | % change. |

#### Volume
| Field | Description |
|-------|-------------|
| `volume` | Total swap volume. |
| `buyVolume1m` / `5m` / `1h` / `6h` / `24h` | Buy volume by window. |

#### Market cap & liquidity
| Field | Description |
|-------|-------------|
| `marketCap` | FDV. |
| `historyHighestMarketCap` | ATH market cap since launch. |
| `liquidity` | Pool liquidity USD. |

#### Activity
| Field | Description |
|-------|-------------|
| `swaps` | Total swaps. |
| `buys` | Total buys. |
| `visitingCount` | GMGN page-view count. |

#### Holders & dev exposure
| Field | Description |
|-------|-------------|
| `holderCount` | Unique holders. |
| `top10HolderRate` | Share of supply in top-10 wallets. |
| `top70SniperHoldRate` | Share held by top-70 snipers. |
| `devTeamHoldRate` | Dev team share. |
| `botDegenCount` | Number of bot-degen wallets that bought. |
| `botDegenRate` | Share of trades from bots. |
| `creator` | Creator wallet. |
| `creatorBalanceRate` | Creator's current share of supply. |
| `creatorTokenStatus` | `creator_hold` or `creator_close`. |
| `devTokenBurnAmount` / `devTokenBurnRatio` | Dev's burn amount / ratio. |

#### Security
| Field | Description |
|-------|-------------|
| `isHoneypot` | Boolean. |
| `isRenounced` | Boolean. |
| `isOpenSource` | Boolean. |
| `buyTax` / `sellTax` | Tax % strings. |
| `burnRatio` / `burnStatus` | Token burn metrics. |
| `lockPercent` / `leftLockPercent` / `isLocked` | LP lock status. |

#### Social
| Field | Description |
|-------|-------------|
| `twitterUsername` / `twitterUrl` | Twitter handle / URL. |
| `telegram` / `telegramUrl` | Telegram link. |
| `website` / `websiteUrl` | Website. |
| `twitterChangeFlag` | Suspicious-Twitter flag. |
| `ctoFlag` | Community-takeover flag. |
| `dexscrAd` / `dexscrUpdateLink` | DexScreener paid-ad / link-update flags. |

#### Timestamps & convenience
| Field | Description |
|-------|-------------|
| `openTimestamp` | ISO time of pool open. |
| `openTimestampUnix` | Unix seconds. |
| `creationTimestamp` | ISO contract-creation time. |
| `ageMinutes` | Minutes since pool open at scrape time. |
| `gmgnUrl` | GMGN token page. |
| `dexscreenerUrl` | DexScreener token page. |
| `period` | Lookback period this row was sourced from. |
| `periods` | (when deduplicate=true) all periods the pair appeared in. |
| `scrapedAt` | ISO scrape time. |

---

### 🧪 Example output

```json
{
  "symbol": "BIAMOND",
  "name": "Biamond",
  "chain": "bsc",
  "address": "0x27e8c56e5e34c92eb9488a00d96730866e304444",
  "pairAddress": "0x27e8c56e5e34c92eb9488a00d96730866e304444",
  "quoteSymbol": "BNB",
  "quoteReserve": 0.3,
  "launchpad": "fourmeme",
  "launchpadStatus": "bonding_curve",
  "price": 0.0000041,
  "marketCap": 4120.25,
  "liquidity": 407.89,
  "holderCount": 2,
  "creator": "0x5bf716933fb7770e92c96bee624df1bea39b0bfc",
  "creatorBalanceRate": 0.049,
  "creatorTokenStatus": "creator_hold",
  "isHoneypot": false,
  "isRenounced": true,
  "buyTax": "0",
  "sellTax": "0",
  "burnRatio": 1.0,
  "burnStatus": "burn",
  "twitterUrl": "https://x.com/i/communities/1914771747288613339",
  "openTimestamp": "2026-05-15T12:06:00.000Z",
  "ageMinutes": 4,
  "gmgnUrl": "https://gmgn.ai/bsc/token/0x27e8c56e5e34c92eb9488a00d96730866e304444",
  "period": "1h",
  "periods": ["1h"],
  "scrapedAt": "2026-05-15T12:10:00.000Z"
}
````

***

### 🧰 Recipes

#### 1. Live pump.fun-only sniper feed

```json
{ "chains": ["sol"], "periods": ["1h"], "launchpads": ["pump"], "minLiquidityUsd": 500, "excludeHoneypots": true }
```

Schedule every 30 seconds. Pipe to webhook.

#### 2. Multi-chain daily launch export

```json
{ "chains": ["sol","bsc","base","eth"], "periods": ["24h"], "onlyWithSocials": true, "minHolderCount": 20 }
```

Once-a-day CSV for research / backtesting.

#### 3. Anti-rug research dataset

```json
{ "chains": ["sol","bsc"], "periods": ["24h"], "excludeHoneypots": false }
```

Includes honeypots — use this for ML model training to predict rug pulls.

#### 4. Migration tracker (only graduated tokens)

Filter the output for `launchpadStatus == "migrated"` — these are tokens that survived the bonding curve and now trade on Raydium / Pancake.

#### 5. Just BSC four.meme launches with active dev

```json
{ "chains": ["bsc"], "periods": ["1h", "6h"], "launchpads": ["fourmeme"], "onlyWithSocials": true }
```

***

### 🛡️ Under the hood

- **Endpoint** — `GET https://gmgn.ai/defi/quotation/v1/pairs/{chain}/new_pairs/{period}` with `filters[]`, `orderby`, `direction`, `limit`, `period` query params.
- **Auth** — none. Same Cloudflare-fronted, fingerprint-gated approach as the trending scanner.
- **Proxy** — Apify Residential default.
- **Retries** — 5 attempts with exponential backoff for 403 / 429 / 5xx.
- **Concurrency** — bounded pool (default 5).
- **Deduplication** — same `(chain, address)` across periods merged into one row with `periods` array.

***

### ⚡ Performance

| Configuration | Pairs | Time | Cost |
|--------------|-------|------|------|
| 2 chains × 1h (default) | ~200 | <30s | <$0.01 |
| 2 chains × all 3 periods | ~600 | ~1 min | ~$0.02 |
| All 6 chains × all periods | ~1,200-1,800 | ~2-3 min | ~$0.05 |

***

### 📅 Recommended schedules

- **Sniper bot feed** — every 30 seconds to 1 minute.
- **Hourly research snapshot** — every 1 hour.
- **Daily launch archive** — once per day with `periods: ["24h"]`.

***

### ❓ FAQ

#### What's a "new pair" vs a "trending token"?

A new pair is a freshly-deployed liquidity pool (it could have zero volume). A trending token is one with high recent volume / holder growth. The trending scanner shows what's hot; this actor shows what just opened.

#### How fresh is the data?

The 1h list updates continuously on GMGN. The actor returns whatever's currently on the list when called — usually pairs are visible within 10-30 seconds of launch.

#### Why are some `quoteReserve` values tiny?

The pair is still on the bonding curve (launchpadStatus = `bonding_curve`) and trades happen against a virtual reserve. After graduation to an AMM, liquidity becomes real and `liquidity` jumps.

#### Can I filter by launchpad?

Yes — pass `launchpads: ["pump", "raydium"]` to keep only those. Case-insensitive.

#### Why no Solana pumpswap or Raydium pairs in my results?

By default GMGN's `new_pairs` list emphasizes bonding-curve launches. Pairs that migrate to Raydium appear as `migrated` on their existing entry rather than as new pairs.

#### How do I track a token's full lifecycle?

1. This actor catches the launch.
2. Schedule the [Trending Memecoin Scanner](#related-actors) hourly to track when it goes hot.
3. Use [Token Holders Intelligence](#related-actors) to study buyer composition.
4. Use [Token Rugcheck](#related-actors) for the security profile.

#### What's `creatorTokenStatus`?

- `creator_hold` — creator still holds tokens (often suspicious / risky).
- `creator_close` — creator has dumped or transferred out.

#### What's `top10HolderRate`?

Share of total supply held by the top 10 wallets. Above 30% is concentrated; above 50% is dangerous.

#### How do I know if liquidity is locked or burned?

- `isLocked == true` + `lockPercent` near 1.0 → LP is locked.
- `burnStatus == "burn"` + `burnRatio` near 1.0 → LP is burned (uncollectable).

#### Does this actor track Binance Alpha tokens?

Yes — Binance Alpha tokens on BSC appear in the standard `new_pairs/bsc` feed with their launchpad set accordingly.

#### How many pairs do I get per run?

Default 200; max ~1,800 with all chains × all periods × max limit.

#### Can I run this every 30 seconds?

Yes. Apify schedules support sub-minute via cron-like syntax. Costs scale linearly — see the performance table.

#### Does it respect GMGN rate limits?

Yes — bounded concurrency + exponential backoff on 429/403. Residential proxy rotation distributes load.

***

### 🔗 Related actors

Build a full GMGN-powered intelligence stack:

- **GMGN Trending Memecoin Scanner** — what's heating up across all chains and timeframes.
- **GMGN Smart Money Wallet Leaderboard** — top traders by PnL.
- **GMGN Smart Money Buy Signals** — what smart money is buying right now.
- **GMGN Token Holders Intelligence** — full holder list for any token.
- **GMGN Token Rugcheck & Deep Analytics** — security audit + dev history per token.
- **GMGN Wallet Portfolio & PnL Tracker** — full holdings + PnL for any wallet.
- **GMGN Crypto KOL Twitter & Telegram Signal Feed** — KOL tweets / TG posts with token tags.

***

### 🆘 Support

Found a bug? Want a new launchpad supported? 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`):

Which blockchains to scan for new pairs. Solana (pump.fun) and BSC (four.meme) are by far the highest-volume launch chains. Default scans both. All six chains: sol, bsc, eth, base, tron, monad.

## `periods` (type: `array`):

How far back to fetch new pairs. '1h' = pairs launched in the last 1 hour, '6h' = last 6 hours, '24h' = last 24 hours. Use '1h' for live sniper feeds; '24h' for daily research exports.

## `launchpads` (type: `array`):

Only keep pairs from these launchpads. Common values: 'pump' (Solana pump.fun), 'pumpamm' / 'pumpswap' (pump.fun AMM), 'raydium' (Raydium), 'meteora', 'bonk' (bonk.fun), 'fourmeme' (BSC four.meme), 'flap' (BSC flap), 'pancakeswap', 'uniswap', 'sunpump' (Tron). Leave empty for all launchpads.

## `filters` (type: `array`):

Server-side security filters (same as GMGN UI). 'not\_honeypot' excludes honeypots, 'renounced' keeps renounced contracts, 'frozen' keeps locked LP, 'burnt' keeps burnt LP. Leave empty for the full unfiltered list.

## `orderBy` (type: `string`):

Server-side sort. Default 'open\_timestamp' gives newest-first (best for live feeds). 'liquidity', 'market\_cap', 'swaps', 'volume' surface higher-quality launches first.

## `direction` (type: `string`):

Sort direction. desc = highest first (default, matches the source UI). asc = lowest first — useful for hunting unfamiliar entries.

## `maxResultsPerCall` (type: `integer`):

Number of new pairs returned per (chain, period) request. Max 100 (GMGN limit).

## `minLiquidityUsd` (type: `integer`):

Drop pairs with liquidity below this threshold. Default 0 = no filter. 500-1000 is a common floor to filter zero-liquidity rugs.

## `minHolderCount` (type: `integer`):

Drop rows with fewer than this many holders. Default 0 = no filter.

## `minMarketCapUsd` (type: `integer`):

Drop rows whose market cap is below this threshold. Default 0 = no filter.

## `onlyWithSocials` (type: `boolean`):

When ON, drops pairs without any Twitter, Telegram, or Website set. Heavy noise-reducer — keeps only tokens with at least some basic branding effort.

## `excludeHoneypots` (type: `boolean`):

Drop tokens flagged as honeypots, in addition to any server-side filter.

## `deduplicate` (type: `boolean`):

When ON, the same pair appearing in multiple lookback periods is emitted once (with the freshest data and a list of periods it appeared in).

## `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. 5-10 is safe.

## Actor input object example

```json
{
  "chains": [
    "sol",
    "bsc",
    "eth",
    "base",
    "tron",
    "monad"
  ],
  "periods": [
    "1h",
    "6h",
    "24h"
  ],
  "launchpads": [],
  "filters": [],
  "orderBy": "open_timestamp",
  "direction": "desc",
  "maxResultsPerCall": 100,
  "minLiquidityUsd": 0,
  "minHolderCount": 0,
  "minMarketCapUsd": 0,
  "onlyWithSocials": false,
  "excludeHoneypots": true,
  "deduplicate": false,
  "useProxy": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "maxConcurrency": 8
}
```

# Actor output Schema

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

Token symbol

## `name` (type: `string`):

Token name

## `chain` (type: `string`):

Blockchain slug

## `address` (type: `string`):

Token contract address

## `launchpad` (type: `string`):

Launchpad slug

## `launchpadStatus` (type: `string`):

bonding\_curve or migrated

## `price` (type: `string`):

Current USD price

## `marketCap` (type: `string`):

Fully-diluted market cap

## `liquidity` (type: `string`):

Pool liquidity USD

## `quoteSymbol` (type: `string`):

Quote token symbol

## `quoteReserve` (type: `string`):

Quote token amount in the pool

## `holderCount` (type: `string`):

Unique holders

## `creator` (type: `string`):

Deployer wallet

## `creatorBalanceRate` (type: `string`):

Share of supply still held by creator

## `creatorTokenStatus` (type: `string`):

creator\_hold or creator\_close

## `buys` (type: `string`):

Buy count since launch

## `swaps` (type: `string`):

Total swap count since launch

## `botDegenCount` (type: `string`):

Bot wallets that bought

## `top70SniperHoldRate` (type: `string`):

Share held by top-70 snipers

## `isHoneypot` (type: `string`):

Honeypot flag

## `isRenounced` (type: `string`):

Renounced flag

## `buyTax` (type: `string`):

Buy tax %

## `sellTax` (type: `string`):

Sell tax %

## `burnRatio` (type: `string`):

LP burn ratio

## `lockPercent` (type: `string`):

LP lock percentage

## `twitterUrl` (type: `string`):

Twitter URL

## `telegramUrl` (type: `string`):

Telegram URL

## `websiteUrl` (type: `string`):

Website URL

## `openTimestamp` (type: `string`):

ISO pool open time

## `ageMinutes` (type: `string`):

Minutes since launch at scrape time

## `gmgnUrl` (type: `string`):

GMGN token page

## `period` (type: `string`):

Lookback period used (1h/6h/24h)

## `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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/gmgn-new-token-launch-detector").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("logiover/gmgn-new-token-launch-detector").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-new-token-launch-detector --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=logiover/gmgn-new-token-launch-detector",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "GMGN New Token Launch Detector — Pump.fun & Four.meme",
        "description": "Detect every newly-launched memecoin pair on Solana, BSC, Ethereum, Base, Tron, Monad in real-time. Covers pump.fun, four.meme, bonk.fun, flap, Raydium, PancakeSwap and more. 60+ fields per pair: token info, launchpad, dev wallet, liquidity, security flags, social links, sniper exposure.",
        "version": "1.0",
        "x-build-id": "UkRpXVE2ofOZVjnNs"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/logiover~gmgn-new-token-launch-detector/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-logiover-gmgn-new-token-launch-detector",
                "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-new-token-launch-detector/runs": {
            "post": {
                "operationId": "runs-sync-logiover-gmgn-new-token-launch-detector",
                "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-new-token-launch-detector/run-sync": {
            "post": {
                "operationId": "run-sync-logiover-gmgn-new-token-launch-detector",
                "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": "Which blockchains to scan for new pairs. Solana (pump.fun) and BSC (four.meme) are by far the highest-volume launch chains. Default scans both. All six chains: sol, bsc, eth, base, tron, monad.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "sol",
                                "bsc",
                                "eth",
                                "base",
                                "tron",
                                "monad"
                            ],
                            "enumTitles": [
                                "Solana",
                                "BSC (BNB Chain)",
                                "Ethereum",
                                "Base",
                                "Tron",
                                "Monad"
                            ]
                        },
                        "default": [
                            "sol",
                            "bsc",
                            "eth",
                            "base",
                            "tron",
                            "monad"
                        ]
                    },
                    "periods": {
                        "title": "Lookback Periods",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "How far back to fetch new pairs. '1h' = pairs launched in the last 1 hour, '6h' = last 6 hours, '24h' = last 24 hours. Use '1h' for live sniper feeds; '24h' for daily research exports.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "1h",
                                "6h",
                                "24h"
                            ],
                            "enumTitles": [
                                "Last 1 hour",
                                "Last 6 hours",
                                "Last 24 hours"
                            ]
                        },
                        "default": [
                            "1h",
                            "6h",
                            "24h"
                        ]
                    },
                    "launchpads": {
                        "title": "Launchpad Filter",
                        "type": "array",
                        "description": "Only keep pairs from these launchpads. Common values: 'pump' (Solana pump.fun), 'pumpamm' / 'pumpswap' (pump.fun AMM), 'raydium' (Raydium), 'meteora', 'bonk' (bonk.fun), 'fourmeme' (BSC four.meme), 'flap' (BSC flap), 'pancakeswap', 'uniswap', 'sunpump' (Tron). Leave empty for all launchpads.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "filters": {
                        "title": "Security Filters",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Server-side security filters (same as GMGN UI). 'not_honeypot' excludes honeypots, 'renounced' keeps renounced contracts, 'frozen' keeps locked LP, 'burnt' keeps burnt LP. Leave empty for the full unfiltered list.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "not_honeypot",
                                "verified",
                                "renounced",
                                "frozen",
                                "no_mint_authority",
                                "burnt"
                            ],
                            "enumTitles": [
                                "Not Honeypot",
                                "Verified",
                                "Renounced Ownership",
                                "Frozen Liquidity",
                                "No Mint Authority",
                                "LP Burnt"
                            ]
                        },
                        "default": []
                    },
                    "orderBy": {
                        "title": "Order By",
                        "enum": [
                            "open_timestamp",
                            "liquidity",
                            "market_cap",
                            "swaps",
                            "volume",
                            "holder_count"
                        ],
                        "type": "string",
                        "description": "Server-side sort. Default 'open_timestamp' gives newest-first (best for live feeds). 'liquidity', 'market_cap', 'swaps', 'volume' surface higher-quality launches first.",
                        "default": "open_timestamp"
                    },
                    "direction": {
                        "title": "Sort Direction",
                        "enum": [
                            "desc",
                            "asc"
                        ],
                        "type": "string",
                        "description": "Sort direction. desc = highest first (default, matches the source UI). asc = lowest first — useful for hunting unfamiliar entries.",
                        "default": "desc"
                    },
                    "maxResultsPerCall": {
                        "title": "Max Results per API Call",
                        "minimum": 10,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Number of new pairs returned per (chain, period) request. Max 100 (GMGN limit).",
                        "default": 100
                    },
                    "minLiquidityUsd": {
                        "title": "Minimum Liquidity (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop pairs with liquidity below this threshold. Default 0 = no filter. 500-1000 is a common floor to filter zero-liquidity rugs.",
                        "default": 0
                    },
                    "minHolderCount": {
                        "title": "Minimum Holder Count",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Drop rows with fewer than this many holders. Default 0 = no filter.",
                        "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
                    },
                    "onlyWithSocials": {
                        "title": "Only Pairs With Social Links",
                        "type": "boolean",
                        "description": "When ON, drops pairs without any Twitter, Telegram, or Website set. Heavy noise-reducer — keeps only tokens with at least some basic branding effort.",
                        "default": false
                    },
                    "excludeHoneypots": {
                        "title": "Exclude Honeypots (Post-Filter)",
                        "type": "boolean",
                        "description": "Drop tokens flagged as honeypots, in addition to any server-side filter.",
                        "default": true
                    },
                    "deduplicate": {
                        "title": "Deduplicate Across Periods",
                        "type": "boolean",
                        "description": "When ON, the same pair appearing in multiple lookback periods is emitted once (with the freshest data and a list of periods it appeared in).",
                        "default": false
                    },
                    "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. 5-10 is safe.",
                        "default": 8
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
