ChainstreamInstall

Summary

Retrieve holder addresses and quantities for a specified token on a specified chain.

Inputs

• authentication (required) — Authentication method for the Chainstream API. Currently only 'API Key' is supported.
• chain — Choose from the list, or specify an ID using an expression. Determines the blockchain network for the token lookup.
• tokenAddress (required) — Choose from the list, or specify an ID using an expression. The contract address of the token.

Output shape

JSON array of holder objects containing address and amount fields, returned as n8n execution metadata items.

The Chainstream API endpoint GET token/{chainId}/{tokenAddress}/holders is called. The chain name is resolved to a chain ID internally (e.g., 'solana' maps to 'sol'). No additional query parameters are required for this operation.

Examples

Example 1: Fetch holders for an ERC-20 token on Ethereum

Set Resource to 'Token', Operation to 'Holders', Chain to 'Ethereum', Token Address to the token contract address, and Authentication to 'API Key'.