Catalogs
Query supported blockchains and tokens. The Catalogs API provides read-only access to chain configurations and token metadata across all networks supported by Multisender.
Overview
Every distribution starts with choosing the right chain and token. The Catalogs API lets you discover which blockchains Multisender supports, inspect chain-specific configurations (RPC endpoints, explorer URLs, native currency), and look up token details by address or symbol. All catalog methods are read-only and do not require write permissions on your API key.
Read-only access
All Catalogs methods are read-only. They work with any API key scope and do not modify project state.
Key Concepts
Chain
A supported blockchain network. Each chain has a unique numeric chainId (e.g. 1 for Ethereum, 137 for Polygon), native currency symbol, RPC and explorer URLs, and a testnet flag.
Token
An ERC-20 or native token on a supported chain. Token objects include the contract address, symbol, name, decimals, and optional logo URL. Native tokens (ETH, MATIC) use a zero address.
Chain ID
The unique numeric identifier for a blockchain (e.g. 1 = Ethereum, 10 = Optimism, 137 = Polygon, 8453 = Base, 42161 = Arbitrum, 11155111 = Sepolia testnet). Used across all Multisender APIs to specify the target network.
Quick Start
Common Workflows
Choose a chain for distribution
Discover which blockchains are available before creating a distribution.
1
getChains()
List all supported chains to find the target network
2
getChain()
Get chain configuration details (RPC URL, explorer, native currency)
Methods
sdk.catalogs.getChains()
Retrieve all supported blockchains. Returns the full chain configuration for every network Multisender supports, including name, native currency, RPC and block explorer URLs, and whether the chain is a testnet.
Parameters
No parameters
Returns
Chain[]
Array of all supported blockchain configurations. Each Chain includes id, chainId, name, symbol, rpcUrl, explorerUrl, and isTestnet.
Example
Notes
Chain objects include: id, chainId, name, symbol, rpcUrl, explorerUrl, isTestnet
The response is not paginated — all chains are returned in a single array
See Also
getChain()
Get details for a specific chain by ID
distribute()
Use chainId from getChains to create a distribution
sdk.catalogs.getChain(chainId)
Retrieve the configuration for a specific blockchain by its chain ID. Use this to get RPC URL, block explorer URL, native currency symbol, and testnet status for a given network.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
chainId | string | Yes | The blockchain chain ID (e.g. "1" for Ethereum, "56" for BNB Chain, "137" for Polygon) |
Returns
Chain
Chain configuration object with id, chainId, name, symbol, rpcUrl, explorerUrl, and isTestnet
Example
See Also
getChains()
List all chains to find valid chainId values
distribute()
Use chain details when creating a distribution
Menu
Search
Code
Generated Code