NovaAlpha · API 参考

所有端点列表与请求/响应示例 · 基础地址 https://novaalpha.vip/api

认证与用户

方法路径说明鉴权
POST/api/auth/register邮箱注册（含 birthday）-
POST/api/auth/login登录获取 JWT-
POST/api/auth/reset-password重置密码（邮箱+生日）-
GET/api/auth/me当前用户信息 + 余额JWT
GET/api/auth/oauth/redirectGoogle OAuth 跳转-
GET/api/auth/oauth/callback/googleGoogle OAuth 回调-

注册

curl -X POST https://novaalpha.vip/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"secret","birthday":"1990-01-01"}'

# → { "success": true, "data": { "id": 1, "email": "...", "balance_usdt": 0 } }

登录

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": "eyJhbGci...", "user": {...} } }

策略市场

方法路径说明鉴权
GET/api/strategies策略列表（分类/分页/搜索）-
GET/api/strategies/:id策略详情（含历史表现）-
GET/api/strategies/categories策略分类统计-
 
# 浏览免费策略
curl "https://novaalpha.vip/api/strategies?category=free&page=1&pageSize=20"

# → {
#   "success": true,
#   "data": [
#     { "id": 1, "code": "martin_ge", "name": "马丁格尔",
#       "category": "free", "is_free": 1, "monthly_fee_usdt": 0,
#       "performance_30d": 8.5, "max_drawdown_30d": 12.3, "total_users": 156 }
#   ],
#   "pagination": { "page": 1, "pageSize": 20, "total": 1 }
# }

订阅管理

方法路径说明鉴权
GET/api/subscriptions我的订阅列表JWT
POST/api/subscriptions创建订阅（扣费+启动策略）JWT
POST/api/subscriptions/:id/pause暂停策略JWT
POST/api/subscriptions/:id/resume恢复策略JWT
DELETE/api/subscriptions/:id取消订阅JWT
PUT/api/subscriptions/:id/params更新策略参数JWT
POST/api/subscriptions/:id/renew立即续费（延长 30 天）JWT
 
curl -X POST https://novaalpha.vip/api/subscriptions \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"strategy_id":2,"apikey_id":1,"custom_params":{"base_amount":0.002}}'

# → {
#   "success": true,
#   "data": {
#     "subscription": { "id": 5, "status": "active", "current_period_end": "..." },
#     "balance_after": 20.1
#   }
# }

交易所 API Key

方法路径说明鉴权
GET/api/apikeys我的 API Key 列表JWT
POST/api/apikeys添加 API Key（AES-256 加密存储）JWT
DELETE/api/apikeys/:id删除 API KeyJWT
POST/api/apikeys/:id/test测试 API Key 连通性JWT
 
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":"..."
  }'
# → { "success": true, "data": { "id": 1, "exchange": "okx", "label": "主账号" } }

⚠️ 建议交易所 API Key 只开交易权限，关闭提现权限，并设置 IP 白名单为平台服务器 IP。

交易与仪表盘

方法路径说明鉴权
GET/api/trading/dashboard仪表盘汇总JWT
GET/api/trading/trades交易记录（分页）JWT
GET/api/trading/positions当前持仓JWT
GET/api/trading/performance收益曲线（30d/90d/all）JWT
 
curl https://novaalpha.vip/api/trading/dashboard \
  -H "Authorization: Bearer <jwt>"

# → {
#   "success": true,
#   "data": {
#     "total_profit_usdt": 12.34,
#     "active_strategies": 2,
#     "total_trades": 86,
#     "balance_usdt": 45.6,
#     "active_positions": 1,
#     "subscriptions_summary": [...]
#   }
# }

支付与钱包

方法路径说明鉴权
GET/api/pay/wallet/balance余额 + 最近流水JWT
POST/api/pay/wallet/deposit创建充值订单（ClawPay USDT）JWT
GET/api/pay/wallet/transactions余额流水（分页）JWT
POST/api/pay/clawpay/callbackClawPay USDT 回调（HMAC 验签）签名
 
curl -X POST https://novaalpha.vip/api/pay/wallet/deposit \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"amount_usdt": 50}'

# → {
#   "success": true,
#   "data": {
#     "order_no": "NVA1691...",
#     "pay_url": "https://clawpay.click/cashier/...",
#     "amount_usdt": 50
#   }
# }

支付完成后 ClawPay 回调 /api/pay/clawpay/callback，验签通过后自动入账并写余额流水。

Agent 接口

方法路径说明鉴权
POST/api/agent/registerAgent 注册（kakan.email 自动分配）-
POST/api/agent/loginAgent 登录（api_key 或 email+password）-
GET/api/agent/meAgent 信息API Key
GET/api/agent/strategies可用策略列表API Key
POST/api/agent/subscribeAgent 代用户订阅API Key
GET/api/agent/dashboardAgent 仪表盘API Key
 
# 注册 Agent（自动分配 kakan.email 邮箱）
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" } }

# 代用户订阅
curl -X POST https://novaalpha.vip/api/agent/subscribe \
  -H "X-API-Key: nva_xxx..." \
  -H "Content-Type: application/json" \
  -d '{"user_id":10,"strategy_id":2,"apikey_id":3}'