Seguir transferencias de wallets y tokens en Solana

Carga el historial de transferencias de una wallet con una sola llamada REST y únete a una sala de transferencias para recibir las nuevas en cuanto ocurren. Ambos cubren SOL nativo, tokens SPL y tokens Token-2022.

Consultar el historial

Filtra por token, contraparte, tiempo, cantidad o valor en USD.

Recibir transferencias en vivo

Sigue una wallet, un token, o un token para una wallet.

Consultar el historial de transferencias

GET /account/{address}/transfers devuelve las transferencias entrantes y salientes de una wallet, de más reciente a más antigua. Las transferencias SPL se buscan a través de las token accounts de la wallet, y cada lado muestra tanto la token account (address) como la wallet propietaria (owner). Por defecto, el historial excluye las transacciones con actividad DEX, como swaps, depósitos y retiros de liquidez y cobros de comisiones de pools, así que obtienes las transferencias simples de la wallet. Usa dex=include para conservarlas o dex=only para obtener solo esas.

curl --get "https://data.solanatracker.io/account/GachaNgyXTU3zFogQ8Z5jR2BLXs8215X2AtEH18VxJq3/transfers" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-urlencode "mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  --data-urlencode "direction=in" \
  --data-urlencode "historicPrices=true" \
  --data-urlencode "limit=50"

const address = "GachaNgyXTU3zFogQ8Z5jR2BLXs8215X2AtEH18VxJq3";
let cursor;

do {
  const url = new URL(`https://data.solanatracker.io/account/${address}/transfers`);
  url.search = new URLSearchParams({ limit: "100", historicPrices: "true", ...(cursor && { cursor }) });

  const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" } });
  if (!response.ok) throw new Error((await response.json()).error);
  const page = await response.json();

  for (const t of page.transfers) {
    console.log(t.direction, t.uiAmount, t.token.symbol, t.value.usd, t.from?.owner, "->", t.to?.owner);
  }
  cursor = page.pagination.next;
} while (cursor);

Cada transferencia tiene este aspecto:

{
  "signature": "2VxcHt8HKSt2T2EuUZLyWPsEKz4H4BPreWV28aZDEzoaHG4Fsu232oKKeQqpVqsSYaf3vv8KN7UoZ4MPJA8vw9EF",
  "status": "success",
  "type": "spl",
  "direction": "in",
  "from": { "address": "C2RjaMN2NeYAErS6KiBjPQhHCt95J8mCmmLiQqZXPisR", "owner": "BfG7WYmravgBhNdWpGoiFmF8L1duw2vdqdDHiZid2hoJ" },
  "to": { "address": "D9CEogjHA6CpS12F8St9zpSco7pQKJB5uR1RqDsuzQZk", "owner": "GachaNgyXTU3zFogQ8Z5jR2BLXs8215X2AtEH18VxJq3" },
  "token": { "name": "USD Coin", "symbol": "USDC", "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "image": "https://image.solanatracker.io/proxy?url=…", "decimals": 6 },
  "amount": "25000000",
  "uiAmount": "25",
  "decimals": 6,
  "price": { "usd": 1 },
  "value": { "usd": 25 },
  "timestamp": 1792483949,
  "slot": 459159504
}

amount es la cantidad entera en bruto y uiAmount la cantidad decimal exacta, ambas como cadenas.
timestamp es la hora del bloque en segundos Unix.
type es sol para SOL nativo y spl para transferencias de tokens. SOL usa el mint de wrapped SOL So11111111111111111111111111111111111111112.
status es el resultado de la transacción, success o failed. Las transacciones fallidas se excluyen salvo que pidas status=failed o status=any.
price y value solo aparecen con historicPrices=true o un filtro de valor.
identity aparece en from o to cuando la wallet es conocida: un KOL, un exchange, un pool, un desarrollador o un nombre SNS.

Filtrar el historial

Filtro	Parámetros
Token	`mint`, `type=sol\|spl`
Dirección	`direction=in\|out\|all`
Remitente, destinatario	`from`, `to`, `counterparty` (cualquiera de los dos lados), `excludeFrom`, `excludeTo` (hasta 5 direcciones separadas por comas en cada uno, wallet o token account)
Tiempo	`start`, `end` (inclusivos), en segundos Unix
Slot	`startSlot`, `endSlot` (inclusivos)
Cantidad	`minAmount`, `maxAmount` en unidades del token, `excludeZero=true`
Valor en USD	`minValue`, `maxValue` (activan `historicPrices`; `limit` como máximo 100)
Actividad DEX	`dex=exclude\|include\|only` (por defecto `exclude`)
Resultado	`status=success\|failed\|any` (por defecto `success`)
Orden	`sortOrder=desc\|asc`

Cada parámetro tiene un solo nombre. Un nombre que el endpoint no conoce devuelve un 400 que te indica el correcto, por ejemplo unknown parameter timeStart; use start, así que una errata nunca devuelve una página sin filtrar. historicPrices=true añade price.usd y value.usd con el precio en USD del token en el momento de la transferencia, según la última vela de 1 minuto como máximo una hora antes. Sin precio, ambos son null.

Qué cuenta como actividad DEX

Una transacción tiene actividad DEX cuando una de sus transferencias va hacia o viene de un pool: una cuenta propiedad de un programa DEX o launchpad, como una bonding curve de pump.fun o un pool DLMM de Meteora, o una vault authority de Raydium o Meteora. Eso incluye swaps, depósitos y retiros de liquidez, y cobros de comisiones y recompensas. También cuenta una transacción en la que la wallet envió un token y recibió otro. dex=exclude y dex=only actúan sobre transacciones completas: todas las transferencias de la transacción se descartan o se conservan juntas. Solo se tienen en cuenta las transferencias que coinciden con direction y mint, así que, con esos filtros, una transacción cuyo tramo del pool queda filtrado cuenta como una transferencia simple.

Agrupar por transacción

Añade grouped=true para obtener además transactions, las transferencias de la página agrupadas por firma. Cada transacción incluye sus transfers, el número de ellas en legs, totals.in, totals.out y totals.tokens, y dex. type es swap cuando dex es true, y swap indica el token entrante y el saliente cuando la wallet envió un token y recibió otro. Con historicPrices=true, los totales también incluyen USD: totals.value, totals.net y usd en cada lado.

Paginar los resultados

Envía pagination.next como cursor con los mismos filtros y detente cuando hasMore sea false. Una página nunca divide una transacción, así que puede tener algunas transferencias más o menos que limit; con grouped=true, limit normalmente cuenta transacciones. Con filtros, cada solicitud recorre un número limitado de transferencias, así que una página puede tener menos de limit filas, o ninguna, aunque hasMore siga siendo true. Sigue paginando. Con minValue o maxValue, cada página valora las siguientes limit transferencias y devuelve las que coinciden. Si los precios no se pueden leer a tiempo, la solicitud devuelve un 503; vuelve a enviarla.

Usar el SDK de TypeScript

Instala @solana-tracker/data-api 0.6.0 o posterior. getAccountTransfers acepta los mismos filtros que el endpoint, y los filtros de direcciones admiten un array o una cadena separada por comas. El SDK los comprueba con las reglas de la API y lanza un ValidationError antes de enviar una solicitud que la API rechazaría. iterateAccountTransfers sigue pagination.next por ti y continúa aunque una página filtrada llegue vacía.

import { Client } from '@solana-tracker/data-api';

const client = new Client({ apiKey: 'YOUR_API_KEY' });
const wallet = 'GachaNgyXTU3zFogQ8Z5jR2BLXs8215X2AtEH18VxJq3';

// Todas las páginas de USDC recibido, con el valor en USD del momento.
for await (const page of client.iterateAccountTransfers(wallet, {
  mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  direction: 'in',
  historicPrices: true,
  limit: 100,
})) {
  for (const t of page.transfers) {
    console.log(t.signature, t.uiAmount, t.token.symbol, t.value?.usd, t.from?.identity?.name ?? t.from?.owner);
  }
}

// Una entrada por transacción, swaps incluidos.
const grouped = await client.getAccountTransfers(wallet, {
  grouped: true,
  dex: 'include',
  historicPrices: true,
  limit: 50,
});
for (const tx of grouped.transactions) {
  console.log(tx.signature, tx.type, tx.totals.net?.usd, tx.swap?.out.token.symbol, '->', tx.swap?.in.token.symbol);
}

Con { grouped: true }, TypeScript sabe que la respuesta incluye transactions.

Recibir transferencias en vivo

Conecta a wss://datastream.solanatracker.io/{apiKey} con tu clave de Data API. Datastream está disponible en los planes Premium, Business y Enterprise.

Elegir una sala

transfer:wallet:{wallet}: todas las transferencias hacia o desde una wallet, en todos los tokens.
transfer:{mint}: todas las transferencias de un token. No disponible para SOL.
transfer:{mint}:{wallet}: un token hacia o desde una wallet. Funciona para SOL con el mint de wrapped SOL.

Añade :enriched a cualquier sala para incluir token (nombre, símbolo, imagen, decimales), price.usd, value.usd y marketCap.usd en cada transferencia y cambio de saldo, e identity en el from y el to de cada transferencia y en cada cambio de saldo: las etiquetas de perfil KOL, bot, plataforma, desarrollador, pool o SNS de la wallet, como en las salas de trades, o null si la wallet no tiene. El marketCap.usd de SOL es su precio por el suministro circulante; USDC, USDT y USD1 no tienen. El mensaje enriquecido puede llegar hasta 250 ms después del normal; si una consulta tardó más, lleva enrichmentStatus: "partial" y null en lo que falte.

const wallet = "GachaNgyXTU3zFogQ8Z5jR2BLXs8215X2AtEH18VxJq3";
const ws = new WebSocket("wss://datastream.solanatracker.io/YOUR_API_KEY");

ws.addEventListener("open", () => {
  ws.send(JSON.stringify({ type: "join", room: `transfer:wallet:${wallet}:enriched` }));
});

ws.addEventListener("message", (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === "ping") return ws.send(JSON.stringify({ type: "pong" }));
  if (msg.type !== "message") return;

  for (const t of msg.data.transfers) {
    console.log(t.direction, t.uiAmount, t.token.symbol, t.value.usd, msg.data.signature);
  }
});

Suscribirse con el SDK

El SDK gestiona los heartbeats y las reconexiones. transfers.wallet, transfers.token y transfers.tokenWallet se unen a las tres salas; usa { enriched: true } para la sala :enriched. transfers.token lanza un error para SOL: usa transfers.wallet, o transfers.tokenWallet con el mint de wrapped SOL.

import { Datastream } from '@solana-tracker/data-api';

const stream = new Datastream({
  wsUrl: 'wss://datastream.solanatracker.io/YOUR_API_KEY',
});
stream.on('error', console.error);
await stream.connect();

const sub = stream.subscribe.transfers
  .wallet('GachaNgyXTU3zFogQ8Z5jR2BLXs8215X2AtEH18VxJq3', { enriched: true })
  .on((update) => {
    for (const t of update.transfers) {
      console.log(t.direction, t.uiAmount, t.token.symbol, t.value.usd, t.from.identity?.name ?? t.from.owner);
    }
    // Algunos precios o identidades no llegaron a tiempo y son null.
    if (update.enrichmentStatus === 'partial') console.log(update.signature);
  });

// sub.unsubscribe();
// stream.disconnect();

Leer un mensaje

Cada mensaje es una transacción:

{
  "type": "message",
  "room": "transfer:wallet:5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
  "data": {
    "signature": "3sGWwELDWpxMaTWkadG95XK3mYiY2TZw8X6VVG7eZopJ8hGvWt4s2A6KK7ZZMVN7Qujg4WtJcm8dXmwvfnyhZ4NS",
    "slot": 462944056,
    "timestamp": 1793290384,
    "commitment": "processed",
    "swapTx": false,
    "transfers": [
      {
        "id": "3sGWwELDWpxMaTWkadG95XK3mYiY2TZw8X6VVG7eZopJ8hGvWt4s2A6KK7ZZMVN7Qujg4WtJcm8dXmwvfnyhZ4NS:3:-1",
        "signature": "3sGWwELDWpxMaTWkadG95XK3mYiY2TZw8X6VVG7eZopJ8hGvWt4s2A6KK7ZZMVN7Qujg4WtJcm8dXmwvfnyhZ4NS",
        "slot": 462944056,
        "timestamp": 1793290384,
        "commitment": "processed",
        "instruction": 3,
        "inner": -1,
        "type": "spl",
        "program": "token-2022",
        "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
        "decimals": 6,
        "amount": "18404223000000",
        "uiAmount": "18404223",
        "from": {
          "address": "CEbJzsx15hLQkHD6Tsp5vk58rcnMtvbgLReGLzjiy4uH",
          "owner": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
          "postBalance": "1151345685569531"
        },
        "to": {
          "address": "F5zXibinJCcNKY8BJhYC6iX5sKCKkaaSFV3MJgbVz25M",
          "owner": "G56HkiSheuhfjnTPGjGC1nNddu7NBtTqedueYKCrEHW2",
          "postBalance": "18404223000000"
        },
        "swapTx": false,
        "direction": "out"
      }
    ],
    "balances": [
      {
        "owner": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
        "account": "CEbJzsx15hLQkHD6Tsp5vk58rcnMtvbgLReGLzjiy4uH",
        "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
        "program": "token-2022",
        "decimals": 6,
        "pre": "1169749908569531",
        "post": "1151345685569531",
        "change": "-18404223000000",
        "cause": "transfer"
      },
      {
        "owner": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
        "account": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
        "mint": "So11111111111111111111111111111111111111112",
        "program": "system",
        "decimals": 9,
        "pre": "1029258892726041",
        "post": "1029258892711041",
        "change": "-15000",
        "cause": "other",
        "fee": "15000"
      }
    ]
  }
}

transfers son las transferencias de la sala en orden de instrucción. id es signature:instruction:inner y es único por transferencia. direction aparece en las salas de wallet. Las transferencias de Token-2022 con comisión de transferencia incluyen fee, y amount es la cantidad antes de la comisión.
balances son los cambios de saldo de la sala en esa transacción: los de la wallet, los del token, o los de la wallet para ese token. cause es transfer, swap (los tokens negociados por el trader) u other. La entrada de SOL del pagador de la comisión tiene fee, que está incluida en change.
Los swaps se quedan en las salas de trades. Una transferencia que forma parte de un swap ya emitido no se vuelve a enviar. Lo que queda de un swap, como comisiones de plataforma, propinas o pagos a otras wallets, llega con swapTx: true.
No son transferencias: wraps, unwraps y movimientos entre cuentas de la misma wallet. Las transacciones fallidas no se emiten.

En una sala :enriched, el mismo mensaje también incluye token, price, value, marketCap e identity. En este, un KOL vendió un token por SOL; la comisión en SOL pagada a otra wallet es lo que queda del swap, así que llega con swapTx: true.

Ejemplo de mensaje enriquecido

{
  "type": "message",
  "room": "transfer:wallet:ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph:enriched",
  "data": {
    "signature": "3og3m2Rtw2L6P9Zv98J1ZhwGtrKVfmyTzJBSWKf1mCLGDzNddSyceNqHvTvP5oAZ42FpoAkqmEEStT42XMBmXuJp",
    "slot": 463404942,
    "timestamp": 1793388931,
    "commitment": "processed",
    "swapTx": true,
    "transfers": [
      {
        "id": "3og3m2Rtw2L6P9Zv98J1ZhwGtrKVfmyTzJBSWKf1mCLGDzNddSyceNqHvTvP5oAZ42FpoAkqmEEStT42XMBmXuJp:1:-1",
        "signature": "3og3m2Rtw2L6P9Zv98J1ZhwGtrKVfmyTzJBSWKf1mCLGDzNddSyceNqHvTvP5oAZ42FpoAkqmEEStT42XMBmXuJp",
        "slot": 463404942,
        "timestamp": 1793388931,
        "commitment": "processed",
        "instruction": 1,
        "inner": -1,
        "type": "sol",
        "program": "system",
        "mint": "So11111111111111111111111111111111111111112",
        "decimals": 9,
        "amount": "1984300",
        "uiAmount": "0.0019843",
        "from": {
          "address": "ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
          "owner": "ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
          "postBalance": "89633841158",
          "identity": {
            "name": "Ducky",
            "twitter": "@zXDuckyXz",
            "avatar": "https://kol-avatar.solanatracker.io/ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
            "platforms": [
              "axiom"
            ],
            "type": "kol",
            "tags": [
              "kol",
              "axiom"
            ]
          }
        },
        "to": {
          "address": "8GV86MhDQST6rh56oTMU9v5TdHwRtXnFQ3zdGD3WT3mG",
          "owner": "8GV86MhDQST6rh56oTMU9v5TdHwRtXnFQ3zdGD3WT3mG",
          "postBalance": "43378482944",
          "identity": null
        },
        "swapTx": true,
        "token": {
          "mint": "So11111111111111111111111111111111111111112",
          "name": "Solana",
          "symbol": "SOL",
          "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "decimals": 9
        },
        "price": {
          "usd": 94.23572271990248
        },
        "value": {
          "usd": 0.19
        },
        "marketCap": {
          "usd": 55602827082.74623
        },
        "direction": "out"
      }
    ],
    "balances": [
      {
        "owner": "ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
        "account": "CMkGUwGS7a7qxNKVUv2UwMoy92Awj9DbUNXcLy1ZbXxZ",
        "mint": "6AyZsNDJctD1T1hmqPsZWGGSuWM7feNEUbph5SeLpump",
        "program": "token-2022",
        "decimals": 6,
        "pre": "26109484455083",
        "post": "0",
        "change": "-26109484455083",
        "cause": "swap",
        "identity": {
          "name": "Ducky",
          "twitter": "@zXDuckyXz",
          "avatar": "https://kol-avatar.solanatracker.io/ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
          "platforms": [
            "axiom"
          ],
          "type": "kol",
          "tags": [
            "kol",
            "axiom"
          ]
        },
        "token": {
          "mint": "6AyZsNDJctD1T1hmqPsZWGGSuWM7feNEUbph5SeLpump",
          "name": "The Chill Penguin",
          "symbol": "Penguin",
          "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Faxiomtrading-v2.axiom-cdn.io%2FCKUym5DFePEDCGA8VTVxZcNEpveHgb71JzhXGRqypump.webp",
          "decimals": 6
        },
        "price": {
          "usd": 0.000003898241016375787
        },
        "value": {
          "usd": -101.78
        },
        "marketCap": {
          "usd": 3898.241016375787
        }
      },
      {
        "owner": "ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
        "account": "ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
        "mint": "So11111111111111111111111111111111111111112",
        "program": "system",
        "decimals": 9,
        "pre": "88473075092",
        "post": "89633841158",
        "change": "1160766066",
        "cause": "swap",
        "fee": "20700",
        "identity": {
          "name": "Ducky",
          "twitter": "@zXDuckyXz",
          "avatar": "https://kol-avatar.solanatracker.io/ADC1QV9raLnGGDbnWdnsxazeZ4Tsiho4vrWadYswA2ph",
          "platforms": [
            "axiom"
          ],
          "type": "kol",
          "tags": [
            "kol",
            "axiom"
          ]
        },
        "token": {
          "mint": "So11111111111111111111111111111111111111112",
          "name": "Solana",
          "symbol": "SOL",
          "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "decimals": 9
        },
        "price": {
          "usd": 94.23572271990248
        },
        "value": {
          "usd": 109.39
        },
        "marketCap": {
          "usd": 55602827082.74623
        }
      }
    ]
  }
}

Las transferencias en vivo se envían con compromiso processed. Una transacción puede descartarse en un fork y no hay mensaje de rollback, así que reconcilia con el endpoint REST. Si te unes a salas superpuestas, recibirás la misma transferencia una vez por sala.

Primeros pasos

Datos de tokens

Wallets y PnL

Datos en vivo

Pump.fun

Mercados de predicción

Swaps y RPC

Seguir transferencias de wallets y tokens en Solana

Consultar el historial

Recibir transferencias en vivo

Consultar el historial de transferencias

Filtrar el historial

Qué cuenta como actividad DEX

Agrupar por transacción

Paginar los resultados

Usar el SDK de TypeScript

Recibir transferencias en vivo

Elegir una sala

Suscribirse con el SDK

Leer un mensaje

Siguientes pasos

Referencia de transferencias de cuenta

Protocolo de Datastream

Consultar el historial

Recibir transferencias en vivo

​Consultar el historial de transferencias

​Filtrar el historial

​Qué cuenta como actividad DEX

​Agrupar por transacción

​Paginar los resultados

​Usar el SDK de TypeScript

​Recibir transferencias en vivo

​Elegir una sala

​Suscribirse con el SDK

​Leer un mensaje

​Siguientes pasos

Referencia de transferencias de cuenta

Protocolo de Datastream

Consultar el historial de transferencias

Filtrar el historial

Qué cuenta como actividad DEX

Agrupar por transacción

Paginar los resultados

Usar el SDK de TypeScript

Recibir transferencias en vivo

Elegir una sala

Suscribirse con el SDK

Leer un mensaje

Siguientes pasos