Skip to main content

Transfers

The transfers API returns indexed SOL and SPL token transfer rows on Solana: amounts, counterparties, currency metadata, transaction pointers, block time, and program/instruction context where available. It is the reference surface for full historical movement data used in reporting, audit evidence, trading analytics, and compliance workflows. Below is a minimal query shape, then filter reference and field list.

Common use cases​

  • Accounting and tax reporting — Per-wallet inflows/outflows, period totals, and point-in-time balances (often via aggregates). See Solana transfers examples and aggregation.
  • Audit and assurance — Reproducible samples with signature, slot/height, and timestamps; optional bulk datasets for large populations. Examples: transfers examples, expressions.
  • Trading and research — Large transfers, funding paths, mint-level history, program-scoped activity. Examples.
  • Compliance and investigations — Source-of-funds style queries, multi-party aggregates, and Coinpath for multi-hop tracing.
  • Treasury and operations — Time-bounded extracts and multi-token views. Filtering options.
  • Data engineering — Pagination and aggregates in GraphQL; S3 / Parquet and other cloud delivery for warehouse loads. V1 vs V2 and cloud data, streaming product.
query ($network: SolanaNetwork!, $date: ISO8601DateTime, $height: Int) {
  solana(network: $network) {
    transfers(options: {limit: 10}, date: {is: $date}, height: {is: $height}) {
      block {
        height
        timestamp {
          time
        }
        hash
        previousBlockHash
      }
      transaction {
        signature
        accountsCount
        error
        fee
        feePayer
        innerInstructionsCount
        instructionsCount
        recentBlockHash
        success
        signer
      }
      sender {
        address
        mintAccount
        type
      }
      receiver {
        address
        mintAccount
        type
      }
      currency {
        symbol
        address
        tokenType
        tokenId
        name
        decimals
      }
      amount
      transferType
      instruction {
        callPath
        action {
          name
          type
        }
        externalAction {
          name
          type
        }
        external
        externalProgram {
          id
          name
          parsed
          parsedName
        }
        program {
          id
          name
          parsed
          parsedName
        }
      }
    }
  }
}
<!-- Parameters -->
{
  "network": "solana",
  "height": 209945815,
  "from": "2023-07-31",
  "till": "2023-08-07T23:59:59",
  "dateFormat": "%Y-%m-%d"
}
Filtering Transfers

amount

The amount of currency that was transferred.

transferType

The type of transfer. Some of the supported transfer types are create_account and transfer.

transactionIndex

The index of the transaction in the block.

tokenAccount

The token account that was transferred.

time

The timestamp of the transfer.

success

Whether the transfer was successful.

signer

The address of the signer of the transaction.

signature

The signature of the transaction.

senderType

The type of the sender account. The supported sender types are program, user, and unknown.

senderMintAddress

The mint address of the sender account.

senderAddress

The address of the sender account.

recentBlockHash

The hash of the most recent block that the transfer was included in.

receiverType

The type of the receiver account.

receiverMintAddress

The mint address of the receiver account.

receiverAddress

The address of the receiver account.

programId

The program ID of the program that was used to perform the transfer.

previousBlockHash

The hash of the previous block.

parsedType

The parsed type of the transfer.

parsedActionName

The parsed name of the action that was used to perform the transfer.

parsedProgramName

The parsed name of the program that was used to perform the transfer.

parsed

The parsed transfer object.

options

A set of options that can be used to filter the results.

limit The maximum number of transfers to return.

date The date of the transfers.

height

The height of the transfers.

feePayer

The address of the fee payer.

externalProgramId

The external program ID of the program that was used to perform the transfer.

externalParsedType

The parsed type of the external transfer.

externalParsedProgramName

The parsed name of the external program that was used to perform the transfer.

externalParsedActionName

The parsed name of the external action that was used to perform the transfer.

external

Whether the transfer was an external transfer.

date

The date of the transfers. The date should be in the format YYYY-MM-DD.

currency

The currency that was transferred.

callPath

The call path of the transfer.

externalParsed

The parsed external transfer object.

blockHash

The hash of the block that the transfer was included in.

any

A catch-all filter (OR Logic) that can be used to filter the results by any of the other fields.

Fields​

  • block

    The block that the transfer was included in.

    • height
      • The height of the block.
    • timestamp
      • The timestamp of the block.
    • hash
      • The hash of the block.
    • previousBlockHash
      • The hash of the previous block.

  • transaction

    The transaction that the transfer was part of.

    • signature
      • The signature of the transaction.
    • accountsCount
      • The number of accounts that were involved in the transaction.
    • error
      • Whether the transaction failed.
    • fee
      • The fee that was paid for the transaction.
    • feePayer
      • The address of the account that paid the fee.
    • innerInstructionsCount
      • The number of instructions that were included in the transaction.
    • instructionsCount
      • The total number of instructions that were included in the transaction, including the inner instructions.
    • recentBlockHash
      • The hash of the most recent block that the transaction was included in.
    • success
      • Whether the transaction was successful.
    • signer
      • The address of the signer of the transaction.

  • sender

    The address of the sender of the transfer.

    • address
      • The address of the sender account.
    • mintAccount
      • Whether the sender account is a mint account.
    • type
      • The type of the sender account.

  • receiver

    The address of the receiver of the transfer.

    • address
      • The address of the receiver account.
    • mintAccount
      • Whether the receiver account is a mint account.
    • type
      • The type of the receiver account.

  • currency

    The currency that was transferred.

    • symbol
      • The symbol of the currency.
    • address
      • The address of the token account that was transferred.
    • tokenType
      • The type of the token. The supported token types are SPL, Native, and Unknown.
    • tokenId
      • The token ID of the token that was transferred.
    • name
      • The name of the token.
    • decimals
      • The number of decimal places for the token.

  • amount

    The amount of currency that was transferred.

  • transferType

    The type of transfer. Some of the supported transfer types are mint, burn, and transfer.

  • instruction

    The instruction that was used to perform the transfer.

    • callPath
      • The call path of the instruction.
    • action
      • The action that was called.
    • externalAction
      • The external action that was called.
    • external
      • Whether the transfer was an external transfer.
    • externalProgram
      • The external program ID of the program that was used to perform the transfer.
    • name
      • The name of the action.
    • type
      • The type of the action.
    • program
      • The program ID of the program that was used to perform the transfer.