Obtén los mints de tokens de Pump.fun con eventos analizados

Esta guía obtiene todos los tokens que una billetera ha desplegado en Pump.fun. Recorre por páginas el historial analizado de la billetera y selecciona las dos instrucciones que Pump.fun usa para lanzar un token hasta agotar el historial. Es el equivalente histórico de la guía de flujos analizados Rastrear mints de Pump.fun: el mismo programa, los mismos nombres de instrucciones y los mismos campos decodificados, obtenidos bajo demanda en lugar de enviarse en tiempo real.

Look Up the Program

Pump.fun lanza tokens mediante dos instrucciones según la versión: create e create_v2. Los eventos analizados decodifican las instrucciones mediante el mismo catálogo IDL que usan los flujos analizados, así que confirma los nombres decodificados exactos y los roles de las cuentas con su método describeProgram antes de buscar coincidencias:

Request

{ "jsonrpc": "2.0", "id": 1, "method": "describeProgram", "params": [{ "program": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" }] }

Revisa la lista instructions de la respuesta para encontrar create e create_v2, y su lista roles para encontrar la cuenta que buscas, normalmente la nueva dirección de mint, y un rol de cuenta creator o un campo creator en args. Las dos versiones de la instrucción no necesariamente tienen la misma estructura. Por eso, el código siguiente comprueba tanto un argumento como un par de nombres de roles, en lugar de asumir una sola estructura.

Build the Request

Obtén el historial de la billetera del creador página por página:

{
  "address": "<CREATOR_WALLET>",
  "limit": 100,
  "sortOrder": "desc",
  "commitment": "confirmed"
}

Conviene conocer de antemano tres diferencias respecto del filtro de streaming:

address siempre es obligatorio. No se admiten análisis de todo el programa, por lo que obtienes las implementaciones de una sola billetera, no todas las implementaciones de Pump.fun. Para el flujo continuo, usa flujos analizados.
El historial de transacciones no tiene un filtro de instrucciones del lado del servidor. Devuelve todo aquello con lo que interactuó la dirección, y en el siguiente paso extraes las instrucciones de Pump.fun del lado del cliente. Si prefieres filtrar del lado del servidor, el endpoint de análisis (POST /v1/parsed-events/scan) acepta los mismos campos, además de match.programs.
De forma predeterminada, el historial solo devuelve transacciones exitosas (status: "succeeded"), por lo que las implementaciones fallidas, que nunca generan una acuñación activa, ya quedan excluidas. Pasa status: "any" para incluirlas.

Page Through History

Cada resultado contiene todas las instrucciones de la transacción. Analiza parsed.instructions para encontrar las coincidencias de create/create_v2 y sigue pasando paginationToken hasta que desaparezca:

pumpfun-mint-history.js

const API_KEY = process.env.HELIUS_API_KEY;

if (!API_KEY) {
  console.error("Missing HELIUS_API_KEY.");
  process.exit(1);
}

const URL = `https://mainnet.helius-rpc.com/v1/parsed-events/transaction-history?api-key=${API_KEY}`;
const PUMP_PROGRAM = "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P";
const CREATE_INSTRUCTIONS = ["create", "create_v2"];
const CREATOR = process.argv[2];

if (!CREATOR) {
  console.error("Usage: node pumpfun-mint-history.js <CREATOR_WALLET>");
  process.exit(1);
}

async function fetchPage(paginationToken) {
  const body = {
    address: CREATOR,
    limit: 100,
    sortOrder: "desc",
    commitment: "confirmed",
  };
  if (paginationToken) body.paginationToken = paginationToken;

  const response = await fetch(URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }
  return response.json();
}

async function main() {
  let paginationToken;
  let deployCount = 0;

  do {
    const page = await fetchPage(paginationToken);

    for (const result of page.data) {
      if (result.parserStatus !== "OK") continue;
      // Failed deploys never produce a live mint.
      if (result.parsed.transactionStatus !== "OK") continue;

      for (const ix of result.parsed.instructions) {
        if (ix.programId !== PUMP_PROGRAM) continue;
        if (!CREATE_INSTRUCTIONS.includes(ix.instructionName)) continue;
        deployCount += 1;
        handleDeploy(result, ix, deployCount);
      }
    }

    paginationToken = page.paginationToken;
  } while (paginationToken);

  console.log(`${deployCount} pump deploys found for ${CREATOR}`);
}

main();

Extract Each Deploy

Extrae el mint, el creador y los metadatos de la instrucción decodificada, igual que lo hace el listener de streaming:

// Pull an account pubkey out of a decoded instruction by its role name.
function accountByRole(decoded, role) {
  return decoded?.accounts?.find((a) => a.name === role)?.pubkey ?? null;
}

function handleDeploy(result, ix, deployCount) {
  const args = ix.decoded?.args ?? {};
  const mint = accountByRole(ix.decoded, "mint");
  const creator =
    args.creator ??
    accountByRole(ix.decoded, "creator") ??
    accountByRole(ix.decoded, "user");

  console.log(`pump deploy #${deployCount} (${ix.instructionName})`);
  console.log(`    mint:    ${mint}`);
  console.log(`    creator: ${creator}`);
  console.log(`    name:    ${args.name ?? "?"}`);
  console.log(`    symbol:  ${args.symbol ?? "?"}`);
  console.log(`    uri:     ${args.uri ?? "?"}`);
  console.log(`    slot=${result.parsed.slot} sig=${result.signature}`);
}

Comprueba que ix.decoded esté presente antes de confiar en args e accounts. De lo contrario, una compilación no reconocida del programa Pump.fun aparecería como mint: null y solo tendrías rawData e rawAccounts con los que trabajar.

Próximos pasos

Track Pump.fun Mints

La versión en tiempo real: un listener resistente a las reconexiones que registra cada nuevo despliegue cuando llega.

Empieza aquí

Datos en tiempo real

Trading de baja latencia

Datos históricos y de billeteras

Guías de métodos RPC

Preparación para producción

Uso de Orb

Otras guías prácticas

Obtén los mints de tokens de Pump.fun con eventos analizados

Próximos pasos

Track Pump.fun Mints

​Próximos pasos

Track Pump.fun Mints

Próximos pasos