Track Token Transfers

Track SPL token transfers to build token analytics, monitor wallet activity, or analyze token flow patterns.

Use Case

Token transfer tracking enables you to:

Build token transfer analytics and volume trackers
Monitor wallet token activity
Analyze transfer patterns
Track token mints and burns

Code Example

curl --compressed -X POST "https://portal.sqd.dev/datasets/solana-mainnet/stream" \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "solana",
    "fromBlock": 280000000,
    "toBlock": 280000003,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true
      },
      "tokenBalance": {
        "account": true,
        "preMint": true,
        "postMint": true,
        "preAmount": true,
        "postAmount": true,
        "preOwner": true,
        "postOwner": true
      }
    },
    "tokenBalances": [{
      "preMint": ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]
    }]
  }'

import { DataSource } from "@subsquid/portal-client";

const dataSource = new DataSource({
  network: "solana-mainnet",
});

// USDC mint address
const USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";

const blocks = await dataSource.getBlocks({
  from: 280000000,
  to: 280000003,
  fields: {
    block: { number: true, timestamp: true },
    tokenBalance: {
      account: true,
      preMint: true,
      postMint: true,
      preAmount: true,
      postAmount: true,
      preOwner: true,
      postOwner: true,
    },
  },
  tokenBalances: [
    {
      preMint: [USDC_MINT],
    },
  ],
});

// Process token transfers
for (const block of blocks) {
  for (const balance of block.tokenBalances) {
    if (balance.preAmount !== balance.postAmount) {
      const amount = BigInt(balance.postAmount) - BigInt(balance.preAmount);
      console.log({
        slot: block.header.number,
        timestamp: block.header.timestamp,
        account: balance.account,
        mint: balance.postMint,
        from: balance.preOwner,
        to: balance.postOwner,
        amount: amount.toString(),
      });
    }
  }
}

import requests
import json

url = "https://portal.sqd.dev/datasets/solana-mainnet/stream"
headers = {"Content-Type": "application/json"}

# USDC mint address
usdc_mint = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

payload = {
    "type": "solana",
    "fromBlock": 280000000,
    "toBlock": 280000003,
    "fields": {
        "block": {
            "number": True,
            "timestamp": True
        },
        "tokenBalance": {
            "account": True,
            "preMint": True,
            "postMint": True,
            "preAmount": True,
            "postAmount": True,
            "preOwner": True,
            "postOwner": True
        }
    },
    "tokenBalances": [{
        "preMint": [usdc_mint]
    }]
}

response = requests.post(url, headers=headers, json=payload)

for line in response.text.strip().split('\n'):
    block = json.loads(line)
    for balance in block.get('tokenBalances', []):
        if balance['preAmount'] != balance['postAmount']:
            amount = int(balance['postAmount']) - int(balance['preAmount'])
            print({
                "slot": block['header']['number'],
                "timestamp": block['header']['timestamp'],
                "account": balance['account'],
                "mint": balance['postMint'],
                "from": balance['preOwner'],
                "to": balance['postOwner'],
                "amount": amount
            })

Try it yourself with the interactive query interface below:

Key Parameters

Parameter	Description
`preMint`	Token mint address before the transaction
`postMint`	Token mint address after the transaction
`preAmount`	Token balance before the transaction
`postAmount`	Token balance after the transaction
`preOwner`	Token account owner before the transaction
`postOwner`	Token account owner after the transaction
`account`	Token account address

Expected Output

{
  "header": {
    "number": 259985000,
    "timestamp": 1697544779
  },
  "tokenBalances": [
    {
      "account": "TokenAccountAddress...",
      "preMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "postMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "preAmount": "1000000",
      "postAmount": "2000000",
      "preOwner": "SenderAddress...",
      "postOwner": "RecipientAddress..."
    }
  ]
}

Track Specific Token Account

Monitor transfers for a specific token account:

curl --compressed -X POST "https://portal.sqd.dev/datasets/solana-mainnet/stream" \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "solana",
    "fromBlock": 280000000,
    "toBlock": 280000003,
    "fields": {
      "tokenBalance": {
        "account": true,
        "preAmount": true,
        "postAmount": true
      }
    },
    "tokenBalances": [{
      "account": ["SpecificTokenAccountAddress"]
    }]
  }'

const blocks = await dataSource.getBlocks({
  from: 280000000,
  to: 280000003,
  fields: {
    tokenBalance: { account: true, preAmount: true, postAmount: true },
  },
  tokenBalances: [
    {
      account: ["SpecificTokenAccountAddress"],
    },
  ],
});

payload = {
    "type": "solana",
    "fromBlock": 280000000,
    "toBlock": 280000003,
    "fields": {
        "tokenBalance": {
            "account": True,
            "preAmount": True,
            "postAmount": True
        }
    },
    "tokenBalances": [{
        "account": ["SpecificTokenAccountAddress"]
    }]
}

Performance Tips

Filter by mint: Query specific tokens instead of all transfers
Use slot ranges: Process data in 10k-50k slot batches
Request minimal fields: Only request fields you need
Filter by account: Monitor specific token accounts

Query Instructions

Track program instructions

DEX Swaps

Track DEX trading activity

Query Transactions

Monitor wallet activity

API Reference

View complete API docs

Overview

Portal API reference

Working with Portal API

Other data

Networks

Use Case

Code Example

Key Parameters

Expected Output

Track Specific Token Account

Performance Tips

Query Instructions

DEX Swaps

Query Transactions

API Reference

​Use Case

​Code Example

​Key Parameters

​Expected Output

​Track Specific Token Account

​Performance Tips

​Related Examples

Query Instructions

DEX Swaps

Query Transactions

API Reference

Use Case

Code Example

Key Parameters

Expected Output

Track Specific Token Account

Performance Tips

Related Examples