# Pump.fun Scraper (`api_massta/pump-scraper`) Actor

Get PRICE information with your Pump.fun tokens. This tool extracts in-depth data about cryptocurrency tokens from Pump.fun, a platform dedicated to Solana-based assets. It provides valuable insights into tokens, including their market caps, trading patterns, social media links, and more.

- **URL**: https://apify.com/api\_massta/pump-scraper.md
- **Developed by:** [Sh0ck Labs](https://apify.com/api_massta) (community)
- **Categories:** Other, Automation, Developer tools
- **Stats:** 157 total users, 0 monthly users, 90.6% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 token-results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Pump.fun Token Scraper & API

![Pump Fun Logo](https://pump.fun/_next/image?url=%2Flogo.png\&w=32\&q=75)

Extract in-depth data about Solana meme coins from pump.fun — token details, market cap, bonding curve status, graduation, social links, creator info, and community takeover (CTO) metadata.

Runs as a **one-off scraper** or as a **real-time Standby/MCP API** that AI agents can call as a live data tool via [Apify's MCP server](https://mcp.apify.com).

### Key Features

- Scrapes up to 1,000 tokens in a single operation
- Extensive filtering to save you money on responses:
  - **Sort By**: Last Trade, Creation Time, Last Reply, or Market Cap
  - **Sort Order**: Ascending or Descending
  - **NSFW Content**: Option to include or exclude
  - **Market Cap**: Filter by minimum/maximum market cap (SOL or USD)
  - **Graduation Status**: Filter for tokens that have completed their bonding curve and migrated to PumpSwap
  - **King of the Hill**: Filter for tokens that have reached KOTH status
  - **Date Filters**: Minimum creation date or last trade date (relative, e.g. "1 hour")
- All token details returned by the pump.fun API:
  - **Basic Data**: Token name, symbol, mint address, creator
  - **Market Data**: Market cap (SOL + USD), ATH market cap, reserves, total supply
  - **Pool Data**: Bonding curve address, PumpSwap pool address, protocol, program
  - **Social Media**: Twitter, Telegram, and website links
  - **Creator Info**: Username, profile image, CTO metadata
  - **Status**: Graduation status, banned, NSFW, currently livestreaming

### Real-time API (Standby / MCP)

When running in Standby mode, the Actor stays warm and accepts HTTP requests with the same parameters as the input schema. AI agents can call it via the [Apify MCP server](https://mcp.apify.com) for live, low-latency token data.

**Example request:**

```
GET /?filter=FAFO&limit=50&order_by=market_cap&order_by_direction=DESC
```

**Or with a JSON body:**

```json
POST /
{
  "filter": "FAFO",
  "limit": 50,
  "min_mkt_cap": 1000,
  "is_mkt_cap_usd": true
}
```

### Input Configuration

- **filter (String)**: Search by token symbol or mint address.
- **order\_by (String)**: Sort by `created_timestamp`, `last_trade_timestamp`, `last_reply`, or `market_cap` (default: `created_timestamp`).
- **order\_by\_direction (String)**: `ASC` or `DESC` (default: `DESC`).
- **limit (Integer)**: Max tokens to return, 50-1000 (default: 1000).
- **offset (Integer)**: Number of tokens to skip (default: 0).
- **is\_nsfw (Boolean)**: Include NSFW tokens (default: `true`).
- **is\_graduated (Boolean)**: Only graduated tokens (default: `false`).
- **has\_king\_of\_the\_hill (Boolean)**: Only tokens that have reached KOTH (default: `false`).
- **min\_mkt\_cap / max\_mkt\_cap (Integer)**: Market cap range filter.
- **is\_mkt\_cap\_usd (Boolean)**: Use USD market cap for filtering instead of SOL (default: `false`).
- **min\_created\_timestamp (String)**: Minimum creation date, relative format e.g. `1 hour`.
- **min\_last\_trade\_timestamp (String)**: Minimum last trade date, relative format e.g. `10 minutes`.

#### Example Input

```json
{
  "filter": "",
  "is_graduated": false,
  "is_nsfw": true,
  "has_king_of_the_hill": false,
  "is_mkt_cap_usd": false,
  "min_created_timestamp": "1 hour",
  "min_last_trade_timestamp": "10 minutes",
  "limit": 1000,
  "offset": 0,
  "order_by": "created_timestamp",
  "order_by_direction": "DESC"
}
```

#### Sample Output

```json
{
  "mint": "6N2yWK4FpeH73G19WToroTocyGPNSKcFuBdQD51skkFQ",
  "name": "Example Token",
  "symbol": "EXAMPLE",
  "description": "An example meme coin",
  "creator": "34sNEPBxrThLYbU3GozAqeLMwYPfnrnu2736rbfnNs5p",
  "market_cap": 22.21,
  "usd_market_cap": 4539.06,
  "market_cap_quote": 22.21,
  "ath_market_cap": 150.5,
  "ath_market_cap_timestamp": "2026-06-20T12:00:00+00:00",
  "created_timestamp": "2026-06-20T07:41:48.258000+00:00",
  "image_uri": "https://ipfs.io/ipfs/QmExample",
  "metadata_uri": "https://ipfs.io/ipfs/QmExample",
  "twitter": "https://x.com/example",
  "telegram": null,
  "bonding_curve": "5hu5MRiYLYMnYXQXUm5vsTd32s4A9mHyuPWznKryD8vD",
  "associated_bonding_curve": "2S3QBZwusTP2Li7r2vuHxBfEuPhJRsAgPvkahtP48RAm",
  "pump_swap_pool": "7Vux5xC9XZJ89gxRD2bUESjjtY4iRzihnEruVVG1Liag",
  "pool_address": "7Vux5xC9XZJ89gxRD2bUESjjtY4iRzihnEruVVG1Liag",
  "protocol": "pumpswap",
  "program": "pumpfun",
  "complete": true,
  "virtual_sol_reserves": 115005359342,
  "virtual_token_reserves": 279900000000000,
  "real_sol_reserves": 85000000000,
  "real_token_reserves": 200000000000000,
  "total_supply": 1000000000000000,
  "website": null,
  "show_name": true,
  "last_trade_timestamp": "2026-06-20T07:50:05+00:00",
  "reply_count": 11,
  "nsfw": false,
  "is_banned": false,
  "is_currently_live": false,
  "username": null,
  "profile_image": null,
  "cto_username": null,
  "cto_address": null,
  "updated_at": "2026-06-20T08:00:00+00:00",
  "scraped_date": "2026-06-20T08:03:56.839560+00:00"
}
```

### Key Use Cases

- **Market Intelligence**: Analyze token performance, investor sentiment, and broader market trends.
- **Emerging Token Discovery**: Spot new tokens early by tracking creation timestamps and initial trading activity.
- **Data-Driven Trading**: Leverage historical market data to refine and backtest trading strategies.
- **Valuation Monitoring**: Track market capitalization shifts to uncover promising projects.
- **Social Sentiment Analysis**: Assess community engagement by analyzing reply counts and social links.
- **Project Verification**: Conduct due diligence with in-depth token metadata and real-time project updates.
- **AI Agent Integration**: Connect via MCP for automated, real-time token data retrieval in AI workflows.

# Actor input Schema

## `filter` (type: `string`):

Search filter term (can be 'mint' or 'symbol')

## `min_created_timestamp` (type: `string`):

Minimum Created date relative format: {number} {unit} (e.g. hours ago)

## `min_last_trade_timestamp` (type: `string`):

Minimum Last traded date relative format: {number} {unit} (e.g. hours ago)

## `is_graduated` (type: `boolean`):

Only return completed/graduated coins (graduated coins have migrated to a PumpSwap pool).

## `is_nsfw` (type: `boolean`):

Show items that are NSFW

## `has_king_of_the_hill` (type: `boolean`):

Filters items that have been King of the Hill before

## `is_mkt_cap_usd` (type: `boolean`):

Filter market cap using USD value

## `min_mkt_cap` (type: `integer`):

The minimum market cap to scrape

## `max_mkt_cap` (type: `integer`):

The maximum market cap to scrape

## `offset` (type: `integer`):

The number of coins to to skip from the start

## `limit` (type: `integer`):

The max number of coins to scrape

## `order_by` (type: `string`):

The field to sort by

## `order_by_direction` (type: `string`):

The field to sort by

## Actor input object example

```json
{
  "filter": "(e.g. 'FAFO' or '6N2yWK4FpeH73G19WToroTocyGPNSKcFuBdQD51skkFQ')",
  "is_graduated": false,
  "is_nsfw": true,
  "has_king_of_the_hill": false,
  "is_mkt_cap_usd": false,
  "offset": 0,
  "limit": 1000,
  "order_by": "created_timestamp",
  "order_by_direction": "DESC"
}
```

# Actor output Schema

## `tokens` (type: `string`):

One object per token with fields like mint, name, symbol, market\_cap, usd\_market\_cap, bonding\_curve, pool\_address, complete (graduated), and social links.

# 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 = {
    "offset": 0,
    "limit": 1000,
    "order_by": "created_timestamp",
    "order_by_direction": "DESC"
};

// Run the Actor and wait for it to finish
const run = await client.actor("api_massta/pump-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "offset": 0,
    "limit": 1000,
    "order_by": "created_timestamp",
    "order_by_direction": "DESC",
}

# Run the Actor and wait for it to finish
run = client.actor("api_massta/pump-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 '{
  "offset": 0,
  "limit": 1000,
  "order_by": "created_timestamp",
  "order_by_direction": "DESC"
}' |
apify call api_massta/pump-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=api_massta/pump-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/luKbq668HbKGpGkMt/builds/rVsqn8XnRCkxFf0y0/openapi.json