Buy

POST/trading/delayed/buy

Purchase tokens from one or multiple wallets with a configurable delay between each transaction. Wallets execute sequentially — one after another — at the interval you define.

Quick Start

curl -X POST https://api.launchpad.trade/trading/delayed/buy \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "privateKeys": ["YOUR_PRIVATE_KEY_1", "YOUR_PRIVATE_KEY_2"],
    "amount": {
      "mode": "FIXED",
      "value": 0.5
    },
    "delay": {
      "mode": "FIXED",
      "value": 500
    }
  }'

See all parameters, delay modes, and amount modes below.

Parameters

Required

Parameter	Type	Description
`tokenAddress`	string	Solana token address to buy
`privateKeys`	string[]	Private keys of the wallets. Min 1, max 50. Required for all modes except `CUSTOM`
`amount`	object	Amount of SOL per wallet. See Amount Modes
`delay`	object	Delay configuration between transactions. See Delay Modes

Conditional

Parameter	Type	Description
`wallets`	object[]	Wallets with individual amounts (`{ privateKey, amount }`). Required when `amount.mode` is `CUSTOM` — replaces `privateKeys`

Optional

Parameter	Type	Default	Description
`priorityFee`	object	FAST (0.00015 SOL)	Transaction priority level. See Priority Fee
`platformTag`	object \| false	No attribution	Tag transactions with a DEX source. See Platform Attribution

Delay Modes

FIXED
RANGE

Exact interval between each transaction.

{
  "delay": {
    "mode": "FIXED",
    "value": 500
  }
}

All wallets wait exactly 500ms between each execution.

Random interval between min and max for each gap.

{
  "delay": {
    "mode": "RANGE",
    "min": 200,
    "max": 800
  }
}

Each gap between transactions is independently randomized within the range.

The 45-second limit applies: (numberOfWallets − 1) × maxDelay ≤ 45,000ms. Requests exceeding this are rejected before execution. See 45-Second Limit.

Amount Modes

Four modes to control how SOL is distributed across wallets.

FIXED
RANGE
TOTAL
CUSTOM

Each wallet buys with the same amount.

{
  "amount": {
    "mode": "FIXED",
    "value": 0.5
  }
}

3 wallets × 0.5 SOL = 1.5 SOL total.

Each wallet buys a random amount between min and max.

{
  "amount": {
    "mode": "RANGE",
    "min": 0.1,
    "max": 0.5
  }
}

Each wallet receives a distinct amount within the range.

A total budget split evenly across all wallets.

{
  "amount": {
    "mode": "TOTAL",
    "value": 2.0
  }
}

2.0 SOL ÷ 4 wallets = 0.5 SOL each.

Per-wallet amounts. Uses the wallets array instead of privateKeys.

{
  "wallets": [
    { "privateKey": "5K7gT...", "amount": 0.1 },
    { "privateKey": "3Jd8f...", "amount": 0.3 },
    { "privateKey": "9Pm2x...", "amount": 0.5 }
  ],
  "amount": {
    "mode": "CUSTOM"
  }
}

More Examples

Variable amounts and variable delay

Random amount per wallet with random delay intervals — useful for time-distributed position building across wallets.

curl -X POST https://api.launchpad.trade/trading/delayed/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
    },
    "delay": {
      "mode": "RANGE",
      "min": 200,
      "max": 500
    },
    "platformTag": {
      "platform": ["PHOTON", "AXIOM", "NONE"]
    }
  }'

Per-wallet amounts with custom delay

Full control over each wallet’s buy amount with a variable delay interval.

curl -X POST https://api.launchpad.trade/trading/delayed/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"
    },
    "delay": {
      "mode": "RANGE",
      "min": 300,
      "max": 800
    },
    "platformTag": {
      "platform": "RANDOM"
    }
  }'

Response

Success (200)
Partial Success (200)

{
  "success": true,
  "data": {
    "transactions": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "signature": "5UfDuX7nPqR3kLm8vYz...",
        "status": "confirmed",
        "slot": 234567890,
        "networkLatency": 52,
        "confirmLatency": 456,
        "amountSol": 0.5,
        "tokensReceived": 1234567890,
        "executedAt": 1706612400000
      },
      {
        "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "signature": "3KmPqYvRs8T2nHj7...",
        "status": "confirmed",
        "slot": 234567891,
        "networkLatency": 42,
        "confirmLatency": 608,
        "amountSol": 0.5,
        "tokensReceived": 1234123456,
        "executedAt": 1706612400500
      }
    ],
    "summary": {
      "totalWallets": 2,
      "successful": 2,
      "failed": 0,
      "totalSolSpent": 1.0,
      "totalTokensReceived": 2468691346,
      "totalDuration": 500
    }
  }
}

Field	Type	Description
`transactions[].wallet`	string	Public address of the wallet
`transactions[].signature`	string	Transaction signature
`transactions[].status`	string	`confirmed` or `failed`
`transactions[].slot`	number	Solana slot the transaction landed in
`transactions[].networkLatency`	number	Time to build, sign, and broadcast the transaction (ms)
`transactions[].confirmLatency`	number	Total time from request to Solana confirmation (ms)
`transactions[].amountSol`	number	SOL spent
`transactions[].tokensReceived`	number	Tokens received
`transactions[].executedAt`	number	Unix timestamp of execution (ms)
`summary.totalWallets`	number	Total number of wallets
`summary.successful`	number	Number of confirmed transactions
`summary.failed`	number	Number of failed transactions
`summary.totalSolSpent`	number	Total SOL spent across all wallets
`summary.totalTokensReceived`	number	Total tokens received across all wallets
`summary.totalDuration`	number	Total execution duration (ms)

Some transactions may fail individually. The response still returns "success": true — always check status for each wallet.

{
  "success": true,
  "data": {
    "transactions": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "signature": "5UfDuX7nPqR3kLm8vYz...",
        "status": "confirmed",
        "slot": 234567890,
        "networkLatency": 42,
        "confirmLatency": 722,
        "amountSol": 0.5,
        "tokensReceived": 1234567890,
        "executedAt": 1706612400000
      },
      {
        "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "signature": null,
        "status": "failed",
        "slot": null,
        "networkLatency": 52,
        "confirmLatency": 717,
        "error": "INSUFFICIENT_BALANCE",
        "amountSol": 0,
        "tokensReceived": 0,
        "executedAt": 1706612400500
      }
    ],
    "summary": {
      "totalWallets": 2,
      "successful": 1,
      "failed": 1,
      "totalSolSpent": 0.5,
      "totalTokensReceived": 1234567890,
      "totalDuration": 500
    }
  }
}

Each transaction is independent — there is no atomic guarantee. Always iterate over transactions and check each status.

Errors

{
  "success": false,
  "error": {
    "code": "ESTIMATED_DURATION_EXCEEDED",
    "message": "Estimated duration ~57000ms exceeds 45000ms limit. Reduce wallets or delay."
  }
}

Code	Message	Cause
`INVALID_TOKEN`	Invalid token address	Token address is not a valid Solana address
`INVALID_WALLET`	Invalid private key	One of the private keys is malformed
`INVALID_AMOUNT`	Invalid amount configuration	Amount mode, value, or range is invalid
`INVALID_DELAY`	Invalid delay configuration	Delay mode, value, or range is invalid
`ESTIMATED_DURATION_EXCEEDED`	Estimated duration ~Xms exceeds 45000ms limit	`(wallets − 1) × maxDelay > 45,000ms` — reduce wallets or delay
`RATE_LIMIT`	Rate limit exceeded	Too many requests — see Rate Limits
`INTERNAL_ERROR`	Internal server error	Retry 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.

Each wallet needs enough SOL to cover the buy amount + priority fee
executedAt is a Unix timestamp in milliseconds — use it to verify actual timing between transactions
summary.totalDuration reflects the real elapsed time across all executions

What’s Next?

Delayed Sell

Sell tokens with configurable delays between wallets

Instant Buy

Execute all wallets in the same block for maximum speed

Priority Fee

Configure transaction speed and cost

Platform Attribution

Tag transactions with a DEX source

Getting Started

Concepts

Trading

Launch

Wallets

Funding

Utilities

Quick Start

Parameters

Required

Conditional

Optional

Delay Modes

Amount Modes

More Examples

Response

Errors

Notes

What’s Next?

Delayed Sell

Instant Buy

Priority Fee

Platform Attribution

Getting Started

Concepts

Trading

Launch

Wallets

Funding

Utilities

​Quick Start

​Parameters

​Required

​Conditional

​Optional

​Delay Modes

​Amount Modes

​More Examples

​Response

​Errors

​Notes

​What’s Next?

Delayed Sell

Instant Buy

Priority Fee

Platform Attribution

Quick Start

Parameters

Required

Conditional

Optional

Delay Modes

Amount Modes

More Examples

Response

Errors

Notes

What’s Next?