# 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".

## How it works

Operators open isolated capital pools. Investors deposit USDC for pool shares. An operator stakes
first-loss margin (junior capital) to activate a pool, then trades a dedicated account on the pool's
venue. Daily, signed equity is reported on-chain and settled by a pure first-loss waterfall:
profit pays the investor expected-return hurdle first, then operator carry; losses slash the
operator margin first, then investor principal, halting the pool at the risk cap.

## Endpoints (detail)

### GET /v1/protocol

Platform metadata: brand, chain, contracts, markets, discovery links.

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

### GET /v1/contracts

Deployed contract addresses.

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

### GET /v1/markets

Supported venues (Hyperliquid, Polymarket) + planned.

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

### GET /v1/health

Chain reachability + configuration status.

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

### GET /v1/pools

List capital pools with params and live balances.

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

### GET /v1/pools/{address}

One pool by CapitalPool address.

curl https://novahyper.io/api/v1/pools/{address}

### GET /v1/pools/{address}/settlements

Recent on-chain settlements (best-effort).

curl https://novahyper.io/api/v1/pools/{address}/settlements

## Fields

- bps values are 1/100 of a percent (1500 = 15%).
- status: 0 Raising, 1 Active, 2 Halted, 3 Closed.
- market: 0 Hyperliquid, 1 Polymarket.