에이전트 우선 공개 데이터
Agent-First Data API
F-Star의 공개 온체인 데이터를 익명, 읽기 전용, OpenAPI 3.1로 기술된 HTTP API로 노출합니다 — AI 에이전트와 LLM 도구 사용을 위해 설계되었습니다. 키도, SDK도, Solidity도 필요 없습니다: 한 번의 GET이 구조화된 JSON을 반환합니다.
에이전트가 NAV 하나를 읽으려고 ABI를 파싱하고, RPC 노드를 돌리고, 18자리 소수점을 맞춰야 할 이유는 없습니다.
온체인 진실(NAV, 정산, 배분, 컨트랙트 주소, 인덱싱된 이벤트)을 RFC 7807 에러 모델과 ETag 캐싱을 갖춘 안정적인 리소스 엔드포인트로 패키징합니다. 어떤 LLM이든 /openapi.json 또는 /llms.txt로부터 스스로를 기술하고 올바른 호출을 발행할 수 있습니다. 쓰기 작업(allocate, redeem, claim)은 여전히 사용자 본인의 지갑으로 서명됩니다 — API는 결코 키를 보관하지 않습니다.
세 종류의 에이전트
엔드포인트를 설계하며 상정한 세 호출자
펀드 탐색 에이전트
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초, history 5분, 프로토콜 메타 1시간).
- 안정적 버저닝: /v1/ 경로 접두사. 파괴적 변경은 /v2/로 이동. 폐기된 엔드포인트는 최소 90일간 410 Gone + Link 헤더를 반환합니다.
다섯 개의 진입 파일 — /openapi.json, /llms.txt, /llms-full.txt, /.well-known/ai-plugin.json, /.well-known/agents.json — 이 OpenAI, Anthropic, LangChain 에이전트 런타임이 프로토콜을 자동으로 발견하고 연결하게 합니다.
엔드포인트 치트시트
전부 GET · 익명 · JSON
네 계층 — 프로토콜, 펀드, 전략, 이벤트 — 에 걸친 16개의 읽기 전용 엔드포인트. 전체 파라미터와 응답 예시는 API 레퍼런스에 있습니다.
| 엔드포인트 | 용도 |
|---|---|
| GET /v1/protocol | 프로토콜 메타데이터: 버전, 체인, 컨트랙트 수, 펀드, 정책 |
| GET /v1/contracts | 온체인 컨트랙트 레지스트리(주소 + 역할 + 익스플로러 링크) |
| GET /v1/policies | 정산 정책 플러그인(ThreePoolPolicy / KellyPolicy)과 파라미터 |
| GET /v1/health | 서비스 & 인덱서 상태, 최신 NAV epoch, 중단된 모듈 |
| GET /v1/funds | 펀드 목록 + 정책 + 최신 NAV 요약 |
| GET /v1/funds/{slug} | 펀드 상세(컨트랙트 주소, 포털 링크) |
| GET /v1/funds/{slug}/nav | 최신 발행 NAV |
| GET /v1/funds/{slug}/nav/history | NAV 시계열(기본값 최근 90 epoch) |
| GET /v1/funds/{slug}/allocations | 현재 전략 자본 배분 |
| GET /v1/funds/{slug}/reserve | Dream Reserve 수준과 목표 밴드 |
| GET /v1/funds/{slug}/dividends | 배당 라운드(커서 페이징) |
| GET /v1/funds/{slug}/dividends/{epoch} | 단일 배당 라운드(Merkle root, 총액) |
| GET /v1/funds/{slug}/dividends/{epoch}/proof | 주소가 클레임에 필요한 Merkle proof |
| GET /v1/strategies | 전략 카탈로그 + 정량 & 휴먼 평가 |
| GET /v1/strategies/{slug} | 단일 전략 상세 |
| GET /v1/events | 인덱싱된 온체인 이벤트 스트림(커서 페이징) |
데이터는 현재 Arbitrum Sepolia 테스트넷(chainId 421614)을 반영합니다. 레이트 리밋 60 req/min/IP(버스트 20).
다섯 개의 디스커버리 파일
에이전트 런타임을 위한 설정 불필요 온보딩