Getting Started
Authentication
How to authenticate your requests and configure tip payments.
API Key
Generate your API key from the Dashboard. BoltTx accepts API keys in two formats — use whichever fits your workflow.
Option A — Authorization header (recommended)
Standard Bearer token. Keeps your key out of URLs and server logs.
Authorization: Bearer btx_live_your_api_key_hereOption B — URL query parameter
Append ?api-key= to any endpoint. This is the only way for Solana RPC clients that accept a plain URL (e.g. new Connection(url)).
https://bolttx.io/v1/send?api-key=btx_live_your_api_key_hereTip Addresses
Each transaction must include a SOL transfer instruction to any one of the following tip addresses. We recommend picking a random address per transaction for optimal load distribution.
Minimum Tip Amounts
| Plan | Min Tip | TPS Limit |
|---|---|---|
| Starter | 0.0008 SOL | 8 TPS |
| Growth | 0.0005 SOL | 30 TPS |
| Pro | 0.0003 SOL | 80 TPS |
| Whale | 0.0001 SOL | 150 TPS |
Adding a Tip Instruction
Add a standard SOL transfer instruction to your transaction before signing. The tip can be placed at any position in your instruction list.
import { SystemProgram, PublicKey } from "@solana/web3.js";
// Pick a random tip address
const tipAddresses = [
"BoLt1A77XnXgmLPTWFXztQ9oZRrTPuQHV7cChFCt35g6",
"BoLt2zHYz1VoNbw2hoKZGaJcEXe2aNGP8EweZx1Z48wr",
// ... add all 9 addresses
];
const tipAddress = tipAddresses[Math.floor(Math.random() * tipAddresses.length)];
// Add tip instruction (0.0008 SOL = 800,000 lamports for Starter plan)
transaction.add(
SystemProgram.transfer({
fromPubkey: yourWallet.publicKey,
toPubkey: new PublicKey(tipAddress),
lamports: 800_000, // 0.0008 SOL
})
);Plans auto-upgrade
Your account automatically unlocks higher tiers as you earn Bolt Points from tips. No action needed — the lower tip minimum for your new plan applies immediately after crossing the threshold. Check your progress from the Dashboard or programmatically via GET /v1/account.
Validation & Rate Limiting
Each request is validated in this order. The first failed check below ends the request with the listed status:
402 Payment RequiredNo BoltTx tip in the transactionThe signed transaction does not contain any SOL transfer to one of the official BoltTx tip addresses.
error: "Transaction must include a tip transfer to a BoltTx tip address"402 Payment RequiredTip below plan minimumA tip transfer is present, but its amount is less than your current plan's required minimum (e.g. Starter: 0.0008 SOL).
error: "Insufficient tip: {actual} lamports (plan '{plan}' requires minimum {required} lamports / {sol} SOL)" 429 Too Many RequestsPlan TPS exceededYour account has sent more transactions per second than your plan allows. The limit is per-user (shared across all your API keys), not per-key.
error: "Rate limit exceeded for plan '{plan}' ({tps} TPS). Retry in ~{ms} ms."