只读 · 无鉴权 · CORS

NovaMarket Agent API

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

机器可发现

OpenAPI 3.1 llms.txt llms-full.txt agents.json ai-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://novamarket.io/api/v1

curl

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

JavaScript

const r = await fetch("https://novamarket.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://novamarket.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 为只读数据，非投资建议。机制

策略接入 SDK

量化开发者写一个策略类即可在确定性回测与真实场馆上以同一份逻辑运行。策略的 name 就是资金池链上的 strategyType 文本——声明该名称发起/认领池子，即表示用此策略操盘。策略由开发者自定义，平台不预设。

SDK 源码 · README

from strategy_sdk import StrategyBase, register, indicators as ind

@register("我的趋势")                 # 名称 = 链上 strategyType
class MyTrend(StrategyBase):
    params = {"fast": 10, "slow": 30, "size": 5.0}
    async def on_tick(self, ctx):     # 每 tick 调用
        sym = ctx.conn_symbol()
        hist = await ctx.history(sym, 31)
        f, s = ind.ema(hist, 10), ind.ema(hist, 30)
        if f and s:
            await ctx.target(sym, 5.0 if f > s else 0.0)   # 调到目标仓位

# 回测:  fp-strategy backtest 我的趋势 --seed 7 --steps 300

ctx 提供 price/history/position/equity 与 buy/sell/target/flatten（自带 max_position/max_order 风控）；指标含 sma/ema/rsi/zscore/bollinger/atr。回测用内置确定性模拟（GBM 种子，可复现）或接 Hyperliquid 真实 K 线。

趋势fast / slow / size

EMA 快慢线交叉，趋势做多、否则离场

回测 240 步收益 4.97%Sharpe 0.96最大回撤 4.40%

均值回归window / k / size

z-score 偏离均值买入、回归离场

回测 240 步收益 4.43%Sharpe 2.16最大回撤 1.39%

做市ref_window / max_inventory / spread

围绕中间价的库存偏移，越便宜持仓越多

回测 240 步收益 9.06%Sharpe 2.79最大回撤 1.40%

网格grid_pct / levels / unit

区间等距网格，每跌一格加仓、每涨一格减仓

回测 240 步收益 4.01%Sharpe 1.32最大回撤 2.01%

回测曲线为确定性模拟行情下的示例（同一价格路径），仅供演示策略行为，不代表真实收益。