Skip to main content
Initialize wallets for optimal trading speed with Launchpad Trade API
POST/wallets/init
Prepare your wallets for the fastest possible trade execution. Without initialization, the first swap transaction from a wallet will be slower.
Auto-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

curl -X POST https://api.launchpad.trade/wallets/init \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "privateKeys": [
      "WALLET_PRIVATE_KEY_1",
      "WALLET_PRIVATE_KEY_2"
    ]
  }'

Parameters

ParameterTypeDescription
privateKeysstring[]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
Already-initialized wallets are detected automatically — no extra cost if you call this endpoint again.

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_initialized at no cost
  • Check your current region with GET /health
If you change your server location or IP address, the load balancer may route you to a different region. Without re-initializing, the first trade from each wallet will have added latency.

Response

{
  "success": true,
  "data": {
    "initialized": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "status": "initialized"
      },
      {
        "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "status": "already_initialized"
      }
    ],
    "region": "ams"
  }
}

Errors

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet 7xKX... has 0.005 SOL, minimum 0.01 SOL required"
  }
}
CodeMessageCause
NO_WALLETSNo wallets providedprivateKeys array is empty or missing
TOO_MANY_WALLETSMaximum 50 wallets per requestMore than 50 wallets submitted
INVALID_WALLETInvalid private keyOne or more private keys are invalid
INSUFFICIENT_BALANCEInsufficient SOL balanceWallet has less than 0.01 SOL
RATE_LIMITRate limit exceededToo many requests — see Rate Limits
INTERNAL_ERRORInternal server errorRetry or contact support

Notes

  • Already-initialized wallets return status: "already_initialized" — no duplicate charges
  • A wallet that fails initialization returns status: "failed" with an error field 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