Adona Robot market data

Adona Robot の市場データ：使用例と MCP サーバー

Adona Robot の市場データ API を使った実行可能なサンプルと、AI エージェントをその MCP サーバーに接続するための設定です。

Adona Robot は、46 種類の FX ペアと 5 種類のスポット金属について、1 秒足の OHLC ローソク足と、リアルタイムのビッド／アスク価格ストリームを REST と WebSocket 経由で提供しています。料金は容量に応じて決まり、月内の同時接続数のピークと 1000 本単位のバー数が基準です。座席数による課金ではありません。すべての有料プランで再配信が許可されています。データを製品に表示したり、自社のクライアントに中継したり、受信したデータを保存したりできます。月内に取引時間の 80％を超えてリアルタイムで購読したシンボルには、プラン料金に加えて、その月の請求額に 150 CHF が追加されます。

情報は 2026-10-03 時点のものです。最新情報は常に adona-robot.com に掲載され、機械可読形式では spec.json と symbols.json で確認できます。

プラン	月額 CHF、VAT 別	対象となる同時接続数	月間 1000 本単位のバー数
トライアル、7 日間、無料	0	3	1 日あたり 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. 会社のメールアドレスでアカウントを作成します（トライアルは 1 社につき 1 つです）。

2. メールアドレスを確認してサインインし、アカウントページでキーを作成します。キーは一度だけ表示されます。サーバー上に保管し、Web ページやリポジトリには決して置かないでください。

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 で、1 ページあたり最大 5000 本、古い順に価格が文字列として返されます。next_before は前のページを取得するためのカーソルです（それより古いデータがない場合は null）。S1 では 1 ページが 1 日分をカバーするため、カーソル付きの空ページはデータのない日（週末）を表します。カーソルを使って続行してください。
• リアルタイムデータ：トークンを使って POST /v1/ws-ticket を呼び出し、1 回限りのチケットを取得します。wss://api.adona-robot.com/v1/stream に接続する際、adona.data.v1 と ticket.<ticket> の 2 つのサブプロトコルを指定します（チケットを URL に含めないでください）。次に、quote:EURUSD や candle:EURUSD:M1 などのチャネルを指定した subscribe フレームを送信します。
• 拒否された場合は {"detail": "CODE"} が返されます。コードに応じて処理を分岐してください。各コードと対処方法はAPI リファレンスに記載されています。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 の例では、パッケージを 2 つ、一度だけインストールする必要があります：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 がリクエストを拒否した場合は、それぞれステータスと API の応答を付けて refused: と表示し、停止します（誤ったキーの場合は INVALID_CUSTOMER_KEY が返されます）。ブラウザーから利用する場合は、キーをサーバー上に保管し、ページにはトークンを渡してください。サイトでは、再接続機能付きのトークンサーバーと ブラウザークライアントを公開しています。また、 history.pyは取得済みのバーをローカルに保存するため、確定済みの履歴に対する支払いは一度で済みます。

guides/フォルダーには、サイト上のガイドと同じファイルのコードが含まれています： 1 分足の履歴をページ単位で遡る （guides/history_m1.py）、ライブストリーム （guides/stream.mjs）、エージェント向け MCP サーバー （guides/mcp.sh）。Python ガイドでは、 python/history.pyとpython/stream.pyを紹介しています。

check/run.shは、すべての例を本番環境に対して一度実行し、それぞれについて OK または KO を表示します。

ノートブックと Python クライアント

3 つのノートブックは Google Colab で開き、API キーは Colab のシークレット （ADONA_API_KEY）から取得するか、入力します。ノートブックに書き込むことはありません：

ノートブック	内容
notebooks/eurusd_1s.ipynb	1 秒間隔の EURUSD の直近 1 時間分を pandas DataFrame として表示し、1 分ごとの価格更新も確認します
notebooks/gold_live.ipynb	XAUUSD のライブのビッドとアスクを 30 秒間表示し、1 秒足の確定も確認します
notebooks/mcp.ipynb	MCP サーバーを手動で呼び出します。キーなしでオファーと 1 か月分の価格を、キーありでローソク足を取得します

最初の 2 つでは、adona-market-dataという Python クライアント（pip install "adona-market-data[all]"）を使用します。pandas へのページ単位のローソク足取得、再接続機能付きのライブストリーム、およびコード付きの拒否応答を確認できます。

4. シンボル

FX ペア 46 種と金属 5 種（XAUUSD、XAGUSD、XAUEUR、XPTUSD、XPDUSD）です。各シンボルの履歴の日付を含む一覧は、adona-robot.com/en/symbolsおよび symbols.jsonにあります。各シンボルには専用ページがあり、たとえばEURUSDがあります。

5. AI エージェントを接続する（MCP）

MCP サーバーは https://api.adona-robot.com/mcp にあります（ストリーミング可能な HTTP、ステートレス）。ツールは 4 つあります。

ツール	回答する内容	キー
get_offer	プラン、料金、制限、トライアル、継続的なフィード、リンク	不要
list_symbols	有料プランで利用できるすべてのシンボルと、その名称およびクラス	不要
quote_price_for	1 か月の利用に対するプランと VAT 抜きの合計金額（CHF）	不要
get_candles	1 つのシンボルのローソク足履歴を 1 ページ分、古い順に表示	必要。GET /v1/candles と同様に課金されます

get_candles を使う場合、キーはすべての呼び出しで Authorization: Bearer ヘッダーに含めるか、Authorization を自身で使用するクライアントまたはゲートウェイでは X-API-Key ヘッダーに含めてください（X-API-Key: YOUR_API_KEY。Bearer は不要です）。キーは 1 つだけ送信してください。2 つのヘッダーで異なるキーを指定したり、異なる X-API-Key 値を 2 つ指定したりすると、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：［カスタマイズ］、［コネクタ］、［カスタムコネクタを追加］の順に選択し、URL に https://api.adona-robot.com/mcp、認証に「サインインなし」を指定します（Team と Enterprise では、オーナーが［組織の設定］から［コネクタ］を選択して追加します）。キー不要の 3 つのツールはそのまま使えます。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 ライセンス に基づいています。取得したデータには利用規約が適用されます。