# NovaMarket Agent API

> Public, read-only HTTP API exposing NovaMarket — 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, Polymarket and Uniswap). The /v1 surface is all GET, anonymous,
> JSON — the authenticated trading surface is documented separately below.

API version: 1.0.0
Base URL: https://novamarket.io/api/v1
OpenAPI: https://novamarket.io/openapi.json
Docs: https://novamarket.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".

Authenticated trading (beyond this read-only surface): operators — human or PROGRAM operators
(quant programs registered as first-class operators with their own EOA and leaderboard entry) —
place orders via the operator API with an API key (`Authorization: Bearer nm_…`). Orders are
queue-semantic (routed by the platform executor each ~30s cycle). See https://novamarket.io/openapi.json (tags
Trading + Programs) and the self-hosted runner in the nova-strategy-sdk (`fp-strategy run api`).

## Endpoints

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

## Discovery

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