# NovaHyper Agent API

> Public, read-only HTTP API exposing NovaHyper — a multi-strategy on-chain first-loss fund platform
> (operators stake junior first-loss margin that absorbs losses before investor principal up to a
> risk cap; execution on Hyperliquid and Polymarket). All GET, anonymous, JSON. No write/trade ops.

API version: 1.0.0
Base URL: https://novahyper.io/api/v1
OpenAPI: https://novahyper.io/openapi.json
Docs: https://novahyper.io/developers

Notes:
- Amounts are USDC base units (decimals: 6); large integers are JSON strings.
- Errors use RFC 7807 application/problem+json.
- When contracts are not yet configured, lists are empty and /health reports "not-configured".

## Endpoints

- [GET /v1/protocol](https://novahyper.io/api/v1/protocol): Platform metadata: brand, chain, contracts, markets, discovery links.
- [GET /v1/contracts](https://novahyper.io/api/v1/contracts): Deployed contract addresses.
- [GET /v1/markets](https://novahyper.io/api/v1/markets): Supported venues (Hyperliquid, Polymarket) + planned.
- [GET /v1/health](https://novahyper.io/api/v1/health): Chain reachability + configuration status.
- [GET /v1/pools](https://novahyper.io/api/v1/pools): List capital pools with params and live balances.
- [GET /v1/pools/{address}](https://novahyper.io/api/v1/pools/{address}): One pool by CapitalPool address.
- [GET /v1/pools/{address}/settlements](https://novahyper.io/api/v1/pools/{address}/settlements): Recent on-chain settlements (best-effort).

## Discovery

- OpenAPI 3.1: https://novahyper.io/openapi.json
- agents.json: https://novahyper.io/.well-known/agents.json