BotTx|Documentation

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_here

Option 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_here

Tip 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.

Official Tip Addresses

Minimum Tip Amounts

PlanMin TipTPS Limit
Starter0.0008 SOL8 TPS
Growth0.0005 SOL30 TPS
Pro0.0003 SOL80 TPS
Whale0.0001 SOL150 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.

JavaScript
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 transaction

The 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 minimum

A 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 exceeded

Your 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."

Further reading