API 参考

架构

• 历史状态存档

  • 账户、区块和增量数据以专有格式存储，支持快速的确定性查询。

• 可用范围

  • 创建会话之前，请确认目标 slot 范围可用。

  • curl https://<host>/available-ranges | jq

• 会话控制通道

  • 连接此通道以创建和驱动回测会话。该通道上的所有消息均使用自定义 JSON 协议。

  • 端点： ws(s)://<host>/backtest

  • 方法： createBacktestSession, attachBacktestSession, continue, continueTo, closeBacktestSession

  • 响应： sessionCreated, sessionAttached, readyForContinue, slotNotification, paused, discoveryBatch, status（变体见下文）, success, completed, error

• 带序号的响应

  • 当 disconnectTimeoutSecs > 0 时，响应会附带序列 ID，以便客户端在重新连接后恢复会话。

  • seqId 是单调递增的序列号。客户端在调用 attachBacktestSession 时可传入最后收到的序号，从而恢复事件流，无需重放之前的消息。

  {
    "seqId": 123,
    "method": "status",
    "params": {
      "status": "decodedTransactions"
    }
  }

• 发现过滤器

  • 在创建会话时注册过滤器，以监控特定事件（例如某个程序被执行）。当即将执行的批次匹配时，服务器会发送 discoveryBatch，其中包含目标 slot 和批次索引。

  • 将这些值传给 continueTo，即可在该批次执行前立即暂停。

• 单会话 RPC 通道

  • 会话创建后，即可与模拟的 Solana 环境交互。大多数方法遵循标准的 Solana JSON-RPC 接口。

  • 端点： http(s):// 或 ws(s)://，路径为 /backtest/{session_id}

  • 账户状态： getAccountInfo, getBalance, getMultipleAccounts, getProgramAccounts

  • 链状态： getLatestBlockhash, getFeeForMessage, getSlot

  • 交易： simulateTransaction, sendTransaction, getTransaction

  • 订阅： accountSubscribe, slotSubscribe, transactionSubscribe

注意事项：

• /backtest 在生产环境中通过 API 密钥认证。/backtest/{session_id} 无需认证，用于单个会话的访问。

• ReadyToExecuteUserTransactions 是发送或执行用户交易前通常需要等待的主要状态。

• 如果客户端脚本采用严格解析，请确保其能够处理上述状态变体。

API 表

方法	用途	接口
createBacktestSession	启动回测会话，并获取 sessionId + rpcEndpoint。 使用 parallel: true 可在所有可用 bundle 上创建会话	会话控制（WS）
continue	执行一个批次并推进 slot；支持 transactions + modifyAccountStates。	会话控制（WS）
closeBacktestSession	关闭并清理会话。	会话控制（WS）
attachBacktestSession	重新连接到现有会话，并获取 rpcEndpoint。	会话控制（WS）
continueTo	根据已注册的过滤器，在特定 slot 和批次索引之前或之后立即暂停。过滤器注册于 discoveries	会话控制（WS）
getAccountInfo	获取当前 slot 下的单个账户。	单会话 RPC（HTTP）
getBalance	获取账户的 lamport 余额。	单会话 RPC（HTTP）
getMultipleAccounts	一次调用获取多个账户。	单会话 RPC（HTTP）
getProgramAccounts	获取某个程序拥有的账户。	单会话 RPC（HTTP）
getLatestBlockhash	获取当前 slot 的 blockhash。	单会话 RPC（HTTP）
getFeeForMessage	获取消息的手续费估算。	单会话 RPC（HTTP）
getSignatureStatuses	获取签名的状态。	单会话 RPC（HTTP）
getTransaction	获取交易详情（包括日志）。	单会话 RPC（HTTP）
simulateTransaction	模拟交易，不提交状态变更。	单会话 RPC（HTTP）
sendTransaction	在当前 slot 中立即执行交易。	单会话 RPC（HTTP）
getSlot	获取当前 slot。	单会话 RPC（HTTP）
getAddressLookupTable	获取 ALT（地址查找表）账户。	单会话 RPC（HTTP）
modifyAccounts	通过 RPC 应用账户覆盖。	单会话 RPC（HTTP）
accountSubscribe	实时推送账户变化。	单会话订阅（WS）
programSubscribe	实时推送程序拥有的账户变化。	单会话订阅（WS）
signatureSubscribe	实时推送签名状态更新。	单会话订阅（WS）
slotSubscribe	实时推送 slot 更新。	单会话订阅（WS）
logsSubscribe	实时推送日志更新。	单会话订阅（WS）