Adona Robot market data

Adona Robot 市场数据：示例和 MCP 服务

Adona Robot 市场数据 API 的可运行示例，以及将 AI Agent 连接到其 MCP 服务的配置。

Adona Robot 通过 REST 和 WebSocket 提供46 种外汇货币对和 5 种现货金属的 1 秒 OHLC 蜡烛图和实时报价（买价／卖价）流。价格按容量计算：取当月同时连接数峰值和每月 1000 根柱的切片数，而非按席位计费。所有付费套餐均允许再分发：可在产品中展示数据、转发给自己的客户端，以及保留收到的数据。如果某个符号在一个月内超过 80% 的开放时段都处于实时跟踪状态，则该月账单会在套餐费用之外增加 CHF 150。

信息截至 2026-10-03。最新信息始终可在 adona-robot.com 查看，也可通过机器可读文件 spec.json 和 symbols.json 获取。

套餐	每月 CHF，未含 VAT	适用规模（同时连接数）	每月 1000 根柱的切片数
试用版，7 天，免费	0	3	每天 2 500
Starter	500	30	750 000
Growth	1 200	100	2 500 000
Scale	2 400	300	7 500 000
Enterprise	5 000	1 000	25 000 000

试用版提供 EURUSD 和 XAUUSD，可查询 7 天的历史数据；所有付费套餐均提供全部 51 种符号。付费套餐绝不会拒绝连接：当月的用量统计决定下个月账单采用的套餐。超过 Enterprise 套餐规模，请联系 [email protected]。

1. 获取密钥

1. 使用公司邮箱地址注册账户（每家公司限一个试用账户）。

2. 确认邮箱地址，登录并在账户页面创建密钥。密钥只会显示一次：请保存在自己的服务端，切勿放在网页或代码仓库中。

3. 为示例导出密钥：

   export ADONA_API_KEY=YOUR_API_KEY
   

快速入门指南会在网站上介绍相同的步骤。

2. 调用方式

• API 密钥保存在自己的服务端。通过 POST /v1/tokens 为每位终端用户（end_user_id）换取一个有效期为 12 小时的令牌。
• 历史数据：GET /v1/candles?symbol=EURUSD&timeframe=S1，时间范围包括 S1、M1、M5、M15、H1、H4、D1；每页最多 5000 根柱，按时间从早到晚排列，价格以字符串表示。next_before 是指向上一页的游标（没有更早的数据时为 null）。在 S1 时间范围下，每页涵盖一天，因此带游标的空页面表示当天没有数据（周末）；请使用该游标继续查询。
• 实时数据：使用令牌调用 POST /v1/ws-ticket，获取一次性票据。连接 wss://api.adona-robot.com/v1/stream 时，提供两个子协议 adona.data.v1 和 ticket.<ticket>（切勿将票据放在 URL 中），然后发送 subscribe 帧，订阅 quote:EURUSD、candle:EURUSD:M1 等频道。
• 请求被拒绝时会返回 {"detail": "CODE"}：请根据代码进行处理。每个代码及对应处理方式均列于 API 参考，接口规范可通过 openapi.json 以机器可读格式查看。

3. 示例

Python 和 JavaScript 历史数据示例以及 Python 实时流示例的代码，均与 快速入门标签页中的代码完全相同。

	历史数据	实时流
curl	curl/history.sh	curl/stream-ticket.sh（用于获取票据；WebSocket 客户端会打开实时流）
Python 3.9+	python/history.py	python/stream.py
JavaScript	javascript/history.mjs，Node 18+	javascript/stream.mjs，Node 22+（全局 WebSocket）；与快速入门中的浏览器代码片段使用相同的帧

Python 示例只需安装两个包：pip install requests websockets。

./curl/history.sh                   # the latest 1000 EURUSD one-minute bars
python python/history.py            # the latest 1000 EURUSD one-minute bars
python python/stream.py             # quotes and one-minute bars, until Ctrl-C
node javascript/history.mjs
node javascript/stream.mjs quote:XAUUSD candle:XAUUSD:M1

当 API 拒绝请求时，每个示例都会显示 refused:、状态和 API 的答复，然后停止（密钥错误时会返回 INVALID_CUSTOMER_KEY）。在浏览器中使用时，请将密钥保存在服务器上，并向页面提供令牌： 该网站提供了带重连功能的token 服务端和 浏览器客户端，而 history.py会在本地保存已获取的 K 线数据，因此已收盘的历史数据只需付费一次。

guides/文件夹包含网站指南中的代码，文件与网站上的相同： 一分钟历史数据，分页回溯 （guides/history_m1.py）、实时流 （guides/stream.mjs）以及供 Agent 使用的 MCP 服务 （guides/mcp.sh）。Python 指南介绍了 python/history.py和python/stream.py。

check/run.sh会针对生产环境运行每个示例一次，并逐一显示 OK 或 KO。

Notebook 和 Python 客户端

三个 notebook 可在 Google Colab 中打开，API 密钥从 Colab 密钥（ADONA_API_KEY）中读取或手动输入，绝不会写入 notebook：

Notebook	功能
notebooks/eurusd_1s.ipynb	EURUSD 最近一小时的逐秒数据，以 pandas DataFrame 的形式呈现，并显示其每分钟价格更新
notebooks/gold_live.ipynb	XAUUSD 实时买价和卖价的 30 秒数据，以及收盘时生成的逐秒 K 线
notebooks/mcp.ipynb	手动调用 MCP 服务：无需密钥即可获取报价和一个月的价格数据，使用密钥则可获取蜡烛图

前两个 notebook 使用adona-market-data，这是 Python 客户端（pip install "adona-market-data[all]"）：分页回溯并载入 pandas 的蜡烛图数据、支持重连的实时流，以及包含错误代码的拒绝信息。

4. 交易品种

46 个外汇货币对和 5 种金属（XAUUSD、XAGUSD、XAUEUR、XPTUSD、XPDUSD）。包含各交易品种历史数据日期的列表，见 adona-robot.com/en/symbols 和 symbols.json；每个交易品种都有自己的页面，例如 EURUSD。

5. 连接 AI Agent（MCP）

MCP 服务位于 https://api.adona-robot.com/mcp（可流式传输的 HTTP，无状态）。提供四种工具：

工具	回答内容	是否需要密钥
get_offer	方案、价格、限制、试用、持续数据流和链接	否
list_symbols	付费方案包含的所有代码及其名称和类别	否
quote_price_for	使用一个月对应的方案和 CHF 总金额（不含增值税）	否
get_candles	单个代码的 K 线历史记录，单页，按时间从早到晚排列	是，按 GET /v1/candles 的方式计费

使用 get_candles 时，密钥需随每次调用通过 Authorization: Bearer 标头传递；如果客户端或网关会独占 Authorization，也可以通过 X-API-Key 标头传递（X-API-Key: YOUR_API_KEY，不带 Bearer）。只发送一个密钥：如果两个标头中有不同的密钥，或 X-API-Key 有两个不同的值，系统会拒绝请求并返回 CONFLICTING_API_KEYS。请将密钥保存在环境变量中，不要存入会提交的文件。

Claude Code：将 mcp/claude-code.mcp.json 放入项目并命名为 .mcp.json（它会从环境中读取 ADONA_API_KEY；如果未设置，仍可使用无需密钥的工具），或者通过命令行添加：

claude mcp add --transport http adona-robot https://api.adona-robot.com/mcp \
  --header "Authorization: Bearer $ADONA_API_KEY"

Cursor：将 mcp/cursor.mcp.json 放入 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）；它会读取 ${env:ADONA_API_KEY}。

Claude Desktop 和 claude.ai：依次选择 Customize、Connectors、Add custom connector，输入 URL https://api.adona-robot.com/mcp，并选择身份验证方式 "No sign-in"（对于 Team 和 Enterprise，由所有者在 Organization settings 中添加，随后进入 Connectors）。三个无需密钥的工具可以直接使用。要使用 get_candles，请在账号支持请求标头的情况下，添加请求标头 Authorization，值为 Bearer YOUR_API_KEY；或添加 X-API-Key，值为 YOUR_API_KEY（该功能仍处于测试阶段，尚未向所有账号开放）。

然后可以询问，例如：“Adona Robot 上 40 个并发用户需要多少钱？”

没有客户端时，服务会返回纯 JSON-RPC 响应：请参阅 curl/mcp.sh。

支持

工作日请发送电子邮件至 [email protected]。安全问题报告： adona-robot.com/en/security。

本仓库中的代码采用 MIT License。通过它读取的数据受服务条款约束。