Navigate...
Initialize SDK
new Multisender(config)
The Multisender SDK is an npm package for distributing tokens to many recipients in batched on-chain transactions. Configure your API key below to start using the sandbox.
Overview
Multisender SDK provides a TypeScript API for sending tokens to hundreds or thousands of wallet addresses. It handles batching, calldata generation, and status tracking — you only need to sign and submit the transactions.Authentication: Pass your API key to the Multisender client constructor and the SDK authenticates every request for you. Generate a key in the Multisender dashboard.Two distribution flows: - Single-step — distribute() creates and prepares in one call, returning calldata to sign - Two-step — createDraft() → review → prepare() for human-in-the-loop workflowsUse sdk.project.getInfo() as a health check to verify your API key works.
Prerequisites
Node.js 18+, npm/yarn/pnpm, and an active Multisender subscription with an API key.
Installation
npm
Yarn
pnpm
Bun
npm install @multisender.app/multisender-sdk
Multisender SDK
An npm package (@multisender.app/multisender-sdk) that exposes the Multisender service as typed TypeScript methods. Install with npm install @multisender.app/multisender-sdk. Works in Node.js and browser environments.
API Key
A secret token (format: ms_...) that authenticates SDK requests. Pass it to the Multisender client constructor — the SDK handles the rest. Each key has permission scopes that control what operations it can perform. Generate keys in the Multisender dashboard. The secret is shown only once at creation — store it securely.
Scopes
Permission levels assigned to API keys. Control which operations the key can perform (e.g. read, write).
Base URL
Optional override for the API endpoint. Leave unset to use the Multisender production API. Pass baseUrl to new Multisender({ apiKey, baseUrl }) only for staging or local development.
Calldata
Pre-built transaction objects returned by distribute(). Each contains to, data, value, and gasLimit. You sign and submit these to the blockchain — Multisender generates them but does not send transactions.
From zero to first distribution
Everything you need from account creation to your first token send.
1
Register
Create a Multisender account at multisender.app
2
Subscribe
Choose a plan that fits your distribution volume
3
Create API Key
Generate an API key in Project Settings → API Keys
4
Install SDK
Run `npm install @multisender.app/multisender-sdk` in your project
5
Verify setup
Call `sdk.project.getInfo()` to verify your API key works
6
Distribute
Call `distribute()` to create your first distribution and get calldata
Configure Your SDK
API Key *
Base URL
getInfo()
Health check — verify your API key works and inspect project details
getChains()
List supported blockchains — find chainId for your target network
distribute()
Create a distribution and get calldata in one call — the primary SDK method
createDistributionList()
Create a reusable recipient list for multiple distributions
Start with sdk.project.getInfo() to verify your API key is configured correctly. If it returns your project details, the SDK is ready.
Try getInfo()
Generated Code