Live

Live WebSocket connections to get instantly notified of events

Intro

WebSocket's allow live 2-way communication between us and you, allowing you to "subscribe" to events.

The endpoint is wss://api.pumplify.fun/data/live

All endpoints take a JSON messages with event and data..

Subscriptions

If you want to subscribe to multiple events reference Handling Multiple Subscriptions

New Token Launches

Use the event subscribeNewTokens to get notified of new pump.fun launches.

Response

{
  "event": "newToken",
  "data": {
    "mint": string,
    "symbol": string,
    "name": string,
    "uri": string,
    "user": string,
    "signature": string
  }
}

Tutorial

TypeScript

import WebSocket from "ws";

//Open the websocket connection
const ws = new WebSocket("wss://api.pumplify.fun/data/live");

ws.on("open", function open() {
  // Subscribing to new token events
  let payload = {
    event: "subscribeNewTokens",
  };
  ws.send(JSON.stringify(payload));
});

// Log the incoming messages
ws.on("message", function message(data) {
  console.log(JSON.parse(data.toString()));
});

Migrations

Use the event subscribeMigrations to get completed migrations of pump.fun to raydium.

Response

{
  "event": "migration",
  "data": {
    "mint": string,
    "signature": string
  }
}

Tutorial

TypeScript

import WebSocket from "ws";

//Open the websocket connection
const ws = new WebSocket("wss://api.pumplify.fun/data/live");

ws.on("open", function open() {
  // Subscribing to migration events
  payload = {
    event: "subscribeMigrations",
  };
  ws.send(JSON.stringify(payload));
});

// Log the incoming messages
ws.on("message", function message(data) {
  console.log(JSON.parse(data.toString()));
});

Market Cap

Use the event subscribeMint and provide mint as a field in data. It will send you a message everytime the market cap changes.

This is a beta endpoint

Currently data is only streamed for the majority of coins pre-migration.

Please report any bugs encountered with this endpoint. We are working to complete it for you.

Request

{
  "event": "subscribeMint",
  "data": {
    "mint": "ca of token"
  }
}

Response

{
  "event": "pumpMintUpdate",
  "data": {
    "mint": "ca of the token",
    "marketCapUsd": 29722.379805964432,
    "marketCapSol": 220.476076003,
    "timestamp": 1741993140
  }
}

Tutorial

TypeScript

import WebSocket from "ws";

//Open the websocket connection
const ws = new WebSocket("wss://api.pumplify.fun/data/live");

ws.on("open", function open() {
  // Subscribing to market cap live
  const payload = {
    event: "subscribeMint",
    data: {
      mint: "ca here",
    },
  };
  ws.send(JSON.stringify(payload));
});

// Log the incoming messages
ws.on("message", function message(data) {
  console.log(JSON.parse(data.toString()));
});

Unsubscribing

We ask that you please unsubscribe to any subscriptions you no longer are using by sending the subscription request prefixed with un. For endpoints such as tokenUpdates, still provide the mint you want to unsubscribe from.

Example: unsubcribeNewTokens

Handling Multiple Subscriptions

Creating a new WebSocket for each subscription may result in you being banned for too many connections. To handle multiple subscriptions send multiple subscribe messages on the same connection. You can then filter the event to perform different actions. Please contact us if you were banned.

TypeScript

import WebSocket from "ws";

//Open the websocket connection
const ws = new WebSocket("wss://api.pumplify.fun/data/live");

ws.on("open", function open() {
  // Subscribing to new token events
  const payload1 = {
    event: "subscribeNewTokens",
  };
  ws.send(JSON.stringify(payload1));

  // Subscribing to migration events
  const payload2 = {
    event: "subscribeMigrations",
  };
  ws.send(JSON.stringify(payload2));
  
  // Subscribing to token market cap
  const payload3 = {
    event: "subscribeMint",
    data: {
      mint: "ca here",
    },
  };
  ws.send(JSON.stringify(payload3));
});

// Log the incoming messages
ws.on("message", function message(data) {
  console.log(JSON.parse(data.toString()));
});