onv-mcp

【持仓与执行】我的跨所账户总览：各交易所余额、持仓与币种归并（无凭证返回空）。（cost: free）

【策略】AI 生成策略代码（写操作，需用户确认）：输入自然语言 prompt（可选 context 传入研究流水线结构化学徒上下文），返回策略代码与解释。（cost: ≈ 36–48 credits/次（按实际 tokens 结算））（写操作，外部调用将以 apikey 身份直接执行）

【策略】AI 多轮优化策略（写操作，需用户确认）：输入 prompt 描述策略目标，自动生成→回测→分析→改进（最多 maxRounds 轮，1-5，默认 3）。耗时较长。给了 initialCode 时第 1 轮不生成：直接回测这份既有代码作基线，第 2 轮起在其上改进（A3）。strategyParams 为指标参数覆盖（对齐 /api/cex/indicator/backtest 的 params）。context 为可选结构化学徒上下文（B2-a，失败因子/评审结论/目标指标），独立注入 LLM。每轮回传 rounds[].params（本轮实际生效参数）与 rounds[].errorCode（失败原因可判定）；全轮未产出代码时返回 502/429 + errorCode，不再返回空 finalCode。（cost: ≈ 34–38 credits/轮（按实际 tokens 结算））（写操作，外部调用将以 apikey 身份直接执行）

【策略】查询回测历史（可指定策略 ID 过滤）。参数 strategyId 可选。（cost: free）

【策略】查询回测任务结果。参数 jobId 为 run_backtest 返回的任务 ID。（cost: free）

【持仓与执行】撤销未成交挂单（写操作，需确认）：exchangeOrderId 与 clientOrderId 二选一。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【持仓与执行】平仓（写操作，需确认）：按 credentialId + symbol 平掉持仓；closeScope=full 全平，传 size 时部分平。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【持仓与执行】一键全平预演（dry-run，不会下单）：列出将被平仓的合约持仓 / 现货余额目标与合计盈亏。可按凭证或交易对过滤。（cost: free）

【账户与额度】查询我绑定的交易所凭证（脱敏，不含密钥）。返回凭证 ID/交易所/名称，供下单、平仓、查询使用。（cost: free）

【行情】链上 DEX 报价（只读）：chain 如 ETH/BSC/BASE/SOL，fromToken/toToken 为代币地址或符号，amount 为最小单位字符串。（cost: free）

【持仓与执行】链上 DEX 兑换（写操作，需确认，动用真实资金）：钱包地址自动取本人智能账户，不接受任意地址；大额授权需 approvalToken（由平台签发）。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【行情】解释一次回测「为什么亏 / 为什么没成交」。返回结构化卡片（数据区间、样本内外、最大回撤、数据缺失）与逐条原因。参数 runId / jobId / strategyId 至少给一个，三选一即可。（cost: free）

【行情】解释一次回测里各因子对收益的贡献：同一指标代码 / 区间 / 参数，逐个剔除一个因子列重跑，用指标差分（基准 − 剔除后）给出边际贡献，并把每个数字的 source 写明（基准结果 / ablate(id)）。参数 runId / jobId 至少给一个，maxFactors 可选（默认 3，最大 5）。（cost: free）

【行情】解释我的持仓与账户风控：逐仓名义价值 / 未实现盈亏 / 杠杆，以及账户敞口、当日盈亏、保证金使用率、熔断状态。返回结构化卡片，每个数字带 source（来源接口 + 字段），narrative.traces 写明口径公式；不做收益预测。（cost: free）

【策略】发起策略工厂运行（写操作，需确认）：sourceType=llm（描述生成）/search（条件扫描）/optimize（优化现有策略，需 strategyId）。同一用户同时只允许一个运行。（cost: base 5 + 10/1k bars（>10000 部分 5/1k） + 1/1k tokens credits）（写操作，外部调用将以 apikey 身份直接执行）

【策略】查询我的策略工厂运行记录；传 runId 时返回该次运行详情。（cost: free）

【持仓与执行】一键全平（写操作，需确认）：默认 dryRun=true 只预演；确认执行须显式 dryRun=false。可按凭证/交易对/市场类型限定，marketType=spot 时清现货余额。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【策略】获取单个已发布的公开 AI 助理（策略）详情。参数 agentId 为策略 ID。（cost: free）

【策略】列出平台上已发布的公开 AI 助理（策略），可按能力过滤与分页。参数 capabilities 可选（如 dex/defi）。（cost: free）

【策略】管理自己的策略（写操作，需用户确认）。action 为 create / update / delete；update/delete 需要 strategyId；create/update 用 data 传策略数据（data.name 必填，data.strategy_category 为 dex/defi）。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【行情】查询标的的市场因子数据（技术/宏观因子）。参数 symbol 为交易标的。（cost: free）

【行情】市场总览：主流币种快照、涨跌幅、成交量等市场状态概览。（cost: free）

【行情】查询平台行情 K 线。参数 symbol 为交易标的（如 BTCUSDT / ETHUSDT），timeframe 可选 1m/5m/15m/30m/1H/4H/1D，limit 最大 299。返回该标的的 K 线数组。（cost: free）

【行情】查询标的实时行情 ticker。参数 symbol 为交易标的（如 BTCUSDT，可选，缺省返回全部）。（cost: free）

【策略】查询我创建的策略市场/订阅域策略列表（onv-backend strategies 表，按钱包地址归属，邮箱注册账号回退按数字 userId）。⚠️ 不含实盘策略——实盘策略在 qd_strategies_trading，请用 REST GET /api/cex/strategies（该端点不支持 status 过滤，返回全部状态）。status 可选 draft/published/archived（缺省三者全取）。（cost: free）

【持仓与执行】真实下单（写操作，需确认，动用真实资金）：credentialId 来自 platform_credentials，amount 为 USDT 名义金额；orderType=market|limit，限价单必填 price。执行前校验账号级「AI 实盘授权」，未开启一律拒绝。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【账户与额度】查询平台订阅套餐列表（免费/付费 tier 与价格）。无需参数。（cost: free）

【持仓与执行】我的全部持仓（跨交易所扁平化，含方向/数量/开仓价/未实现盈亏）。可按交易所或交易对过滤。（cost: free）

【策略】发布策略（写操作，需用户确认）。name 必填、category 为 dex/defi；code 为策略代码（可选）；subscription_price 订阅价格；strategy_id 可指定已有草稿发布。发布为公开上架。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【行情】对指定标的进行快速 AI 技术分析（拉取行情并生成分析结论）。参数 symbol 为交易标的，如 BTCUSDT。（cost: ≈ 22–28 credits/次（按实际 tokens 结算））

【账户与额度】人工解除熔断（写操作，需确认）：须提供 recoveryCode；解除后策略恢复实盘执行。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【账户与额度】查询我的账户级风控面板：配置、熔断状态、聚合风险与策略风险。（cost: free）

【策略】提交回测任务（写操作，需用户确认）。strategy 为策略代码字符串或已有策略 ID（纯数字），symbol 为交易标的如 BTCUSDT，timeframe 可选 1m/5m/15m/30m/1H/4H/1D。params 为指标参数覆盖（可选，写入引擎 indicator_params，与代码内 # @param 默认值合并、此处优先），与同步链 /api/cex/indicator/backtest 的 params 同口径。（cost: ≈ 27 credits/次（90d·1H））（写操作，外部调用将以 apikey 身份直接执行）

【账户与额度】更新账户熔断配置（写操作，需确认）：enabled 开关，可设日亏损上限、连续失败次数、gas 尖峰上限。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【账户与额度】更新账户级风控配置（写操作，需确认）：config 为要修改的字段对象（如日亏损上限、单笔上限）。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【持仓与执行】查询实盘策略的绩效（策略级，按实盘策略 ID）：权益曲线、最新权益、区间收益与点数。ID 取自 qd_strategies_trading。（cost: free）

【持仓与执行】查询实盘策略的持仓（策略级，按实盘策略 ID）。⚠️ ID 取自 qd_strategies_trading（REST GET /api/cex/strategies），不是策略市场/订阅域的 strategies 表 ID。返回方向/数量/开仓价/未实现盈亏。（cost: free）

【持仓与执行】查询实盘策略的成交记录（策略级，按实盘策略 ID；含平仓原因与模拟盘标记）。ID 取自 qd_strategies_trading。（cost: free）

【账户与额度】订阅引导（写操作，需用户确认）：为指定 AI 助理生成订阅引导信息（周期可选 day/week/month/year），确认后返回订阅链接与支付信息，不自动扣费。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【账户与额度】购买平台套餐（写操作，需用户确认）：plan_id 必填（来自 platform_plans），period 可选 day/week/month/year，payment_method 可选 chain/x402。创建支付订单，支付在平台完成。（cost: free）（写操作，外部调用将以 apikey 身份直接执行）

【账户与额度】查询我的订阅列表。无需参数。（cost: free）

【账户与额度】查询对某 AI 助理的订阅状态。参数 strategyId 或 agentId。（cost: free）

【行情】搜索平台支持的交易标的（币种/交易对）。参数 query 为关键词如 BTC。（cost: free）

【持仓与执行】查询我的最近成交记录（默认 50 条，最多 200）。（cost: free）

【账户与额度】查询我的平台套餐订阅状态（当前套餐/到期时间）。无需参数。（cost: free）

【账户与额度】查询我的平台用量汇总（今日 bars / 本月 tokens / 剩余配额）。无需参数。（cost: free）