Track Solana wallet and token transfers

Load a wallet’s transfer history with one REST call, then join a transfer room to receive new transfers as they happen. Both cover native SOL, SPL tokens and Token-2022 tokens.

Query transfer history

Filter by token, counterparty, time, amount or USD value.

Stream transfers live

Follow a wallet, a token, or one token for one wallet.

Query transfer history

GET /account/{address}/transfers returns transfers in and out of a wallet, newest first. SPL transfers are matched through the token accounts the wallet owns, and each side shows both the token account (address) and the wallet that owns it (owner). By default the history leaves out transactions with DEX activity, such as swaps, liquidity adds and removes, and pool fee claims, so you get the wallet’s plain transfers. Set dex=include to keep them or dex=only to get just those.

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);

Each transfer looks like this:

{
  "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 is the raw integer amount and uiAmount the exact decimal amount, both as strings.
timestamp is the block time in Unix seconds.
type is sol for native SOL and spl for token transfers. SOL uses the wrapped SOL mint So11111111111111111111111111111111111111112.
status is the transaction’s outcome, success or failed. Failed transactions are left out unless you ask for status=failed or status=any.
price and value are only there with historicPrices=true or a value filter.
identity appears on from or to when the wallet is known: a KOL, an exchange, a pool, a developer, or an SNS name.

Filter the history

Filter	Parameters
Token	`mint`, `type=sol\|spl`
Direction	`direction=in\|out\|all`
Sender, receiver	`from`, `to`, `counterparty` (either side), `excludeFrom`, `excludeTo` (up to 5 comma-separated addresses each, wallet or token account)
Time	`start`, `end` (inclusive), in Unix seconds
Slot	`startSlot`, `endSlot` (inclusive)
Amount	`minAmount`, `maxAmount` in token units, `excludeZero=true`
USD value	`minValue`, `maxValue` (turns on `historicPrices`; `limit` at most 100)
DEX activity	`dex=exclude\|include\|only` (default `exclude`)
Outcome	`status=success\|failed\|any` (default `success`)
Order	`sortOrder=desc\|asc`

Each parameter has one name. A name the endpoint doesn’t know is a 400 that tells you the right one, for example unknown parameter timeStart; use start, so a typo never returns an unfiltered page. historicPrices=true adds price.usd and value.usd with the token’s USD price at the time of the transfer, from the last 1-minute candle at most an hour before it. Without a price they are null.

What counts as DEX activity

A transaction has DEX activity when one of its transfers goes to or comes from a pool: an account a DEX or launchpad program owns, such as a pump.fun bonding curve or a Meteora DLMM pool, or a Raydium or Meteora vault authority. That covers swaps, liquidity adds and removes, and fee and reward claims. A transaction where the wallet sent one token and received another counts too. dex=exclude and dex=only act on whole transactions: every transfer of the transaction is left out or kept together. Only the transfers that match direction and mint are looked at, so with those set, a transaction whose pool leg is filtered out counts as a plain transfer.

Group by transaction

Add grouped=true to also get transactions, the page’s transfers grouped by signature. Each transaction has its transfers, the number of them in legs, totals.in, totals.out and totals.tokens, and dex. type is swap when dex is true, and swap names the token in and the token out when the wallet sent one token and received another. With historicPrices=true, the totals also carry USD: totals.value, totals.net, and usd on each side.

Page through results

Pass pagination.next back as cursor with the same filters, and stop when hasMore is false. A page never splits a transaction, so it can hold a few transfers more or fewer than limit; with grouped=true, limit usually counts transactions. Filtered requests read a bounded number of transfers per call, so a page can hold fewer than limit rows, or none, while hasMore is still true. Keep paging. With minValue or maxValue, each page prices the next limit transfers and returns those that match. If prices can’t be read in time, the request returns 503; send it again.

Use the TypeScript SDK

Install @solana-tracker/data-api version 0.6.0 or later. getAccountTransfers takes the same filters as the endpoint, and the address filters accept an array or a comma-separated string. The SDK checks them with the API’s rules and throws a ValidationError before sending a request the API would refuse. iterateAccountTransfers follows pagination.next for you and keeps going past empty filtered pages.

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

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

// Every page of USDC received, with the USD value at the time.
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);
  }
}

// One entry per transaction, swaps included.
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);
}

With { grouped: true }, TypeScript knows the response has transactions.

Stream transfers live

Connect to wss://datastream.solanatracker.io/{apiKey} with your Data API key. Datastream is available on Premium, Business, and Enterprise plans.

Choose a room

transfer:wallet:{wallet}: every transfer to or from a wallet, across all tokens.
transfer:{mint}: every transfer of a token. Not available for SOL.
transfer:{mint}:{wallet}: one token to or from one wallet. Works for SOL with the wrapped SOL mint.

Append :enriched to any room to add token (name, symbol, image, decimals), price.usd, value.usd and marketCap.usd to every transfer and balance change, and identity to each transfer’s from and to and each balance change: the wallet’s KOL profile, bot, platform, developer, pool or SNS labels, as in the trade rooms, or null for a wallet with none. SOL’s marketCap.usd is its price times the circulating supply; USDC, USDT and USD1 have none. The enriched message can arrive up to 250 ms after the plain one; if a lookup took longer, it has enrichmentStatus: "partial" and null for what is missing.

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);
  }
});

The SDK handles heartbeats and reconnects. transfers.wallet, transfers.token and transfers.tokenWallet join the three rooms; set { enriched: true } for the :enriched room. transfers.token throws for SOL: use transfers.wallet, or transfers.tokenWallet with the wrapped SOL mint.

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);
    }
    // Some prices or identities timed out and are null.
    if (update.enrichmentStatus === 'partial') console.log(update.signature);
  });

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

Read a message

Each message is one transaction:

{
  "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 are the room’s transfers in instruction order. id is signature:instruction:inner and unique per transfer. direction is set in wallet rooms. Token-2022 transfers with a transfer fee carry fee, and amount is before the fee.
balances are the room’s balance changes in that transaction: the wallet’s, the token’s, or the wallet’s for that token. cause is transfer, swap (the trader’s traded tokens), or other. The fee payer’s SOL entry has fee, which is included in change.
Swaps stay in the trade rooms. A transfer that is a leg of a swap already streamed is not sent again. What remains of a swap, such as platform fees, tips or payouts to other wallets, arrives with swapTx: true.
Not transfers: wraps, unwraps and moves between a wallet’s own accounts. Failed transactions are not streamed.

In an :enriched room the same message also carries token, price, value, marketCap and identity. In this one, a KOL sold a token for SOL; the SOL fee paid to another wallet is what remains of the swap, so it arrives with swapTx: true.

Enriched message example

{
  "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
        }
      }
    ]
  }
}

Live transfers are sent at processed commitment. A transaction can be dropped on a fork, and there is no rollback message, so reconcile with the REST endpoint. Joining overlapping rooms delivers the same transfer once per room.

Account transfers reference

Every parameter and response field.

Datastream protocol

Connect, join rooms, and handle heartbeats.

Start here

Token data

Wallets and PnL

Live data

Pump.fun

Prediction markets

Trading and RPC

Track Solana wallet and token transfers

Query transfer history

Stream transfers live

Query transfer history

Filter the history

What counts as DEX activity

Group by transaction

Page through results

Use the TypeScript SDK

Stream transfers live

Choose a room

Read a message

Next

Account transfers reference

Datastream protocol

Query transfer history

Stream transfers live

​Query transfer history

​Filter the history

​What counts as DEX activity

​Group by transaction

​Page through results

​Use the TypeScript SDK

​Stream transfers live

​Choose a room

​Subscribe with the SDK

​Read a message

​Next

Account transfers reference

Datastream protocol

Query transfer history

Filter the history

What counts as DEX activity

Group by transaction

Page through results

Use the TypeScript SDK

Stream transfers live

Choose a room

Subscribe with the SDK

Read a message

Next