API 参考

交易状态

查询已提交交易的当前状态。

GET/v1/status/:signature

请求

需通过 API Key 鉴权（Bearer header 或 ?api-key= 查询参数）。本端点只返回通过你账户提交的交易 —— 你查询不到其他用户的交易，未经过 BoltTx 的签名会返回 404。响应仅包含 BoltTx 的投递遥测（提交时间 submitted_at、确认时间 confirmed_at、链路延迟 latency_ms、slot、发送方 API Key 名）。如果需要查询链上 commitment 等级、确认深度或交易错误详情，请调用你自己 Solana RPC 的 getSignatureStatuses —— BoltTx 是投递服务，不是链上查询服务。查询从独立的 Query 配额中扣费，轮询不会消耗你的发送 TPS 预算；上限为发送 TPS 的 2 倍（Starter：16 q/s，Growth：60 q/s，Pro：160 q/s，巨鲸：300 q/s）。

仅本账户可见

与 dashboard 日志一致，本端点只返回通过你名下 API Key 提交的交易。其他用户发送的签名 —— 或者从未经过 BoltTx 的签名 —— 都会返回 404。这样既保护你的交易足迹，也防止 BoltTx 被滥用为免费的公共 RPC 探测服务。

请求头

请求头	值	必填
Authorization	Bearer YOUR_API_KEY	必填

路径参数

参数	类型	描述
signature	string	发送端点返回的交易签名

请求示例

cURL

curl https://bolttx.io/v1/status/5xKnR8qXeVm3pN... \
  -H "Authorization: Bearer YOUR_API_KEY"

URL 鉴权（可选方式）

如果不方便设置 header —— 例如在浏览器里直接测试、分享快速查询链接、或者工具不支持自定义 header —— 可以把 API Key 拼接在 URL 查询参数里。?api-key=YOUR_KEY 和 ?api_key=YOUR_KEY 两种写法都被接受，功能与 Authorization header 完全等价。

cURL

curl "https://bolttx.io/v1/status/5xKnR8qXeVm3pN...?api-key=YOUR_API_KEY"

提醒：URL 中的 key 会出现在服务器日志、反向代理日志和浏览器历史里。生产环境和高频轮询场景建议使用 Authorization header。URL 鉴权更适合临时调试和快速原型。

响应

成功 (200)

{
  "signature": "5xKnR8qXeVm3pN...",
  "status": "confirmed",
  "submitted_at": "2026-04-14T08:21:33Z",
  "confirmed_at": "2026-04-14T08:21:33.412Z",
  "latency_ms": 412,
  "slot": 234567890,
  "api_key_name": "prod-bot-1"
}

响应字段

字段	类型	描述
signature	string	交易签名
status	string	BoltTx 追踪的生命周期：sent（已提交，等待链上确认）/ confirmed（已确认成功）/ failed（被打包但执行失败）
submitted_at	string	BoltTx 接受并提交该交易的 ISO-8601 UTC 时间戳
confirmed_at	string \| null	BoltTx 内部追踪器测得的链上确认 ISO-8601 UTC 时间戳。交易达到终态前为 null。
latency_ms	number \| null	BoltTx 端到端测得的提交→确认墙钟延迟（毫秒）。确认前为 null。
slot	number \| null	交易被打包的 Slot
api_key_name	string	提交该交易的 API Key 友好名称（让你能识别是哪个机器人或服务发出的）

状态值

状态	描述
sent	交易已提交到网络；等待链上确认
confirmed	交易已在链上确认（执行成功）
failed	交易已被打包入块，但执行失败。请通过你自己的 Solana RPC 查询链上错误详情。

错误码

代码	信息	描述
400	签名无效	签名格式错误
401	未授权	缺少或无效的 API Key
404	未找到	该签名不是通过本账户提交的。/v1/status 只返回你通过 BoltTx 发送的交易；其他用户或站外的签名永远不会被暴露。
429	查询速率超限	用户级查询配额已用完；上限为套餐发送 TPS 的 2 倍，按用户聚合（你所有 API Key 共享同一上限 —— 创建更多 Key 不会提升限额，请升级套餐）
500	内部错误	查询交易时数据库出错

追踪你的交易

你签名的瞬间就已在本地拿到交易签名 —— 无需等待我们的响应。你可以直接用它通过自己的 Solana RPC 节点订阅确认事件，或在需要快速查状态时轮询此端点。

批量发送反 MEV