Nova·Hyper
只读 · 无鉴权 · CORS

NovaHyper Agent API

面向 AI agent 与开发者的公开只读 API：直接读取资金池、参数、余额与结算。全部 GET、匿名、JSON； 金额为 USDC 基本单位（decimals: 6，大整数以字符串返回）；错误用 RFC 7807。无写/交易操作。

机器可发现

OpenAPI 3.1llms.txtllms-full.txtagents.jsonai-plugin.json

端点

GET/api/v1/protocol平台元数据：品牌、链、合约、市场、发现链接
GET/api/v1/contracts已部署合约地址
GET/api/v1/markets支持的市场（HL/PM）与即将接入
GET/api/v1/health链可达性与配置状态
GET/api/v1/pools全部资金池：参数 + 实时余额
GET/api/v1/pools/{address}单个资金池详情
GET/api/v1/pools/{address}/settlements最近链上结算（尽力而为）

Base URL: https://novahyper.io/api/v1

curl

curl https://novahyper.io/api/v1/pools

JavaScript

const r = await fetch("https://novahyper.io/api/v1/pools");
const { items } = await r.json();
console.log(items[0].balances.investorNav); // USDC base units (string)

Python

import httpx
r = httpx.get("https://novahyper.io/api/v1/pools").json()
for p in r["items"]:
    print(p["strategy"]["label"], p["status"]["name"])

给 AI agent 的接入说明

  • 发现：抓取 /.well-known/agents.json 获取能力与 OpenAPI/llms 链接。
  • 上下文：读取 /llms.txt（精简）或 /llms-full.txt（含机制说明）。
  • 数据：/api/v1/pools 列池、/pools/{address} 取详情、/settlements 取结算。
  • 字段：bps 为万分比（1500=15%）；status 0 募集/1 活跃/2 熔断/3 关闭；market 0 HL/1 PM。

写操作（出资/质押/上报）走链上签名交易，非本 API 范畴；合约 ABI 与流程见 机制。本 API 为只读数据，非投资建议。