エージェントファーストの公開データ
Agent-First Data API
F-Star の公開オンチェーンデータを、匿名・読み取り専用・OpenAPI 3.1 記述の HTTP API として公開——AI エージェントと LLM のツール利用のために作られています。鍵不要、SDK 不要、Solidity 不要：1回の GET で構造化された JSON が返ります。
エージェントが NAV を読むためだけに、ABI をパースし、RPC ノードを走らせ、18桁の小数を揃える必要などあってはならない。
我々はオンチェーンの真実（NAV、決済、アロケーション、コントラクトアドレス、インデックス化されたイベント）を、RFC 7807 のエラーモデルと ETag キャッシングを備えた安定したリソースエンドポイントへとパッケージ化します。どの LLM も /openapi.json や /llms.txt から自己記述し、正しい呼び出しを発行できます。書き込み操作（allocate、redeem、claim）は依然としてユーザー自身のウォレットで署名されます——API が鍵を保持することは決してありません。
3種類のエージェント
エンドポイントを設計する際に想定した3種類の呼び出し元
ファンド発見エージェント
FUND DISCOVERY
/v1/funds を列挙し、NAV の推移、ポリシー、リザーブ水準、戦略レーティングを比較して、ユーザーのリスクプロファイルに合うファンドを絞り込みます。
ポートフォリオ戦略エージェント
PORTFOLIO STRATEGY
/v1/strategies と /v1/funds/{slug}/nav/history を取得し、シャープ／ソルティノ／最大ドローダウンのレーティングを組み合わせて、複数ファンドのアロケーションを構築・バックテストします。
監査・モニタリングエージェント
AUDIT & MONITORING
/v1/events と /v1/health を監視し、NAV の公開、配当ラウンド、停止中のモジュール、インデクサーの遅延を捉えて、異常をリアルタイムでアラートします。
なぜこの設計なのか
あらゆる判断が、エージェントを泥沼から遠ざける
- 匿名・読み取り専用：認証の摩擦がゼロで即座に使える。書き込みはウォレット署名を経るため、漏洩しうるサーバー側の鍵が存在しない。
- OpenAPI 3.1 を単一の信頼源に：/openapi.json が各エンドポイントのパラメータ、レスポンス、例を記述するため、LLM がツールスキーマを自動生成できる。
- RFC 7807 のエラーモデル：application/problem+json——エージェントは統一されたフィールド（type/title/status/detail）から失敗を解析する。
- リソース指向の REST：すべて GET、名詞のパス、動詞なし。fund / strategy / nav / dividend はオンチェーンの用語と一致し、再翻訳が要らない。
- ETag + Cache-Control：If-None-Match を送れば安価な 304 が得られる。階層的なキャッシング（NAV 30秒、履歴 5分、プロトコルメタ 1時間）。
- 安定したバージョニング：/v1/ のパスプレフィックス。破壊的変更は /v2/ へ。非推奨のエンドポイントは少なくとも90日間、410 Gone + Link ヘッダーを返す。
5つのエントリーファイル——/openapi.json、/llms.txt、/llms-full.txt、/.well-known/ai-plugin.json、/.well-known/agents.json——により、OpenAI、Anthropic、LangChain のエージェントランタイムがプロトコルを自動的に発見し接続できます。
エンドポイント早見表
すべて GET · 匿名 · JSON
4つの層——プロトコル、ファンド、戦略、イベント——にまたがる16の読み取り専用エンドポイント。パラメータとレスポンス例の全容は API リファレンスに。
| エンドポイント | 用途 |
|---|---|
| GET /v1/protocol | プロトコルのメタデータ：バージョン、チェーン、コントラクト数、ファンド、ポリシー |
| GET /v1/contracts | オンチェーンのコントラクトレジストリ（アドレス + ロール + エクスプローラーリンク） |
| GET /v1/policies | 決済ポリシープラグイン（ThreePoolPolicy / KellyPolicy）とそのパラメータ |
| GET /v1/health | サービスとインデクサーの稼働状況、最新の NAV エポック、停止中のモジュール |
| GET /v1/funds | ファンド一覧 + ポリシー + 最新 NAV サマリー |
| GET /v1/funds/{slug} | ファンド詳細（コントラクトアドレス、ポータルリンク） |
| GET /v1/funds/{slug}/nav | 最新の公開 NAV |
| GET /v1/funds/{slug}/nav/history | NAV の時系列（デフォルトで直近90エポック） |
| GET /v1/funds/{slug}/allocations | 現在の戦略への資本アロケーション |
| GET /v1/funds/{slug}/reserve | Dream Reserve の水準と目標バンド |
| GET /v1/funds/{slug}/dividends | 配当ラウンド（カーソルページング） |
| GET /v1/funds/{slug}/dividends/{epoch} | 単一の配当ラウンド（Merkle ルート、合計） |
| GET /v1/funds/{slug}/dividends/{epoch}/proof | アドレスが claim に必要とする Merkle 証明 |
| GET /v1/strategies | 戦略カタログ + 定量および人的レーティング |
| GET /v1/strategies/{slug} | 単一戦略の詳細 |
| GET /v1/events | インデックス化されたオンチェーンイベントストリーム（カーソルページング） |
データは現在 Arbitrum Sepolia テストネット（chainId 421614）を反映しています。レート制限は 60 req/min/IP（バースト 20）。
5つのディスカバリーファイル
エージェントランタイムのための設定不要のオンボーディング
今すぐエージェントを接続
/openapi.json を Claude のツール利用や OpenAI の function calling に渡すか、まずは4ステップのクイックスタートを読んでください。
匿名・読み取り専用 · 鍵不要 · MIT ライセンス