开始使用
认证
如何对请求进行认证，以及配置 Tip 支付。
API Key
从 仪表板生成你的 API Key。BoltTx 支持两种格式 —— 根据你的使用场景选择任一种。
方式 A —— Authorization 请求头（推荐）
标准 Bearer Token。避免 API Key 出现在 URL 和服务器日志里。
Authorization: Bearer btx_live_your_api_key_here方式 B —— URL 查询参数
在任意端点后追加 ?api-key= 。这是只接受 URL 的 Solana RPC 客户端（例如 new Connection(url)）的唯一方式。
https://bolttx.io/v1/send?api-key=btx_live_your_api_key_hereTip 地址
每笔交易必须包含一条 SOL 转账指令，接收方为以下 任意一个 Tip 地址。建议每笔交易随机选择一个地址，以实现最佳的负载分布。
官方 Tip 地址
最低 Tip 金额
| 套餐 | 最低 Tip | TPS 限制 |
|---|---|---|
| Starter | 0.0008 SOL | 8 TPS |
| Growth | 0.0005 SOL | 30 TPS |
| Pro | 0.0003 SOL | 80 TPS |
| Whale | 0.0001 SOL | 150 TPS |
添加 Tip 指令
在签名前，向交易中添加一条标准的 SOL 转账指令。Tip 指令可以放在指令列表的任意位置。
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
})
);套餐自动升级
随着你通过 Tip 累计 Bolt Points，账户会自动解锁更高档位。无需手动操作 —— 升级后立即享受新档位更低的 Tip 下限。你可以在 仪表板 或通过 GET /v1/account查看进度。
校验与速率限制
每个请求按以下顺序校验，遇到第一项失败即以对应状态返回：
402 Payment Required交易未包含 BoltTx Tip 转账已签名交易里没有任何指向 BoltTx 官方 Tip 地址的 SOL 转账指令。
error: "Transaction must include a tip transfer to a BoltTx tip address"402 Payment RequiredTip 金额低于套餐下限交易里包含了 Tip 转账，但金额低于当前套餐要求的最低值（例如 Starter 套餐需要 0.0008 SOL）。
error: "Insufficient tip: {actual} lamports (plan '{plan}' requires minimum {required} lamports / {sol} SOL)" 429 Too Many Requests超出套餐 TPS 限制你的账户每秒发送的交易数超过了套餐允许的上限。该限制按用户聚合（你所有 API key 共享同一上限），不是按 key 独立计数。
error: "Rate limit exceeded for plan '{plan}' ({tps} TPS). Retry in ~{ms} ms."