TradeOnyx

TradeOnyx MCP 服务

将 TradeOnyx 连接到 Claude、ChatGPT、Gemini 或任何其他支持 MCP 的助手。通过语音记录交易，让助手为你读出交易日志，并让它根据你的实际交易历史作答，而不是凭空猜测。

TradeOnyx 是一款带有模式检测功能的交易日志工具：它能从 40 家经纪商导入交易，并通过 28 个检测器分析你自己的历史记录，找出交易中反复出现的模式。本仓库介绍其 MCP 服务，不包含任何产品代码。

49 个工具 · HTTP 上的 JSON-RPC 2.0 · 托管于德国

---

端点

https://tradeonyx.io/mcp

传输协议为 HTTP，使用 JSON-RPC 2.0。身份验证通过 Authorization 标头中的 Bearer 令牌进行。该服务实现了 initialize、tools/list 和 tools/call，并支持协议版本 2025-06-18。

未进行身份验证的调用会如实返回结果，而不会一直挂起：

curl -s -X POST https://tradeonyx.io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# {"jsonrpc":"2.0","id":null,"error":{"code":-32001,"message":"Unauthorized"}}

获取令牌

1. 在 tradeonyx.io 创建账户。账户免费，且无需提供付款信息。
2. 打开 Settings → Integrations，开始 7 天连接器试用。免费账户可开始一次。试用期结束后，连接器需要 Pro 或 Pro Plus；无论如何，交易日志、经纪商导入和税务导出始终免费。没有有效试用或套餐时发起的调用会被拒绝，并说明原因，不会只返回空结果。
3. 在同一页面创建 MCP 令牌。
4. 立即复制令牌。原始令牌只显示一次；系统只存储 SHA-256 哈希，因此令牌丢失后无法找回，只能重新创建。
5. 随时可以在同一页面撤销任何令牌。

令牌具有 256 位熵。请像对待密码一样保管它：它授予你对交易日志的全部访问权限。

连接助手

任何支持通过 HTTP 使用 MCP 的客户端都可以使用。对于通过 JSON 文件配置的客户端，格式如下：

{
  "mcpServers": {
    "tradeonyx": {
      "url": "https://tradeonyx.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

支持直接连接远程 MCP 的助手（例如 Claude 的 Connectors）可以通过自己的界面添加端点，包括使用 OAuth 流程，因此无需手动粘贴令牌。

可以用它做什么

以下是人们实际会用它做的一些事情：

• 用一句话记录交易。“我以 1.0840 买入 0.5 手 EURUSD，止损设在 1.0810，因为伦敦时段区间向上突破。”助手会填写字段，并将交易理由与交易一起写入日志。
• **通过交谈撰写晚间复盘。**助手会读出当天的交易，询问你当时的想法，并将回答保存为一条日志记录。
• 询问实际发生了什么。“我这个月哪些交易策略亏了钱，这些交易有什么共同点？”——依据你自己的数据，而不是凭空猜测。
• **为交易时段做准备。**在开盘前获取每日简报和计划中的交易方案。

工具

共有 49 个工具。45 个工具需要有效的连接器试用、Pro 或 Pro Plus；4 个批量聚合工具需要 Pro Plus。下表的 Plan 列会说明所需套餐。

每日工具调用上限按 UTC 日期计算，并显示在应用中：

套餐	每日调用次数
7 天试用	30
Pro	150
Pro Plus	2000

超过上限的调用会返回常规工具结果，其中 isError: true，并说明上限及重置时间，这样助手就能解释发生了什么，而不会无声失败。HTTP 状态码为 200：上限是业务规则，不是格式错误的请求；规范本身的工具执行错误示例就是上游速率限制。

错误如何返回

错误分为两个级别；错误类型可以告诉你应该在参数还是数据中修复问题：

• 参数错误会以 JSON-RPC 错误返回，错误代码为 -32602，且 data.code = "invalid_arguments"。这包括未知工具、工具不接受的参数名、 超出声明的 enum 范围的值，以及超出声明的 maxLength / maxItems / maximum 的值。 这些情况都已在你持有的 inputSchema 中声明，因此客户端可以自行修正，无需询问。
• 其他所有错误都会作为工具结果返回，其中包含 isError: true，并在 content 中附带消息：不存在的行、数据库无法存储的值、不包含该工具的套餐，以及每日上限。

两者的 HTTP 状态码都是 200，因为传输协议要求每个请求恰好对应一个 JSON 对象。超出声明上限的值会被拒绝，而非截短：5000 个字符的备注会因超出限制而被拒绝，而不是仅存储其前 2000 个字符，因此你保留的内容就是你发送的内容。

账户

工具	套餐	描述
account_list	Trial / Pro	列出用户的交易账户（id / name / type / is_active / FIFO-vs-LIFO）。is_active 标志表示仪表板上的活跃账户，其...
settings_get	Trial / Pro	读取账户级别的限额，纪律检查和每周摘要会强制执行这些限额：资金、每笔交易风险、每日和每周亏损限额、月度目标、是否允许隔夜持仓、时区。百分比会以百分比形式返回，同时包含账户货币的 risk_per_trade_amount。只读：无法通过连接器更改这些设置；策略工具上的 risk_per_trade 是每项策略的备注，不会改变此预算。

附件

工具	套餐	描述
attachment_upload_link_create	Trial / Pro	为截图创建一个单次使用、有效期为 10 分钟的浏览器上传链接。用户分享了你无法编码或通过 URL 传输的图像数据时使用此工具 — commo...

经纪商同步

工具	套餐	描述
broker_sync_trigger	Trial / Pro	手动触发与现有经纪商连接（Bybit、Alpaca、Binance 等）的同步。获取最新成交记录，按 FIFO 配对买入 / 卖出部分，并持久化 rou...

每日简报

工具	套餐	描述
briefing_get	Trial / Pro	读取某个市场类别（gbpusd、eurusd、forex、general、crypto）的缓存每日 AI 简报。如果没有简报，则返回 {briefing: null}。

经济事件

工具	套餐	描述
econ_analysis_get	Trial / Pro	按 event_id 读取某个经济日历事件的缓存 AI 分析。如果该事件没有 AI 运行记录，则返回 {analysis: null}。包含...
econ_analysis_list	Trial / Pro	按时间倒序列出最近缓存的经济事件 AI 分析。可选的 symbol 按 pairs_affected 中不区分大小写的子字符串进行筛选。返回 u...

日志

工具	方案	描述
journal_attachment_list	Trial / Pro	列出用户某篇日志条目中附带的所有截图。每个附件均返回 id、公开 URL、说明、mime type 和 uploaded_at。
journal_attachment_upload	Trial / Pro	将截图附加到用户某篇日志条目。首选路径（按优先级排序）：1. 如果用户分享了图片的 HTTPS URL（Tra...
journal_entry_get	Trial / Pro	读取指定日期的日志条目（如果没有，则返回 null）。
journal_entry_list	Pro Plus	列出指定日期范围内的日志条目。仅限 Pro Plus。
journal_entry_search	Trial / Pro	按词语或短语搜索用户自己的日志条目。多个词语按 AND 逻辑匹配；将短语放在双引号中可按原顺序匹配。搜索...
journal_entry_upsert	Trial / Pro	创建或更新指定日期的日志条目。必填：date (YYYY-MM-DD)。传入六个 Markdown 分区中的任意子集；其他分区保持不变...
journal_planned_playbook_clear	Trial / Pro	清除某个日历日的所有计划 playbook。此操作幂等——如果没有计划项，则返回 removed_count=0。如果...，则返回 journal_id=null
journal_planned_playbook_set	Trial / Pro	设置某个日历日的晨间计划 playbook。以原子方式替换现有集合——重复调用时幂等。如果不存在，则创建 JournalEntry...

市场数据

工具	方案	描述
market_heat_get	Trial / Pro	读取指定类别和日期的缓存 AI 市场热度值（hot / neutral / cold）。与 briefing_get 配合使用——热度反映日历压力（h...

新闻

工具	方案	描述
news_analysis_get	Trial / Pro	按 news_id 读取某条新闻标题的缓存 AI 分析。分析缓存为全局缓存（用户共享），因此你可能会看到由其他用户撰写的分析...
news_analysis_list	Trial / Pro	按时间倒序列出近期缓存的新闻分析。可选的 symbol 按 pairs_affected 列进行不区分大小写的子字符串筛选（例如 'EURUS...

模式

工具	方案	描述
pattern_narrative_get	Trial / Pro	读取调用者每周的跨模式 Onyx-Engine AI 叙述。每个（用户，ISO 周）对应一个工件；缓存每周一自动轮换...
pattern_recos_get	Trial / Pro	读取调用者每周的跨检测器行动建议。它与 pattern_narrative_get 类似——缓存轮换方式相同，但输出为严格列表...

操作手册

工具	方案	描述
playbook_create	Trial / Pro	创建包含入场/出场标准的新策略操作手册。必填：name（最多 80 个字符）。description / rules / entry_criteria / exit_criteria 均为可...
playbook_delete	Trial / Pro	软删除操作手册（设置 active=false）。历史交易归因保持不变——该操作手册只会从活动选择器中隐藏。此操作幂等。
playbook_list	Trial / Pro	列出用户的策略操作手册。可选的 account_id 会将结果缩小到该账户可见的操作手册（全局操作手册及该账户的操作手册）。省略则返回所...
playbook_update	Trial / Pro	修改现有操作手册。必填：playbook_id。任何省略的字段均保持不变。传入 active=false 可将其归档而不丢失历史记录（同...

统计

工具	套餐	描述
stats_summary	Pro Plus	汇总近期（默认 30 天）的绩效统计：胜率、期望值和总计。接受 tag_ids，可将每项数据限定为带有任意指定标签的交易；也接受 date_from / date_to，用于指定月份。仅限 Pro Plus。
tag_performance_get	Pro Plus	按标签统计已平仓交易的绩效：交易数量、胜率、毛利和净盈亏、盈利因子、平均盈利、平均亏损和期望值。用于回答“我的哪些交易策略确实能赚钱”。默认涵盖全部历史记录，因为标签需要足够的样本量。已平仓交易数量少于 min_trades（默认 5）的标签仍会按名称返回，但不提供数据，而非直接忽略。带有两个标签的交易会同时计入这两个标签，因此各行数据之和不会等于账户结果。仅限 Pro Plus。

策略

工具	套餐	描述
strategy_create	Trial / Pro	创建一个新的命名策略。用户创建的第一个策略会自动成为默认策略（分配给新交易和导入的交易）。所有载荷字段均为……
strategy_delete	Trial / Pro	永久删除一个策略。标记了该策略的交易会将 strategy_id 重置为 NULL（保留历史记录）。如果被删除的记录是默认策略，则下一个……
strategy_list	Trial / Pro	列出用户命名的交易策略（例如“Forex-Swing”“Crypto-Scalp”）。每行包含叙述 / 优势 / 策略设置 / 重点标的 / 规则 /……
strategy_set_default	Trial / Pro	将一个策略设为用户的默认策略。新交易和导入的交易会自动添加默认策略标签。关闭其他所有策略的 is_default。
strategy_update	Trial / Pro	修改一个命名策略。传入 strategy_id 和任意子集的载荷字段。提供的列表（setups、symbols_focus、rules、trading_hours）会替换已存储的列表，因此请发送所有要保留的条目；省略该字段则保持不变。因此，此工具标注为 destructiveHint: true，而 strategy_create 没有此标注。编辑任何字段都会使引用了该策略的 AI 上下文缓存失效……

标签

工具	套餐	描述
tag_create	Trial / Pro	在用户的标签库中创建一个新标签。必填：name（最多 40 个字符）。按名称保证幂等——如果该标签已……，则返回现有记录并设置 created=false
tag_delete	Trial / Pro	永久删除一个标签。如果该标签仍关联任何交易，则拒绝删除；错误消息会说明有多少个关联阻止了删除。
tag_list	Trial / Pro	列出用户的标签（策略设置 / 失误 / 心理状态 / 自定义）。
tag_update	Trial / Pro	重命名标签或更改其类别 / 颜色。必填：tag_id。返回 updated_fields，以便调用方确认哪些键已保存。错误信息为“……

交易

工具	套餐	描述
trade_ai_analysis_get	Trial / Pro	读取用户某笔交易已缓存的教练风格 AI 分析。每笔交易只分析一次——通过仪表板写入后，每次重新...
trade_attachment_list	Trial / Pro	列出用户某笔交易附带的所有截图。返回每个附件的 id、公开 URL、说明、mime type 和 uploaded_at。
trade_attachment_upload	Trial / Pro	为用户某笔交易添加截图。首选方式（按优先级排序）：1. 如果用户分享了图片的 HTTPS URL（TradingView...）
trade_create	Trial / Pro	手动插入一笔交易（开仓或已平仓）。必填：symbol、trade_type、volume、open_price。trade_type 必须为 'BUY' 或 'SELL'（大写）。open_ti...
trade_delete	Trial / Pro	删除一笔手动记录或通过此连接器记录的交易，以及关联的复盘、标签、附件和 AI 分析。拒绝删除从经纪商导入的交易：下次同步时会再次根据对账单进行核对。若交易填写错误且 gross_pl 此后无法编辑，可使用此工具撤回该交易。
trade_get	Trial / Pro	获取用户某笔交易的完整详情。
trade_list	Pro Plus	列出用户的交易。可按日期范围、symbol、标签（tag_ids，任一匹配）、方向（trade_type）或开仓／平仓状态筛选。最多返回 limit 行（默认值为 100，最大值为 500），按 open_time... 排序
trade_review_update	Trial / Pro	新增或更新某笔交易的交易后复盘。必填：trade_id。常见错误：mood_before/mood_after 必须是 1-5 的整数（不能是 'calm...' 等枚举字符串）
trade_update	Trial / Pro	编辑现有交易中用户可修改的字段：sl、tp、comment、external_url、playbook_id、strategy_id、target_rr、mfe_price、mae_price。还可平仓：对于仍处于开仓状态且非经纪商导入的交易，同时发送 close_price 和 close_time；当交易品种以账户货币报价时，将根据这两个价格计算 gross_pl。经纪商真实数据字段（gr...）

交易规则

工具	套餐	描述
trading_rule_create	Trial / Pro	创建新的纪律／交易规则。必填：text（规则标签，最多 200 个字符）。可选的 account_id 可将规则限定在某个账户；省略...
trading_rule_delete	Trial / Pro	删除用户的一条交易规则。该规则每次被违反的记录也会一并删除，因为日志中的规则违规条目会随规则删除。若要停止遵循某条规则但保留历史记录，请改用 trading_rule_update 并设置 active=false。
trading_rule_list	Trial / Pro	列出用户的纪律／交易规则。可选的 account_id 可筛选该账户可见的规则（全局规则 + 该账户的规则）。
trading_rule_update	Trial / Pro	修改或停用一条交易规则。必填：rule_id。传入 active=false 可软删除（规则会从选择器中消失，但保留历史记录）。account_...

每周摘要

工具	套餐	描述
weekly_digest_get	Trial / Pro	读取一份为调用者生成的每周 AI 摘要。该摘要是一篇在周日晚间发布的 600-800 字编辑简报。week 接受 ISO 格式的周一日期（例如...）

套餐

	免费	免费，试用进行中	Pro	Pro Plus
连接器访问权限	否	是，7 天，每个账户仅一次	是	是
每日工具调用次数	—	30	150	2000
日志 + 日记工具	—	是	是	是
批量汇总（trade_list、journal_entry_list、stats_summary、tag_performance_get）	—	否	否	是
网页应用中的日记、经纪商导入和税务导出	是	是	是	是

免费账户可在 Settings → Integrations 下启动一次连接器试用。试用启动前和到期后，连接器会对每次调用明确拒绝，并说明该怎么做；它不会返回空结果。网页应用本身始终免费。

价格和当前限制请见定价页面。

隐私与安全

• 服务器位于德国，你的日记和交易数据保留在欧盟境内。AI 功能会将其分析的文本发送给美国的处理方；所有处理方均列于隐私政策中，该政策是权威名单。
• 令牌以 SHA-256 哈希形式存储；原始值仅存在于你的剪贴板中。
• 每个工具都会通过已认证的用户解析数据。令牌只能访问其所属的账户。
• 删除 TradeOnyx 账户会清除相关数据，包括你的请求访问日志。

发现安全问题？请通过我们的 security.txt ([email protected]) 私下报告，而不要公开提交问题。

链接

• TradeOnyx
• 支持的经纪商
• 与其他交易日记工具的比较
• 模型上下文协议

免责声明

TradeOnyx 是一款文档与分析工具，不提供投资建议或投资经纪服务，也不会生成交易信号。交易金融工具可能导致投入资本全部损失。

许可证

本仓库中的文档采用 MIT 许可证。TradeOnyx 本身是商业产品，并非开源。