SUBSCRIBE_MEME

Overview

SUBSCRIBE_MEME is a WebSocket subscription message used to receive real-time updates for meme tokens based on flexible filtering criteria such as source, progress, and lifecycle timestamps.

Subscription Message

{
  "type": "SUBSCRIBE_MEME",
  "data": {
    "address": "string (optional)",
    "graduated": "boolean (optional)",
    "source": "string (optional)",
    "progress_percent": {
      "min": "number (0-100)",
      "max": "number (0-100)"
    }, // optional
    "creation_time": {
      "from": "unix timestamp (seconds)",
      "to": "unix timestamp (seconds)"
    }, // optional
    "graduated_time": {
      "from": "unix timestamp (seconds)",
      "to": "unix timestamp (seconds)"
    } // optional
  }
}

Parameters

address

Type: string
Optional
Description: Token address to filter a specific meme token.

graduated

Type: boolean
Optional
Description:
- true: only graduated tokens
- false: only non-graduated tokens

source

Type: string
Optional
Description: Filter tokens by originating platform or bonding mechanism.

Supported values (non-exhaustive):

meteora_dynamic_bonding_curve
pump_dot_fun
moonshot
raydium_launchlab

progress_percent

Type: object
Optional
Description: Filter tokens by bonding curve progress.

Fields:

min (number): minimum value (0-100)
max (number): maximum value (0-100)

creation_time

Type: object
Optional
Description: Filter by token creation time (Unix timestamp in seconds).

Fields:

from (number): start timestamp
to (number): end timestamp

graduated_time

Type: object
Optional
Description: Filter by token graduation time (Unix timestamp in seconds).

Fields:

from (number): start timestamp
to (number): end timestamp

Constraints: Requires graduated = true

WebSocket Event

Event Type

MEME_DATA

Event Payload Example

{
  "type": "MEME_DATA",
  "data": {
    "eventType": "meme_stats",
"address": "HCTBRtDWQAs7HBSBSGpj5YxYMozTqa9edXpY5PvJpump",
        "name": "COG",
        "symbol": "COG",
        "decimals": 6,
        "extensions": {
            "description": "",
            "twitter": "https://x.com/cogmeme/status/2037572234747752604?s=20",
            "website": "https://x.com/i/communities/2037572021614182528"
        },
        "logo_uri": "https://blue-occupational-wombat-892.mypinata.cloud/ipfs/bafkreigkkz4kauf2d3udu7wk3wikb7exuusw7nkgdezi6dyvksgt3a5pgy",
        "price": 0.000002391278705964878,
        "liquidity": 2885.22719133404,
        "meme_info": {
            "source": "pump_dot_fun",
            "platform_id": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
            "created_at": {
                "slot": 409246592,
                "tx_hash": "3VvwPB1xF9qQPNEYDNHBsnzjCU9h9baSmHG1eoLWrAPfg46HFx1LtvA6JbJ9xT8awWKJ9bVKYRbqZJSngr7tk4UV",
                "block_time": 1774630070
            },
            "creation_time": 1774630070,
            "creator": "FqGMsxpzuz4789S2S2wmuFaj27pLgRdB19XcyoCDS7wY",
            "graduated": false,
            "graduated_time": null,
            "pool": {
                "address": "B7Y3Srz4UnsemXzWhKRFsm31LRAQsE9vjiyANrivD9Mf",
                "real_sol_reserves": "4",
                "real_token_reserves": "793100000000000",
                "token_total_supply": "1000000000000000",
                "virtual_token_reserves": "1073000000000000"
            },
            "progress_percent": 3.89329,
            "address": "HCTBRtDWQAs7HBSBSGpj5YxYMozTqa9edXpY5PvJpump"
    		}
  	}
}

Notes

All timestamps are in Unix seconds
progress_percent is always between 0 and 100
graduated_time is only valid when graduated = true
Events are streamed in real-time and may update frequently
Sending a new SUBSCRIBE_MEME message will overwrite the previous subscription and replace all existing filters