Pump.fun Real-Time Monitor - Live Solana Token Events

A high-performance Apify Standby Actor that streams live Solana meme token events from the Pump.fun platform in real-time. Track new token launches, graduations, and trading activity instantly with Server-Sent Events (SSE). No polling required - events are pushed to your client as they happen.

🚀 Overview

This Standby-only Actor provides real-time access to all Pump.fun platform events through HTTP API endpoints. The service operates as a lightweight, always-on web server delivering sub-second event notifications. No polling required - events are pushed to your client as they happen, ensuring you never miss important market movements.

✨ Key Features

• 🔄 Apify Standby Mode: Always-on, fast-responding web server
• 🔴 Real-Time Event Streaming: Instant delivery via Server-Sent Events (SSE)
• 📊 Multiple Event Types:
  • New token launches with detailed metadata
  • Token graduations and platform transitions
  • Live trading activity (buy/sell transactions)
• 🎯 Flexible Endpoints: Subscribe to all events or filter by type
• ⚡ High Performance: Sub-second event delivery optimized for Standby mode
• 💪 Scalable: Handles thousands of concurrent connections
• 🛡️ Production Ready: Comprehensive health monitoring and auto-scaling

🌐 Available Endpoints

Endpoint	Description	Event Types	Use Case
/events/all	All platform events	new_coin, new_coin_detailed, graduated, trade, pump_trade	Complete real-time monitoring
/events/tokens/new	New token launches	new_coin	Track basic new token info
/events/tokens/new/detailed	Detailed new tokens	new_coin_detailed	Full metadata for new tokens
/events/tokens/graduated	Token graduations	graduated	Monitor token graduations
/events/trades/pump	Pump.fun bonding curve trades	trade	Pre-graduation pump trading
/events/trades/pumpswap	PumpSwap trades	pump_trade	Pump.fun's native DEX trading
/health	Service health check	-	Monitor service status

🔧 Quick Start

Standby Mode Only

This Actor only works in Standby mode. It cannot be run in normal mode. When you run it normally, it will only display a message and exit.

Basic Usage

# Monitor ALL events (recommended for comprehensive coverage)
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     -N https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/events/all

# Monitor only NEW TOKEN LAUNCHES (basic info, fastest)
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     -N https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/events/tokens/new

# Monitor DETAILED NEW TOKENS (complete metadata)
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     -N https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/events/tokens/new/detailed

# Monitor TOKEN GRADUATIONS
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     -N https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/events/tokens/graduated

# Monitor PUMP.FUN BONDING CURVE TRADES
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     -N https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/events/trades/pump

# Monitor PUMPSWAP TRADES (pump.fun's native DEX)
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     -N https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/events/trades/pumpswap

# Check service health and connection stats
curl -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
     https://muhammetakkurtt--pump-fun-real-time-monitor.apify.actor/health

🔍 Health Monitoring & Service Status

Health Endpoint Response

Healthy Service Response:

{
  "status": "ok",
  "message": "Pump.fun Real-time Monitor",
  "connected": true,
  "messages_processed": 125847,
  "connections": {
    "total": 23,
    "by_endpoint": {
      "all": 8,
      "tokens/new": 5,
      "tokens/new/detailed": 3,
      "tokens/graduated": 2,
      "trades/pump": 4,
      "trades/pumpswap": 1
    }
  }
}

📊 Event Data Structure

1. New Token Data - new_coin

{
    "data": {
        "associatedBondingCurve": "4QD9FSfoxBu6pbrMmhEmZTgTNCGGhhj7zd5V11QS8HTw",
        "bondingCurve": "GbxJXuCZK6rEMXD9d872MPN7oKis7pp7SA9VkYW3R7CY",
        "creationTime": 1755778417448,
        "dev": "9rJLLRC4T4pfjbWHzAxtJozfQS5HZq1e94og26krVTWF",
        "imageUrl": "",
        "marketCap": 5140.54,
        "mint": "EnXAsNuGucEQ8JQqGQQ1cu9rkA1sLzLbnp1KrTyfpump",
        "name": "DDG CORE",
        "numHolders": 0,
        "progress": 0,
        "sentTime": 1755778417448,
        "ticker": "bihimddg",
        "volume": 0
    },
    "event_type": "new_coin"
}

2. New Token (Detailed) - new_coin_detailed

{
    "data": {
        "associated_bonding_curve": "7i6Msw2ouCHMhpAnzWkn4g9RCwZjQokTSJmpxsWkGVxa",
        "ath_market_cap": null,
        "ath_market_cap_timestamp": null,
        "banner_uri": null,
        "bonding_curve": "Da7Eau2ogeD6hf2ieAcpvrFBkzNMNymLAXivHixZ4aB1",
        "complete": false,
        "created_timestamp": 1755776831669,
        "creator": "jew19JvV87ZTcC7XUNwJ6vsimqUpBLdW9w1AudDm6QT",
        "description": "",
        "hidden": null,
        "hide_banner": false,
        "image_uri": "https://metadata.pumplify.eu/data/QmS4PoR2erZeHVxcFZV6k67b1prXVoKBw1G6uY2Yy6HvMS",
        "initialized": true,
        "inverted": null,
        "is_banned": false,
        "is_currently_live": false,
        "king_of_the_hill_timestamp": null,
        "last_reply": null,
        "last_trade_timestamp": null,
        "livestream_ban_expiry": 0,
        "livestream_downrank_score": 0,
        "market_cap": 27.958993476,
        "market_id": null,
        "metadata_uri": "https://rapidlaunch.io/temp/metadata/1b0b3402-37b1-44e8-90bc-5074b0fa10d7.json",
        "mint": "8LDi1a6aSkeuKXGYCfCeiDDUwMAv21HA5NSDPjeipump",
        "name": "Yeblecoin",
        "nsfw": false,
        "pump_swap_pool": null,
        "raydium_pool": null,
        "real_sol_reserves": 0,
        "real_token_reserves": 793100000000000,
        "reply_count": 0,
        "show_name": true,
        "symbol": "Yeble",
        "telegram": "",
        "total_supply": 1000000000000000,
        "twitter": "https://x.com/CampbellEaston/status/1958496015754961388",
        "updated_at": null,
        "usd_market_cap": 5157.0363466481995,
        "video_uri": null,
        "virtual_sol_reserves": 30000000000,
        "virtual_token_reserves": 1073000000000000,
        "website": ""
    },
    "event_type": "new_coin_detailed"
}

3. Token Graduation - graduated

{
    "data": {
        "allTimeHighMarketCap": "76170.50",
        "bondingCurveProgress": 100,
        "coinMint": "D2mytbo9pDtNadW6r6hPA7i9RZuwQoGudq3LyhsSpump",
        "creationTime": 1755461505884,
        "currentMarketPrice": 0,
        "dev": "EgojjvrSaxSLsyrjqAJkpcQZT4WHKBHVupBnTVxY48bB",
        "devHoldingsPercentage": "1.7294",
        "graduationDate": 1755785754532,
        "holders": [
            {
                "holderId": "8TVQkS7qJFJvxKQPUoW93bLVoBTsMScJ5z1KTAdDzhqm",
                "isSniper": 0,
                "ownedPercentage": 6.7091,
                "totalTokenAmountHeld": 67090883.516794
            },
            {
                "holderId": "DyvJoTQpQ2tCqKEGuL2ecWVGssm8Qci9ot49LUsmcmtG",
                "isSniper": 0,
                "ownedPercentage": 0,
                "totalTokenAmountHeld": 0.282231
            },
            {
                "holderId": "9ZoEbu5e42mEqZ14tXnShVnJEwGdggKYNp6WozyvXmPS",
                "isSniper": 0,
                "ownedPercentage": 0.0093,
                "totalTokenAmountHeld": 93012.9478
            },
            {
                "holderId": "FYna68u6ycLSfdojmwmK5XC2KzbS4Ru5WvR76G1bVBBg",
                "isSniper": 0,
                "ownedPercentage": 4.0887,
                "totalTokenAmountHeld": 40886826.258555
            },
            {
                "holderId": "AMvuJVYJzF5pkGqnZ3TqppQbqn3GnzUVpo2Ym43Vdt1W",
                "isSniper": 0,
                "ownedPercentage": 2.2655,
                "totalTokenAmountHeld": 22654991.972817
            },
            {
                "holderId": "FkxvTXXocqxFNYU4Kso9iKdDFBE6PhnSbpVPtwmTq4pY",
                "isSniper": 0,
                "ownedPercentage": 0.0425,
                "totalTokenAmountHeld": 425386.411665
            },
            {
                "holderId": "7DgDvRqUGUYDKeJuYbmQWLjsEBezdc4YptkTboUGDjJS",
                "isSniper": 0,
                "ownedPercentage": 0.2785,
                "totalTokenAmountHeld": 2785325.846365
            },
            {
                "holderId": "Ef1Tjokjw9PtfYuEFTyN2jX25BrKMxQ7LWMWsbAnMg9Z",
                "isSniper": 0,
                "ownedPercentage": 0.1989,
                "totalTokenAmountHeld": 1989486.071195
            },
            {
                "holderId": "B47z8ffNrEjtfmKqbbK7cx7c3pVqnAZkWZ7snQQ2Uujz",
                "isSniper": 0,
                "ownedPercentage": 0.0992,
                "totalTokenAmountHeld": 991979.535629
            },
            {
                "holderId": "EgojjvrSaxSLsyrjqAJkpcQZT4WHKBHVupBnTVxY48bB",
                "isSniper": 1,
                "ownedPercentage": 1.7294,
                "totalTokenAmountHeld": 17294454.86308
            },
            {
                "holderId": "9T2vSsJ3NLTY7gsnyEsEfU1R74Q3sQFbzq8t5rzUCnAW",
                "isSniper": 0,
                "ownedPercentage": 0.0196,
                "totalTokenAmountHeld": 195527.075942
            },
            {
                "holderId": "FnXvp2F56KtkEaXHzYiXfW1H76fsvP1WC5GGNVJ8myvE",
                "isSniper": 0,
                "ownedPercentage": 0.4794,
                "totalTokenAmountHeld": 4793920.080965
            },
            {
                "holderId": "BCyrWe8D5dfPR96LnHSVSEzNLHZHdqihEBacfifCUSsL",
                "isSniper": 0,
                "ownedPercentage": 2.8712,
                "totalTokenAmountHeld": 28711845.481189
            },
            {
                "holderId": "ErgQy8KR6b1ptfPQgQWVF999vpva1n1guSyoN2P4Dim6",
                "isSniper": 0,
                "ownedPercentage": 0.2748,
                "totalTokenAmountHeld": 2748283.875226
            },
            {
                "holderId": "Gr17FKUonmn7j7WZkNGvuaihwJUxrBcnsfiQfZQ2hLrh",
                "isSniper": 0,
                "ownedPercentage": 0.0007,
                "totalTokenAmountHeld": 7090.958546
            },
            {
                "holderId": "FGuDG2amKwbcd3waQ8mAYFpSfcaNuknV94bv8F1CKSHm",
                "isSniper": 0,
                "ownedPercentage": 0.005,
                "totalTokenAmountHeld": 50067.919358
            },
            {
                "holderId": "5bbeMVKKwJR6Kq1XQmaSimVVUZWZ35gadCcqPHRpT6dw",
                "isSniper": 0,
                "ownedPercentage": 0.0003,
                "totalTokenAmountHeld": 2891.888552
            },
            {
                "holderId": "4fV24RvmwscbMLDSiF9YGj7oz85rbqZD6g3ebteDTdpE",
                "isSniper": 0,
                "ownedPercentage": 0.0147,
                "totalTokenAmountHeld": 147440.967449
            },
            {
                "holderId": "FTEhsF1d21rRJxcmHY2JvpoJPr6dppSCttiAVo9YwDQB",
                "isSniper": 0,
                "ownedPercentage": 0.1711,
                "totalTokenAmountHeld": 1711081.601507
            },
            {
                "holderId": "5gDW9Q7PA2UmWYYGecHiZSfJmsu6htZjFY4PLUdtevy7",
                "isSniper": 0,
                "ownedPercentage": 0.7454,
                "totalTokenAmountHeld": 7454045.031834
            },
            {
                "holderId": "3joBhfZdCqzqCy15uB2hykRk4H4LqYb5ifTZxvywap9n",
                "isSniper": 0,
                "ownedPercentage": 0,
                "totalTokenAmountHeld": 1.748659
            },
            {
                "holderId": "BWSQmMShRnu4tji3bLoDBGxWSUHkjRd4WzbPMAZ3WaZk",
                "isSniper": 0,
                "ownedPercentage": 0.5243,
                "totalTokenAmountHeld": 5243026.402609
            },
            {
                "holderId": "5Bq2JYhMtscPhvURdyFoTZADwWjWoEkn6Ybn88rwqPkz",
                "isSniper": 0,
                "ownedPercentage": 0.095,
                "totalTokenAmountHeld": 950228.256405
            },
            {
                "holderId": "4LgcLT67agM1feHViikK7uh91Q117ZVJtSGBCiMeyV19",
                "isSniper": 0,
                "ownedPercentage": 0.0192,
                "totalTokenAmountHeld": 192326.590643
            },
            {
                "holderId": "4KtUPzz5zedfsLXxm3bJpMXXPYKxfxrfQskfYaTRfNPw",
                "isSniper": 0,
                "ownedPercentage": 3.2954,
                "totalTokenAmountHeld": 32954159.68438
            },
            {
                "holderId": "GvwpWsfdasCktkhTX8cUVB4pTWfkZXWA86KVhKHntZZL",
                "isSniper": 0,
                "ownedPercentage": 0.0157,
                "totalTokenAmountHeld": 156985.45315
            },
            {
                "holderId": "B63NzGViaWcJznyrH2xyb5qyjsY8nfjbsPrQhGWmVQtC",
                "isSniper": 0,
                "ownedPercentage": 0.1653,
                "totalTokenAmountHeld": 1652949.87637
            },
            {
                "holderId": "627LYuUb7aKuG1bHsm7rT8gbb25u8C6QHoDZsGKPiJXf",
                "isSniper": 0,
                "ownedPercentage": 0.0211,
                "totalTokenAmountHeld": 210577.165066
            },
            {
                "holderId": "JButa2yymQayisAf7JGNrgay3nFi2FyZYcP3er1yweqC",
                "isSniper": 0,
                "ownedPercentage": 0.2648,
                "totalTokenAmountHeld": 2647622.012928
            },
            {
                "holderId": "34FKjAdVcTax2DHqV2XnbXa9J3zmyKcFuFKWbcmgxjgm",
                "isSniper": 0,
                "ownedPercentage": 0.0002,
                "totalTokenAmountHeld": 1668.460834
            },
            {
                "holderId": "2t9Ft5FopkKiDvzqVBi7UcjsHYWzfxwkcbWtH6K53iHW",
                "isSniper": 0,
                "ownedPercentage": 0.3865,
                "totalTokenAmountHeld": 3865185.017347
            },
            {
                "holderId": "6gjJT1hZmVdthaxfrEpuBhghC7Az9Fg5eDoxcskDpBXs",
                "isSniper": 0,
                "ownedPercentage": 1.0305,
                "totalTokenAmountHeld": 10304999.097253
            },
            {
                "holderId": "A2nB8XJXScF71gDALSrtzDis1v4RDAramHyyvRPM9qnN",
                "isSniper": 0,
                "ownedPercentage": 0.191,
                "totalTokenAmountHeld": 1910297.075027
            },
            {
                "holderId": "8NQoGFQQY5yVYjgBAE1GPNEqqF5jyekw1ZGH5dEjW5kw",
                "isSniper": 0,
                "ownedPercentage": 0.0433,
                "totalTokenAmountHeld": 433119.276893
            },
            {
                "holderId": "AiTpz1W9xkaRbJ5cJFQfJ9cUB5q3Qrb9hwCjugU9FNET",
                "isSniper": 0,
                "ownedPercentage": 1.0465,
                "totalTokenAmountHeld": 10464572.951807
            },
            {
                "holderId": "5ijTuagjbQLv4kHW6pj6Lr7KvLseBbTpJXF2YoS1J1QT",
                "isSniper": 0,
                "ownedPercentage": 0.2218,
                "totalTokenAmountHeld": 2217549.512248
            },
            {
                "holderId": "GRmJdaDYQ5S3gYzFuTVshbq1vo6L5bSpEQYSN5w6AFcQ",
                "isSniper": 0,
                "ownedPercentage": 0.8688,
                "totalTokenAmountHeld": 8687637.059719
            },
            {
                "holderId": "22GhnQQ2jbZu9QHJZXgkUD5rot9AKh6CNWV3bbb5tEHh",
                "isSniper": 0,
                "ownedPercentage": 0,
                "totalTokenAmountHeld": 91.131304
            },
            {
                "holderId": "4jJqnkXnN1GCjypDUBR3heCJRScejbpjDxjsHcmV8vbk",
                "isSniper": 0,
                "ownedPercentage": 0.4877,
                "totalTokenAmountHeld": 4876941.984484
            },
            {
                "holderId": "7UzvNzhvw3RakGrULo9LFTaMStXizqC3yJZuZJZNAHgc",
                "isSniper": 0,
                "ownedPercentage": 2.1586,
                "totalTokenAmountHeld": 21586069.992758
            },
            {
                "holderId": "CUULrtw2LytmUja9cSvLDKwCuKpKAB32cagacWHMn1DY",
                "isSniper": 0,
                "ownedPercentage": 3.8583,
                "totalTokenAmountHeld": 38582912.965138
            },
            {
                "holderId": "8psNvWTrdNTiVRNzAgsou9kETXNJm2SXZyaKuJraVRtf",
                "isSniper": 0,
                "ownedPercentage": 0.0022,
                "totalTokenAmountHeld": 22462.117506
            },
            {
                "holderId": "DipuuFJGSh3cZ4e7jTgRRyzso1qwNa7yHszkP39wXDYH",
                "isSniper": 0,
                "ownedPercentage": 0.7549,
                "totalTokenAmountHeld": 7548665.041873
            },
            {
                "holderId": "5U7PB3gN9wredmae9KFPH3fEgwBtbzvavXwrqzj7T5PS",
                "isSniper": 0,
                "ownedPercentage": 0.0155,
                "totalTokenAmountHeld": 155158.869325
            },
            {
                "holderId": "5z9AJZqptLZ4VsyCHZjZVgS611e8pzP1nj6RUXPpf5ZH",
                "isSniper": 0,
                "ownedPercentage": 0.2095,
                "totalTokenAmountHeld": 2094958.835282
            },
            {
                "holderId": "HvtiMoLHboqi7SSaxe5taceakwYv2xkG9iFCJvS5VNYv",
                "isSniper": 0,
                "ownedPercentage": 0.1834,
                "totalTokenAmountHeld": 1834112.779961
            },
            {
                "holderId": "CQUmv9Pqi3QLbZsRj6BGB2MMENoWJv9Toc8zPnLovd4v",
                "isSniper": 0,
                "ownedPercentage": 0.9295,
                "totalTokenAmountHeld": 9295243.735053
            },
            {
                "holderId": "3ScbXezyYGj6X3v6zStFRa3ron9J1FrzRJXRnMFFaZrh",
                "isSniper": 0,
                "ownedPercentage": 0.1388,
                "totalTokenAmountHeld": 1388379.517726
            },
            {
                "holderId": "BkHmRo9PJsuQC9hxh4WZ4BpmZMRjg9dgqWzmckdQCQkA",
                "isSniper": 0,
                "ownedPercentage": 0.0308,
                "totalTokenAmountHeld": 308345.022448
            },
            {
                "holderId": "9zgi46gHR46MQoPtXcNJq5gzpjwBEmFVwDJ6WTh4W2D3",
                "isSniper": 0,
                "ownedPercentage": 0.2938,
                "totalTokenAmountHeld": 2937789.969619
            },
            {
                "holderId": "BeWDqTWP9Mf7euCwCJDiLPhfgivycqfHpCEnehXtdtYS",
                "isSniper": 0,
                "ownedPercentage": 1.3297,
                "totalTokenAmountHeld": 13297382.192538
            },
            {
                "holderId": "GCnVkzoYTYwC2gLFeaSs8NaLjuCJLv1pkniHKUPdC3Sj",
                "isSniper": 0,
                "ownedPercentage": 0.0974,
                "totalTokenAmountHeld": 973580.236004
            },
            {
                "holderId": "pSwTTFE92RsRtvMCpb3mjruv5ww2KgBNVPscwdWwbxk",
                "isSniper": 0,
                "ownedPercentage": 0.0001,
                "totalTokenAmountHeld": 794.52496
            },
            {
                "holderId": "C41BjGEH5BbZVpoLSVKzVu8UBvduqMj8au44fajJX51N",
                "isSniper": 0,
                "ownedPercentage": 4.1362,
                "totalTokenAmountHeld": 41361614.305866
            },
            {
                "holderId": "3JhBw6JW4A4eoUhFzmeYkY1Qx1kFLD6LWaEBUBKxdeQk",
                "isSniper": 0,
                "ownedPercentage": 0.0648,
                "totalTokenAmountHeld": 647503.928221
            },
            {
                "holderId": "45ruCyfdRkWpRNGEqWzjCiXRHkZs8WXCLQ67Pnpye7Hp",
                "isSniper": 0,
                "ownedPercentage": 0.0001,
                "totalTokenAmountHeld": 1257.795586
            },
            {
                "holderId": "4bC3hkmTPrnbrjVW6pY3U2gBWFYg4yB9cP3egVWY6yV6",
                "isSniper": 0,
                "ownedPercentage": 0.0333,
                "totalTokenAmountHeld": 332662.794195
            },
            {
                "holderId": "2snHHreXbpJ7UwZxPe37gnUNf7Wx7wv6UKDSR2JckKuS",
                "isSniper": 0,
                "ownedPercentage": 0.0216,
                "totalTokenAmountHeld": 216397.040798
            },
            {
                "holderId": "4SJW9HRUCTqSPUc7E2LxSG1tpSS8nnDPZJEkZF8w3wKP",
                "isSniper": 0,
                "ownedPercentage": 0.0114,
                "totalTokenAmountHeld": 113765.445108
            },
            {
                "holderId": "3sJ7bsuvQGKkp7HMFVJSFFuwGbKhuTk3fmCHCgBTxvBQ",
                "isSniper": 0,
                "ownedPercentage": 2.0978,
                "totalTokenAmountHeld": 20977513.333802
            },
            {
                "holderId": "3fy7h2yU88GxnQmnYpuqiCP4E2FyDkQwj4vKSGmonmVQ",
                "isSniper": 0,
                "ownedPercentage": 0.7512,
                "totalTokenAmountHeld": 7511773.394565
            },
            {
                "holderId": "8ZqsDhF7RZPnaqD6gs1tvtEzNyBMpbgAzQZkgY8gzsny",
                "isSniper": 0,
                "ownedPercentage": 0.1836,
                "totalTokenAmountHeld": 1835567.759538
            },
            {
                "holderId": "9AATcAEwqXiyYD5sM2DBNtcTwKDBxupvdwNH3UzLrzpz",
                "isSniper": 0,
                "ownedPercentage": 0.0726,
                "totalTokenAmountHeld": 725671.176379
            },
            {
                "holderId": "whQtYnAWAQKEL7MXTNPeMoxY9gHsoXmiP4EMg6sxeka",
                "isSniper": 0,
                "ownedPercentage": 0.1785,
                "totalTokenAmountHeld": 1785192.443745
            },
            {
                "holderId": "GW1kS9xnTojh5fipgUSzwpPZjtWhovDRLtXE2gNYrK6m",
                "isSniper": 0,
                "ownedPercentage": 0.0002,
                "totalTokenAmountHeld": 2449.328554
            },
            {
                "holderId": "2Ytotm42Dg44Q6f1YGiZmTFVJSzUoXmGsqqk72H5AFEi",
                "isSniper": 0,
                "ownedPercentage": 1.0115,
                "totalTokenAmountHeld": 10115254.506918
            },
            {
                "holderId": "C5zup1Si5NoBPASJDMgcKQ7GwGzGCjFmCtUHCjxWBWMW",
                "isSniper": 0,
                "ownedPercentage": 0.3339,
                "totalTokenAmountHeld": 3339357.923309
            },
            {
                "holderId": "GfoF71kaNzAdrmbf1fcCMSw5M87EiXmGAn5zCXVxZJVx",
                "isSniper": 0,
                "ownedPercentage": 0.1612,
                "totalTokenAmountHeld": 1612174.86726
            },
            {
                "holderId": "68ssUM7kMw8kEHUfMEpkg9vbWhFmXDeTAua9wdn4DWg",
                "isSniper": 0,
                "ownedPercentage": 0.0154,
                "totalTokenAmountHeld": 154025.610149
            },
            {
                "holderId": "23mvnyjjhYMpXeBsMGD855XhNvZPT1TGpapKnMQiwNsK",
                "isSniper": 0,
                "ownedPercentage": 0,
                "totalTokenAmountHeld": 0.000001
            },
            {
                "holderId": "29NqQUtC8aJfSE3XYMqYPHY9LXXhVCHewgFEp2JRvPwx",
                "isSniper": 0,
                "ownedPercentage": 27.5693,
                "totalTokenAmountHeld": 275693323.263958
            },
            {
                "holderId": "61xthpvycKKUpiZsf2T54VkfRtPhA2ZU13ZhckHA3aZk",
                "isSniper": 0,
                "ownedPercentage": 2.4429,
                "totalTokenAmountHeld": 24429355.45586
            },
            {
                "holderId": "BwpqopMZ5cyM7L3sZxkkuZ3wnDozidyWuhyMR5LFcqpD",
                "isSniper": 0,
                "ownedPercentage": 0.8909,
                "totalTokenAmountHeld": 8909410.505591
            },
            {
                "holderId": "8wF5iC2eExCi5m8ywA2UBnQX9w2iWnSW4Esrs4ZEAA1K",
                "isSniper": 0,
                "ownedPercentage": 0.4366,
                "totalTokenAmountHeld": 4365593.153843
            },
            {
                "holderId": "yvM72YgGjH7M8ERiXFxFW7GPBqrtUYBKTWZCQykFZiM",
                "isSniper": 0,
                "ownedPercentage": 0.0886,
                "totalTokenAmountHeld": 886039.224356
            }
        ],
        "imageUrl": "https://ipfs.io/ipfs/QmNYziKbf4wvo7i2Z3hXSZUyHwJtvQno6D3phNqmD25jaK",
        "marketCap": 75778.62949342256,
        "name": "WallFishXRP",
        "numHolders": 75,
        "poolAddress": "zBZA2FAUHXhDbvf7uwiHgiZhKFm9feThHgTf6Hm8u4A",
        "sniperCount": 3,
        "telegram": null,
        "ticker": "WFXRP",
        "twitter": null,
        "volume": "125.957526907",
        "website": null
    },
    "event_type": "graduated"
}

4. Pump.fun Bonding Curve Trades - trade

{
    "data": [
        {
            "bondingCurveProgress": "14.02",
            "coinMint": "H5TsFVdLhzqzGt3jHq773rkdbXzSswM2RuoqBwnnpump",
            "holderId": "6rMjnkZRSiFE2ERNukE3G3sLAbdu4uPeg6dmknFer79W",
            "isBuy": false,
            "marketCap": "6397.84",
            "sentTime": 1755778668239,
            "signature": "2sGM62ZAT22AaYvg2xP4Fcic2uukDdsancY2RkoggfR2CGDNN3T9HbdxxBQwu1QkPw6JCXyDFnMp2wXo6MzS88Ki",
            "solAmount": "0.148750754",
            "timestamp": 1755778668231,
            "tokenAmount": "-4255859.221655",
            "type": "trade",
            "updatedData": {
                "allTimeHighMarketCap": "28309.86",
                "buyTransactions": "1334",
                "creation_time": "1755770272735",
                "current_market_price": "0",
                "dev": "CzYPyBeM4sv2ndub1rTWWXxehKcuQTwt3HXLrZhm4YcP",
                "graduationDate": "0",
                "imageUrl": "https://ipfs.io/ipfs/bafkreifplkkkahj5hhspinswjvev3iuo7avz4dj2ebcxzfijujxqnlvlie",
                "is_sniper": "0",
                "marketcap": "6397.84",
                "name": "The Gooner Dolphin",
                "numHolders": 57,
                "poolAddress": "",
                "progress": "14.02",
                "sellTransactions": "977",
                "sniperOwnedPercentage": "0",
                "sniper_count": "21",
                "ticker": "REGGIE",
                "transactions": "2311",
                "volume": "825.0486"
            }
        }
    ],
    "event_type": "trade"
}

5. PumpSwap Trades - pump_trade

{
    "data": [
        {
            "bondingCurveProgress": "100",
            "coinMint": "B32hGG9q55tcik9gNBPuoSHTnqFtpKYLpsApFyvCpump",
            "holderId": "8YVkPDsFGWTF1qRnuotAuBSgoxdhTHoWX6XbMXFXQjrB",
            "isBuy": true,
            "marketCap": "1217922.291471668647889557520517946289096",
            "sentTime": 1755778705587,
            "signature": "3pjbExsUJVpQBTUFyykWJ1pYp6NVoNnBmLyMyvndVFSH4t3ckCe3XpskruygGEB82u9GHke2958GgSp1gPvueReb",
            "solAmount": "0.083025198",
            "timestamp": 1755778704000,
            "tokenAmount": "0.012476489245",
            "type": "pumpSwapTrade",
            "updatedData": {
                "allTimeHighMarketCap": "2003468.6975566659",
                "buyTransactions": "23811",
                "creation_time": "1755732493602",
                "current_market_price": "0",
                "dev": "9E2FnWXUACCdpG2ubEfxEWwf378otTWb1zCVBmFJuoc1",
                "graduationDate": "1755735022371",
                "imageUrl": "https://ipfs.io/ipfs/bafkreihbbytlohcuqk4vy7luxppeuv2kwnw4fj74iqvfw6tksumwkucxoe",
                "is_sniper": "0",
                "marketcap": "1217922.2914716688",
                "name": "Mariah Milkers",
                "poolAddress": "GG2SB7eeS15ysL8rhenVvrCJPsWgxS6uZBVoBjbrgE8o",
                "progress": "100.00",
                "sellTransactions": "22383",
                "sniperOwnedPercentage": "0",
                "sniper_count": "11",
                "ticker": "MM",
                "transactions": "46194",
                "volume": "27082.432"
            }
        }
    ],
    "event_type": "pump_trade"
}

🚨 Error Handling & Connection Management

Connection Management Features

• Connection cleanup: Automatic removal of inactive clients
• Graceful shutdown: Clean disconnect notifications

Common Error Responses

Invalid Endpoint:

{
  "error": "Endpoint not found",
  "message": "Available endpoints: /health, /events/*", 
  "available_endpoints": [
    "/events/all",
    "/events/tokens/new",
    "/events/tokens/new/detailed",
    "/events/tokens/graduated",
    "/events/trades/pump",
    "/events/trades/pumpswap"
  ],
  "timestamp": "2025-01-21T10:30:45.000Z"
}

Connection Event Types

Successful Connection:

event: connected
data: {"message":"Connected to Pump.fun Monitor","connection_id":"conn_1234567890","endpoint":"all"}

Shutdown Warning:

event: shutdown  
data: {"message":"Server shutting down"}

Ping/Keep-alive:

event: ping
data: {"ping":"alive"}

🎯 Detailed Use Cases

💹 Trading & DeFi

• High-Frequency Trading Bots: React to price movements in milliseconds
• Arbitrage Detection: Monitor price differences across platforms
• New Token Sniping: Get alerted the moment tokens launch
• Graduation Tracking: Monitor tokens approaching graduation milestone
• Volume Analysis: Track trading patterns and liquidity changes

📊 Analytics & Research

• Market Research: Analyze token launch trends and success rates
• Creator Tracking: Follow specific token creators and their launches
• Social Sentiment: Correlate social activity with trading volume
• Performance Analytics: Track complete token lifecycle
• Risk Assessment: Monitor suspicious trading patterns

🔔 Monitoring & Alerts

• Portfolio Tracking: Get notified about your token holdings
• Whale Watching: Monitor large transactions and wallet activity
• Custom Alerts: Set up notifications for specific conditions
• Real-time Dashboards: Build live monitoring interfaces
• Compliance Monitoring: Track regulatory-relevant activities

🛠️ Development & Integration

• DeFi Protocol Integration: Connect with lending, staking platforms
• Wallet Integration: Enhance wallet apps with real-time data
• Portfolio Management: Build comprehensive asset tracking tools
• Market Making: Provide liquidity with real-time market data
• Academic Research: Study meme coin economics and social dynamics

💻 Example Client Implementation

Pump.fun Monitor Client

Ready-to-use Python client for consuming real-time streams from this Actor. Includes connection management, event processing, and data persistence.

🔗 Related Projects

Pump.fun Trade Monitor

Comprehensive trading data collection with advanced token filtering, historical data export, and batch processing capabilities