Console

POSTGet Token Transfers By MintAddress

Data APIhttps://web3.nodit.io/v1/solana/mainnet/token/getTokenTransfersByMintAddress

Retrieves the list of transfers of a specific token based on its MintAddress. Enter So11111111111111111111111111111111111111111 as mintAddress to query transfers of the native token (SOL). The MintAddress of Wrapped SOL is So11111111111111111111111111111111111111112.

Path Parameters
chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

Request Body
mintAddressstringrequired

Parameter specifying the MintAddress of the token to query. The MintAddress must be entered as a 32–44 character Base58-encoded string.

fromSlotstring

Parameter specifying the start point of the query. You can enter one of the following formats:

  • slot height: Enter the slot number as a decimal string.
  • slot tag: Use "earliest" to specify the first slot.

If none of the range parameters (fromSlot, toSlot, fromDate, toDate) are specified, data from the last 30 days is returned. To query the full history, set fromSlot to "earliest".

Notes:

  • This field cannot be used together with fromDate and toDate.
  • If only fromSlot is provided without toSlot, results are queried from that slot to the latest slot.
  • toSlot value cannot be less than fromSlot value.
  • If fromSlot and toSlot have the same value, only that slot is queried.
  • "latest" cannot be entered for fromSlot.
toSlotstring

Parameter specifying the end point of the query. You can enter one of the following formats:

  • slot height: Enter the slot number as a decimal string.
  • slot tag: Use "latest" to specify the latest slot.

If none of the range parameters (fromSlot, toSlot, fromDate, toDate) are specified, data from the last 30 days is returned. To query the full history, set fromSlot to "earliest".

Notes:

  • This field cannot be used together with fromDate and toDate.
  • If only toSlot is provided without fromSlot, results are queried from the first stored slot to that slot.
  • toSlot value cannot be less than fromSlot value.
  • If fromSlot and toSlot have the same value, only that slot is queried.
  • "earliest" cannot be entered for toSlot.
fromDatestring

Parameter specifying the start date of the query. The date must follow the ISO 8601 format (YYYY-MM-DDThh:mm:ss{time zone}) and include seconds.

If none of the range parameters (fromSlot, toSlot, fromDate, toDate) are specified, data from the last 30 days is returned.

Notes:

  • This field cannot be used together with fromSlot and toSlot.
  • If only fromDate is provided without toDate, results are queried from that date to the latest slot.
  • fromDate must be equal to or earlier than toDate.
toDatestring

Parameter specifying the end date of the query. The date must follow the ISO 8601 format (YYYY-MM-DDThh:mm:ss{time zone}) and include seconds.

If none of the range parameters (fromSlot, toSlot, fromDate, toDate) are specified, data from the last 30 days is returned.

Notes:

  • This field cannot be used together with fromSlot and toSlot.
  • If only toDate is provided without fromDate, results are queried from the first stored slot to that date.
  • toDate must be equal to or later than fromDate.
pageinteger

The page parameter specifies the data page to query. It accepts values up to 100; for pages exceeding 100, use the cursor pagination method.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

rppinteger

rpp stands for results per page and specifies the page size. You can specify a number greater than 0 and up to 100.

cursorstring

The cursor parameter supports pagination and data navigation between pages. Provide the cursor value from the previous page in the next request to load the next page of data.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

withCountboolean

Parameter specifying whether to include the count field in the response. The count field indicates the total number of requested data items. When set to true, the count field is included and response speed may be slower.

withZeroValueboolean

Parameter specifying whether to include results with value 0 in the response. Set to true for faster responses.

Responses
pageinteger

Field representing the page number specified in the page parameter. This field is only included in the response when a value greater than 0 is specified for the page parameter.

rppinteger

Field representing the number of results per page specified in the rpp parameter.

cursorstring

A field for cursor pagination. This value must be provided in the next request to load the next page of data.

countinteger

Field representing the total count of requested data. This field is only included in the response when true is set for the withCount parameter.

fromDatestring

A field representing the start of the query in date mode. Returned in ISO 8601 format.

Example: 2026-09-29T09:40:23.000Z

toDatestring

A field representing the end of the query in date mode. Returned in ISO 8601 format.

Example: 2026-10-29T09:40:21.000Z

fromSlotinteger

A field representing the start slot number of the query in slot mode.

Example: 462000000

toSlotinteger

A field representing the end slot number of the query in slot mode.

Example: 462833902

slotHeightintegerrequired

A field representing the slot number in which the token transfer is included.

Example: 235157119

blockHeightintegerrequired

A field representing the block height to which the slot is mapped.

Example: 214567890

blockTimestampintegerrequired

A field representing the time the block (slot) was created, as a Unix timestamp (seconds).

Example: 1746479684

transactionSignaturestringrequired

A field representing the signature of the transaction in which the token transfer occurred. It is Base58-encoded.

Example: 5XXN7L7cMGYTvckcaNeTXxhJgxeT1JTa9auwa2yXCFR1NXzwXrXNAWx4SaAw48S5186VzvXiXVEsWJu1WFR5AAmg

transactionIndexintegerrequired

A field representing the order of the transaction within the same slot.

Example: 7

instructionIndexintegerrequired

A field representing the index of the top-level instruction within the transaction. (0-based)

Example: 2

subInstructionIndexintegerrequired

A field representing the index of the inner (sub) instruction that occurred via CPI, etc. It is 0 for a top-level instruction. (0-based)

Example: 0

batchIndexinteger

Field indicating the order of an individual transfer executed within a P-token batch instruction. Included only for transfers executed by a P-token batch instruction. (0-based)

Example: 0

programIdstringrequired

A field representing the ID of the SPL Token program that executed the transfer. It is Base58-encoded.

Example: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA

instructionTypestringrequired

A field representing the type of the token program instruction. This API returns only the types that correspond to token movements. (e.g. transfer, transferChecked)

Example: transfer

mintAddressstringrequired

A field representing the MintAddress of the transferred SPL token. For SOL, "So11111111111111111111111111111111111111111" is returned.

Example: So11111111111111111111111111111111111111112

fromstringrequired

A field representing the sender's (owner) wallet address. It is the owner of fromTokenAccount.

Example: 9vNYXEehFV8V1jxzjH7Sv3BBtsYZ92HPKYP1stgNGHJE

fromTokenAccountstringrequired

A field representing the address of the sending Token Account from which the actual token balance was deducted. For SOL, an empty string ("") is returned.

Example: 7YttLkHDoNj9wyDur5pM1ejNaAvT9X4e3n9mQqZp8y8o

tostringrequired

A field representing the recipient's (owner) wallet address. It is the owner of toTokenAccount.

Example: HUNMbn6FnUDoFmrATKUkq3GjSRjWX4ytkX4nvP7XNYfH

toTokenAccountstringrequired

A field representing the address of the receiving Token Account whose actual token balance increased. For SOL, an empty string ("") is returned.

Example: 9qkU8bqgYwR3c6qS9m4X2C1xL7oQ7kL8U7s7o7h7j7k7

valuestringrequired

A field representing the amount of the transferred token as a raw integer string. The actual amount is calculated as value / 10^decimals.

Example: 100000

decimalsintegerrequired

A field representing the number of decimal places of the token.

Example: 6

X-API-KEY
RequestCU150
cURL
curl -X POST "https://web3.nodit.io/v1/solana/mainnet/token/getTokenTransfersByMintAddress" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "mintAddress": "So11111111111111111111111111111111111111112",
    "withCount": false,
    "withZeroValue": false
  }'
Response
Example · 200
{
  "page": 0,
  "rpp": 0,
  "cursor": "string",
  "count": 0,
  "range": {
    "fromDate": "2026-09-29T09:40:23.000Z",
    "toDate": "2026-10-29T09:40:21.000Z"
  },
  "items": [
    {
      "slotHeight": 235157119,
      "blockHeight": 214567890,
      "blockTimestamp": 1746479684,
      "transactionSignature": "5XXN7L7cMGYTvckcaNeTXxhJgxeT1JTa9auwa2yXCFR1NXzwXrXNAWx4SaAw48S5186VzvXiXVEsWJu1WFR5AAmg",
      "transactionIndex": 7,
      "instructionIndex": 2,
      "subInstructionIndex": 0,
      "batchIndex": 0,
      "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "instructionType": "transfer",
      "mintAddress": "So11111111111111111111111111111111111111112",
      "from": "9vNYXEehFV8V1jxzjH7Sv3BBtsYZ92HPKYP1stgNGHJE",
      "fromTokenAccount": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4e3n9mQqZp8y8o",
      "to": "HUNMbn6FnUDoFmrATKUkq3GjSRjWX4ytkX4nvP7XNYfH",
      "toTokenAccount": "9qkU8bqgYwR3c6qS9m4X2C1xL7oQ7kL8U7s7o7h7j7k7",
      "value": "100000",
      "decimals": 6
    }
  ]
}

Last updated