Blockchain Explorer icon

Blockchain Explorer

Interact with multiple blockchain networks via their explorer APIs (Etherscan-compatible)
Join our community

Actions22

Overview

This node interacts with multiple blockchain networks through their explorer APIs that are compatible with Etherscan. Specifically, for the Account resource and the Get NFT Transfers operation, it retrieves a list of NFT token transfer events associated with a specified blockchain address.

This functionality is useful when you want to track NFT activity for an account, such as monitoring incoming or outgoing NFT transfers on various supported blockchains like Ethereum, Polygon, Binance Smart Chain, etc.

Practical examples:

  • Tracking all NFT transfers for a wallet address on Ethereum to monitor NFT purchases or sales.
  • Auditing NFT movements on Polygon for a given user.
  • Integrating NFT transfer data into dashboards or alerts for NFT collectors or marketplaces.

Properties

Name Meaning
Network The blockchain network to query. Options: Arbitrum, Avalanche, Binance Smart Chain, Celo, Cronos, Ethereum, Fantom, Moonbeam, Optimism, Polygon. Default is Ethereum.
Address The blockchain address to query for NFT transfers (required).
Start Block Starting block number to begin the search from (default "0" means earliest block).
End Block Ending block number to end the search at (default "99999999" means latest block).
Page Page number for pagination of results (default 1).
Offset Number of transactions to return per page, maximum 10,000 (default 10).
Sort Sort order of results by block number. Options: Ascending, Descending (default Ascending).

Output

The output JSON contains the following fields:

  • network: The blockchain network queried.
  • resource: Always "account" for this operation.
  • operation: Always "getTokenNftTx" for this operation.
  • Other fields returned by the blockchain explorer API, typically including:
    • A status code indicating success or failure.
    • A message describing the result.
    • A result array containing NFT transfer event objects, each detailing information such as transaction hash, block number, timestamp, from/to addresses, token ID, contract address, and other relevant NFT transfer details.

The node outputs one item per input, pairing the response with the corresponding input index.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for the blockchain explorer service compatible with Etherscan APIs.
  • Supports multiple blockchain networks; the base URL for API requests depends on the selected network and environment.
  • Uses the Axios HTTP client internally to make API requests.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication errors.
    • Querying an invalid or incorrectly formatted blockchain address may result in API errors.
    • Requesting too many records (offset > 10000) might be rejected by the API.
    • Network selection mismatch or unsupported network could lead to failed requests.

  • Error messages:

    • "API Error: <message>" indicates the blockchain explorer API returned an error. Check the message for details such as rate limits, invalid parameters, or server issues.
    • If the node throws errors related to missing parameters, ensure all required properties (like Address) are correctly set.

  • Resolution tips:

    • Verify the API key is valid and has sufficient permissions.
    • Double-check the blockchain address format.
    • Adjust pagination parameters to reduce the number of records requested.
    • Confirm the selected network supports the NFT transfer query.

Links and References

Discussion