
POST
Prepare your wallets for the fastest possible trade execution. Without initialization, the first swap transaction from a wallet will be slower.
/wallets/initAuto-init fallback. If a wallet is not initialized, the first swap through the API will handle it automatically — but with extra latency. For optimal speed from the start, initialize in advance.
Quick Start
Parameters
| Parameter | Type | Description |
|---|---|---|
privateKeys | string[] | Array of wallet private keys to initialize. Min 1, max 50. Each wallet must hold at least 0.01 SOL |
Why Initialize?
The first trading transaction from a new wallet requires additional setup. Initializing in advance removes that overhead so every trade executes at maximum speed — including the first one.- One-time cost — ~0.01 SOL per wallet, recovered automatically when no longer used
- Minimum balance — wallet must hold at least 0.01 SOL
Region-Specific
Initialization is tied to the region your requests are routed to. If you change server locations and get assigned to a different region, re-initialize your wallets.- One-time per region — no need to re-initialize unless you switch locations
- Idempotent — initializing an already-initialized wallet returns
already_initializedat no cost - Check your current region with
GET /health
Response
Errors
| Code | Message | Cause |
|---|---|---|
NO_WALLETS | No wallets provided | privateKeys array is empty or missing |
TOO_MANY_WALLETS | Maximum 50 wallets per request | More than 50 wallets submitted |
INVALID_WALLET | Invalid private key | One or more private keys are invalid |
INSUFFICIENT_BALANCE | Insufficient SOL balance | Wallet has less than 0.01 SOL |
RATE_LIMIT | Rate limit exceeded | Too many requests — see Rate Limits |
INTERNAL_ERROR | Internal server error | Retry or contact support |
Notes
- Already-initialized wallets return
status: "already_initialized"— no duplicate charges - A wallet that fails initialization returns
status: "failed"with anerrorfield describing the cause - The ~0.01 SOL cost is recovered automatically when the wallet is no longer used
- Initialization is region-specific — check your region with
GET /health
What’s Next?
Check Balance
Verify SOL balances before initializing
Start Trading
Execute your first buy or sell
Create Wallets
Generate new Solana wallets in bulk
Distribute SOL
Fund your wallets with SOL