Skip to main content
POST/trading/instant/buy
Purchase tokens from a single wallet or up to 100 wallets simultaneously. Each wallet signs its own transaction independently. Transactions target the same block for consistent execution.

​
Quick Start

curl -X POST https://api.launchpad.trade/trading/instant/buy \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "privateKeys": ["YOUR_PRIVATE_KEY"],
    "amount": {
      "mode": "FIXED",
      "value": 0.5
    }
  }'
Priority fee defaults to FAST (0.00015 SOL). See all parameters and amount modes below.

​
Parameters

​
Required

ParameterTypeDescription
tokenAddressstringSolana token address to buy
privateKeysstring[]Private keys of the wallets. Min 1, max 50. Required for all modes except CUSTOM
amountobjectAmount configuration. See Amount Modes below

​
Conditional

ParameterTypeDescription
walletsobject[]Wallets with individual amounts ({ privateKey, amount }). Required when amount.mode is CUSTOM — replaces privateKeys

​
Optional

ParameterTypeDefaultDescription
priorityFeeobjectFAST (0.00015 SOL)Transaction priority level. See Priority Fee
platformTagobject | falseNo attributionTag transactions with a DEX source. See Platform Attribution

​
Amount Modes

Four modes to control how SOL is distributed across wallets.
Each wallet buys with the same amount.
{
  "amount": {
    "mode": "FIXED",
    "value": 0.5
  }
}
3 wallets × 0.5 SOL = 1.5 SOL total.

​
More Examples

Three wallets buying random amounts with platform attribution cycling through a list.
curl -X POST https://api.launchpad.trade/trading/instant/buy \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "privateKeys": ["PRIVATE_KEY_1", "PRIVATE_KEY_2", "PRIVATE_KEY_3"],
    "amount": {
      "mode": "RANGE",
      "min": 0.1,
      "max": 0.5
    },
    "priorityFee": {
      "mode": "FAST"
    },
    "platformTag": {
      "platform": ["PHOTON", "AXIOM", "NONE"]
    }
  }'
Full control over each wallet’s buy amount. Uses the wallets array instead of privateKeys.
curl -X POST https://api.launchpad.trade/trading/instant/buy \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "wallets": [
      { "privateKey": "PRIVATE_KEY_1", "amount": 0.1 },
      { "privateKey": "PRIVATE_KEY_2", "amount": 0.3 },
      { "privateKey": "PRIVATE_KEY_3", "amount": 0.5 }
    ],
    "amount": {
      "mode": "CUSTOM"
    },
    "priorityFee": {
      "mode": "ULTRA"
    }
  }'
Each wallet buys a different amount — 0.1, 0.3, and 0.5 SOL respectively.

​
Response

{
  "success": true,
  "data": {
    "transactions": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "signature": "5UfDuX7nPqR3kLm8vYz...",
        "status": "confirmed",
        "slot": 234567890,
        "networkLatency": 35,
        "confirmLatency": 465,
        "amountSol": 0.5,
        "tokensReceived": 1234567890
      },
      {
        "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "signature": "3KmPqYvRs8T2nBx7wQp...",
        "status": "confirmed",
        "slot": 234567890,
        "networkLatency": 33,
        "confirmLatency": 450,
        "amountSol": 0.5,
        "tokensReceived": 1234123456
      }
    ],
    "summary": {
      "totalWallets": 2,
      "successful": 2,
      "failed": 0,
      "totalSolSpent": 1.0,
      "totalTokensReceived": 2468691346
    }
  }
}

​
Errors

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Invalid token address"
  }
}
CodeMessageCause
INVALID_TOKENInvalid token addressToken address is not a valid Solana address
INVALID_WALLETInvalid private keyOne of the private keys is malformed
INVALID_AMOUNTInvalid amount configurationAmount mode, value, or range is invalid
INSUFFICIENT_BALANCEInsufficient SOL balanceWallet does not have enough SOL
RATE_LIMITRate limit exceededToo many requests — see Rate Limits
INTERNAL_ERRORInternal server errorRetry or contact support

​
Notes

Call Initialize Wallets before your first trade for optimal speed. Without initialization, the first swap from each wallet will have extra latency due to automatic setup. This is a one-time cost of ~0.01 SOL per wallet, recovered automatically when no longer used.
  • Each wallet needs enough SOL to cover the buy amount + priority fee

​
What’s Next?

Sell Tokens

Exit token positions from one or multiple wallets

Priority Fee

Configure transaction speed and cost

Platform Attribution

Tag transactions with a DEX source

Initialize Wallets

Optimize speed for your first trade