在 Veltra 交易历史 API 之上构建的开源示例

我们刚刚开源了 veltra-examples，一组小而完整、可直接复制粘贴的项目，展示如何在 Veltra 钱包交易历史 API 之上构建真正可用的工具。每个示例都可以克隆下来，用 npm install && npm start 运行，并且设计上就是为了让你直接搬进自己的项目。

思路很简单：API 通过单个 接口 把钱包完整且已解析的买卖历史交给你，所以你读到的不是文档，而是一个已经在做你想做的事的可运行程序。

里面有什么

• pnl-tracker：按代币计算基于 FIFO 成本基础的已实现盈亏、胜率与未平仓头寸。是真正的会计核算，而不是「SOL 进、SOL 出」的粗略估算。
• copy-trade-backtester：回答「如果我跟单了这个钱包，能赚多少？」。在有限本金、固定仓位规模以及每笔成交都计入滑点的条件下重放钱包历史。
• trade-scoring：一条机器学习流水线，从钱包历史中提取特征并训练模型来给其水平打分，还带有为你自己的钱包打标签的模式。
• wallet-watcher：轮询某个钱包，一旦它产生新交易就发出提醒，可输出到终端或转发到 Discord、Slack 的 webhook。

一个 接口，多种工具

每个示例都建立在同一次调用之上：GET /v1/wallets/{address}/history。它把每笔交易作为一行干净数据返回，包含方向、代币、mint、SOL 价值、代币数量、DEX 与时间戳，你这边完全不需要解码交易。这一条「谁在何时何地、以多少价格买卖了什么」的数据流，足以用来计算成本基础、回测跟单策略、训练评分模型或监控新活动。

不用 JavaScript？仓库中还附带一份 curl 手册，涵盖流式返回、分页、多链、错误处理以及 jq 单行命令，可以顺畅地迁移到任何语言。

从一次调用开始

curl -N "https://veltrabot.com/v1/wallets/{address}/history" \
  -H "Authorization: Bearer YOUR_API_KEY"

为复制而生

• 每个示例都是独立的文件夹：复制你需要的那个，其余的可以忽略。没有 monorepo 工具链需要学习。
• 每个示例都在数据之上做了真正的工作，而不只是把 API 响应重新打印一遍。
• 交易类示例都是诚实的历史模拟，而非实盘执行，并明确说明了它们模拟了什么、没有模拟什么。
• 每个示例都自带测试，CI 会对所有示例运行类型检查与测试。

获取代码

完整源码在 GitHub 上：https://github.com/QuirkyTurtle11/veltra-examples ，采用 MIT 许可证。申请一个 API 密钥，免费试用额度足以运行全部示例。