Datos públicos pensados para agentes
Agent-First Data API
Los datos públicos en cadena de F-Star, expuestos como una API HTTP anónima, de solo lectura y descrita con OpenAPI 3.1, construida para agentes de IA y para el uso de herramientas por parte de LLM. Sin claves, sin SDK, sin Solidity: un GET devuelve JSON estructurado.
Un agente no debería tener que analizar un ABI, correr un nodo RPC y alinear 18 decimales solo para leer un NAV.
Empaquetamos la verdad en cadena (NAV, liquidación, asignaciones, direcciones de contratos, eventos indexados) en endpoints de recursos estables con un modelo de errores RFC 7807 y caché mediante ETag. Cualquier LLM puede autodescribirse desde /openapi.json o /llms.txt y emitir llamadas correctas. Las operaciones de escritura (allocate, redeem, claim) las sigue firmando la propia billetera del usuario: la API nunca custodia claves.
Tres tipos de agente
Los tres consumidores en torno a los que diseñamos los endpoints
Agente de descubrimiento de fondos
FUND DISCOVERY
Enumera /v1/funds, compara trayectorias de NAV, políticas, niveles de reserva y calificaciones de estrategias, y preselecciona los fondos que encajan con el perfil de riesgo de un usuario.
Agente de estrategia de cartera
PORTFOLIO STRATEGY
Extrae /v1/strategies y /v1/funds/{slug}/nav/history, combina las calificaciones de Sharpe / Sortino / caída máxima y construye y prueba asignaciones multifondo.
Agente de auditoría y monitorización
AUDIT & MONITORING
Vigila /v1/events y /v1/health en busca de publicaciones de NAV, rondas de dividendos, módulos pausados y retraso del indexador, y alerta de anomalías en tiempo real.
Por qué está construida así
Cada decisión mantiene a los agentes lejos de un tropiezo
- Anónima y de solo lectura: fricción de autenticación nula, usable al instante; las escrituras pasan por firmas de billetera, así que no hay claves del lado del servidor que se puedan filtrar.
- OpenAPI 3.1 como única fuente de verdad: /openapi.json describe los parámetros, respuestas y ejemplos de cada endpoint, para que un LLM pueda autogenerar un esquema de herramienta.
- Modelo de errores RFC 7807: application/problem+json; los agentes analizan los fallos a partir de campos uniformes (type/title/status/detail).
- REST de estilo recursos: todo GET, rutas con sustantivos, sin verbos; fund / strategy / nav / dividend coinciden con los términos en cadena sin retraducción.
- ETag + Cache-Control: envía If-None-Match para obtener 304 baratos; caché por niveles (NAV 30s, history 5min, metadatos del protocolo 1h).
- Versionado estable: prefijo de ruta /v1/; los cambios incompatibles van a /v2/; los endpoints obsoletos devuelven 410 Gone + una cabecera Link durante al menos 90 días.
Cinco archivos de entrada —/openapi.json, /llms.txt, /llms-full.txt, /.well-known/ai-plugin.json, /.well-known/agents.json— permiten que los entornos de ejecución de agentes de OpenAI, Anthropic y LangChain descubran el protocolo y se conecten a él automáticamente.
Chuleta de endpoints
Todos GET · anónimos · JSON
16 endpoints de solo lectura repartidos en cuatro capas: protocolo, fondos, estrategias y eventos. Parámetros completos y ejemplos de respuesta en la referencia de la API.
| ENDPOINT | PROPÓSITO |
|---|---|
| GET /v1/protocol | Metadatos del protocolo: versión, cadena, número de contratos, fondos, políticas |
| GET /v1/contracts | Registro de contratos en cadena (dirección + rol + enlace al explorador) |
| GET /v1/policies | Plugins de política de liquidación (ThreePoolPolicy / KellyPolicy) con sus parámetros |
| GET /v1/health | Salud del servicio y del indexador, última época de NAV, módulos pausados |
| GET /v1/funds | Lista de fondos + política + resumen del último NAV |
| GET /v1/funds/{slug} | Detalle del fondo (direcciones de contratos, enlaces al portal) |
| GET /v1/funds/{slug}/nav | Último NAV publicado |
| GET /v1/funds/{slug}/nav/history | Serie temporal del NAV (por defecto, las últimas 90 épocas) |
| GET /v1/funds/{slug}/allocations | Asignación actual de capital por estrategia |
| GET /v1/funds/{slug}/reserve | Nivel de la Dream Reserve y banda objetivo |
| GET /v1/funds/{slug}/dividends | Rondas de dividendos (paginación por cursor) |
| GET /v1/funds/{slug}/dividends/{epoch} | Una ronda de dividendos concreta (raíz de Merkle, total) |
| GET /v1/funds/{slug}/dividends/{epoch}/proof | Prueba de Merkle que una dirección necesita para reclamar |
| GET /v1/strategies | Catálogo de estrategias + calificaciones cuantitativas y humanas |
| GET /v1/strategies/{slug} | Detalle de una estrategia concreta |
| GET /v1/events | Flujo de eventos indexados en cadena (paginación por cursor) |
Los datos reflejan actualmente la testnet de Arbitrum Sepolia (chainId 421614). Límite de tasa: 60 req/min/IP (ráfaga de 20).
Cinco archivos de descubrimiento
Incorporación sin configuración para los entornos de ejecución de agentes
Conecta tu agente ahora
Alimenta /openapi.json al uso de herramientas de Claude o al function calling de OpenAI, o lee primero el inicio rápido en 4 pasos.
Anónima y de solo lectura · sin clave requerida · con licencia MIT