Veltra 取引履歴 API の上に作るオープンソースのサンプル

veltra-examples をオープンソースとして公開しました。Veltra ウォレット取引履歴 API の上で実用的なツールを作る方法を示す、小さく完結した、コピー＆ペーストできるプロジェクト集です。どれもクローンして npm install && npm start で動き、そのままご自身のプロジェクトに持ち込めるように作られています。

発想はシンプルです。API が単一の エンドポイント からウォレットの完全でパース済みの売買履歴を渡してくれるので、ドキュメントの代わりに、やりたいことをすでに実行している動くプログラムを読めばよいのです。

中身

• pnl-tracker: トークンごとの FIFO 取得原価に基づく実現損益、勝率、未決済ポジション。SOL の出入りによる概算ではなく、本物の会計処理です。
• copy-trade-backtester: 「このウォレットをコピーしていたら、いくら稼げたか」に答えます。有限の資金、固定のポジションサイズ、すべての約定にスリッページを適用してウォレットの履歴を再生します。
• trade-scoring: ウォレット履歴から特徴量を抽出し、その巧拙をスコア化するモデルを学習させる機械学習パイプライン。自分のウォレットにラベルを付けるモードもあります。
• wallet-watcher: ウォレットをポーリングし、新しい取引が発生した瞬間に通知します。ターミナルに出力するか、Discord や Slack の webhook に転送します。

1 つの エンドポイント、たくさんのツール

どのサンプルもたった 1 回の呼び出しの上に成り立っています: GET /v1/wallets/{address}/history。各取引を、売買の別、トークン、mint、SOL 建て価値、トークン数量、DEX、タイムスタンプを持つきれいな行として返し、こちら側でのトランザクションのデコードは不要です。「誰が、何を、いくらで、どこで、いつ売買したか」というこの 1 本のストリームだけで、取得原価の計算、コピー戦略のバックテスト、スコアリング モデルの学習、新規活動の監視がすべて可能になります。

JavaScript をお使いでない場合も、リポジトリにはストリーミング、ページング、マルチチェーン、エラー処理、jq のワンライナーを網羅した curl クックブックが同梱されています。どの言語にもそのまま置き換えられます。

1 回の呼び出しから始める

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 キー を取得すれば、無料トライアルの範囲ですべてのサンプルを実行できます。