NovaAlpha · 开发者文档

加密货币量化策略租赁平台 · API / Agent / CLI / Python 策略引擎接入指南

API 概览

所有 API 均以 JSON 格式请求与响应，基础地址 https://novaalpha.vip/api。除公开接口外，均需在请求头携带 Authorization: Bearer <token> 或 X-API-Key: <key>。

模块前缀说明鉴权
认证与用户/api/auth注册 / 登录 / 重置密码 / Google OAuth混合
策略市场/api/strategies策略列表 / 详情 / 分类公开
订阅管理/api/subscriptions创建 / 暂停 / 恢复 / 取消 / 续费用户 JWT
交易所 API Key/api/apikeysOKX / Binance 密钥管理（加密存储）用户 JWT
交易与仪表盘/api/trading仪表盘汇总 / 交易记录 / 持仓 / 收益曲线用户 JWT
支付与钱包/api/pay余额 / 充值 / ClawPay USDT 回调混合
Agent 接口/api/agentAgent 注册 / 代订阅 / 代交易API Key
客服问答/api/lookhereLookHere AI 问答代理公开
管理后台/api/admin策略上下架 / 用户管理 / 数据统计Admin

完整端点列表与请求/响应示例见 API 参考。

认证方式

NovaAlpha 支持三种身份，对应三种鉴权方式：

JWT Token

用户邮箱/Google 登录后获取，7 天有效。用于 Web 界面与订阅管理。

Authorization: Bearer <jwt>
API Key

nva_ 开头，长期有效。仅 Agent 可用，用于 CLI / 脚本调用。

X-API-Key: nva_xxxxxxxx
Google OAuth

跳转 Google 授权后回调换取 JWT，适合无密码登录。

GET /api/auth/oauth/redirect

获取 JWT

curl -X POST https://novaalpha.vip/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"secret"}'
# → { "success": true, "data": { "token": "eyJ...", "user": {...} } }

获取 API Key（Agent）

curl -X POST https://novaalpha.vip/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"name":"我的量化Agent"}'
# → { "success": true, "data": { "api_key": "nva_xxx...", "email": "auto@kakan.email" } }

未提供 email 时平台会通过 kakan.email 自动分配一个邮箱。

快速开始

  1. 注册并充值：邮箱注册 → 调用 POST /api/pay/wallet/deposit 创建 ClawPay USDT 充值订单 → 扫码支付到账。
  2. 添加交易所 API Key：POST /api/apikeys（建议只开交易权限，关闭提现）。
  3. 选择策略并订阅：浏览 GET /api/strategies → POST /api/subscriptions（自动扣月费、启动策略进程）。
  4. 监控运行：GET /api/trading/dashboard 查看总盈亏 / 活跃策略 / 持仓。

端到端示例（用户 JWT 流程）

# 1. 充值 50 USDT
curl -X POST https://novaalpha.vip/api/pay/wallet/deposit \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"amount_usdt": 50}'
# → { "data": { "order_no": "NVA...", "pay_url": "https://clawpay.click/..." } }

# 2. 添加 OKX API Key
curl -X POST https://novaalpha.vip/api/apikeys \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"exchange":"okx","label":"主账号","api_key":"...","api_secret":"...","passphrase":"..."}'

# 3. 订阅马丁格尔策略（strategy_id=1, apikey_id=1）
curl -X POST https://novaalpha.vip/api/subscriptions \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"strategy_id":1,"apikey_id":1}'

# 4. 查看仪表盘
curl https://novaalpha.vip/api/trading/dashboard \
  -H "Authorization: Bearer <jwt>"

收费结构

项目费用说明
马丁格尔策略免费引流策略，体验零成本
付费策略$29.9 / 月每个策略独立订阅，预存扣费
利润分成10%按策略月度利润计算，月末结算
支付方式USDTClawPay USDT 网关（BSC 链）

余额不足时策略自动暂停；月末利润分成从余额扣除，不足部分顺延。

Python 策略引擎

策略由独立的 Python 子进程执行（engine/runner.py），Node.js 后端通过 child_process.spawn 调用，参数全部通过环境变量传递。

策略接口

def run(exchange, symbol, timeframe, params):
    """
    :param exchange:  ccxt 实例（已配置 API Key）
    :param symbol:    "BTC/USDT"
    :param timeframe: "1h"
    :param params:    dict，策略参数
    :return: {"action": "buy"|"sell"|"hold", "amount": float, "price": float, "reason": str}
    """

策略开发规范详见 engine/strategies/README.md；内置示例：free/martin_ge.py、trend/ma60_rebound.py。

错误码

错误响应格式

{
  "error": {
    "message": "余额不足，需 29.9 USDT，当前余额 5 USDT",
    "type": "insufficient_balance"
  }
}

HTTP 状态码

状态码含义
200成功
400参数错误（invalid_request）
401未授权 / Token 无效（authentication_error）
402余额不足（insufficient_balance）
403禁止访问 / 权限不足
404资源不存在（not_found）
409冲突（如已订阅该策略，already_subscribed）
429请求过于频繁（限流）
500服务器错误（server_error）
502上游网关错误（gateway_error）

常见业务错误码