market-data-examples

Adona Robot market data: examples and MCP server

Runnable examples for the Adona Robot market-data API, and the configuration to connect an AI agent to its MCP server.

Adona Robot sells one-second OHLC candles and a live bid/ask quote stream for 46 FX pairs and 5 spot metals, over REST and WebSocket. It is priced by capacity: the month's peak of simultaneous connections and slices of 1000 bars, not per seat. Redistribution is allowed on every paid plan: show the data in your product, relay it to your own clients, keep what you receive. A symbol you follow live for more than 80% of its open hours in a month adds CHF 150 to that month's invoice, on top of the plan.

Facts as of 2026-10-03. The current ones are always on adona-robot.com and, machine-readable, in spec.json and symbols.json.

Plan	CHF a month, before VAT	Sized for (simultaneous connections)	Slices of 1000 bars a month
Trial, 7 days, free	0	3	2 500 a day
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

The trial carries EURUSD and XAUUSD with 7 days of history; every paid plan carries all 51 symbols. A paid plan never refuses a connection: the month's reading sets the next invoice's plan. Above Enterprise: sales@adona-robot.com.

1. Get a key

1. Open an account with your company email address (one trial per company).

2. Confirm the address, sign in, and create the key on your account page. It is shown once: keep it on your server, never in a web page or a repository.

3. Export it for the examples:

   export ADONA_API_KEY=YOUR_API_KEY
   

The quickstart walks through the same steps on the site.

2. How a call works

• Your API key stays on your server. It is exchanged at POST /v1/tokens for a twelve-hour token per end user of yours (end_user_id).
• History: GET /v1/candles?symbol=EURUSD&timeframe=S1, timeframes S1, M1, M5, M15, H1, H4, D1, up to 5000 bars a page, oldest first, prices as strings. next_before is the cursor to the page before (null when there is nothing older). On S1 a page covers one day, so an empty page with a cursor is an empty day (a weekend): continue with the cursor.
• Live: POST /v1/ws-ticket with the token gives a single-use ticket. Open wss://api.adona-robot.com/v1/stream offering two subprotocols, adona.data.v1 and ticket.<ticket> (never in the URL), then send a subscribe frame with channels such as quote:EURUSD and candle:EURUSD:M1.
• A refusal answers {"detail": "CODE"}: branch on the code. Every code and what to do about it is in the API reference, and the contract is machine-readable at openapi.json.

3. Examples

The Python and JavaScript history examples and the Python stream are the code of the quickstart's tabs, unchanged.

	History	Live stream
curl	curl/history.sh	curl/stream-ticket.sh (the ticket; a WebSocket client opens the stream)
Python 3.9+	python/history.py	python/stream.py
JavaScript	javascript/history.mjs, Node 18+	javascript/stream.mjs, Node 22+ (global WebSocket); the same frames as the quickstart's browser snippet

The Python examples need two packages, once: 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

Each one prints refused: with the status and the API's answer, and stops, when the API says no (a wrong key answers INVALID_CUSTOMER_KEY). For a browser, keep the key on your server and hand the page a token: the site publishes a token server and a browser client with reconnection, and history.py keeps a local store of the bars it has fetched, so closed history is paid for once.

The guides/ folder holds the code of the guides on the site, the same files: one-minute history, paged back (guides/history_m1.py), the live stream (guides/stream.mjs) and the MCP server for an agent (guides/mcp.sh). The Python guide shows python/history.py and python/stream.py.

check/run.sh runs every example once against production and prints OK or KO for each.

Notebooks and the Python client

Three notebooks open in Google Colab, with the API key taken from Colab's secrets (ADONA_API_KEY) or typed, never written into the notebook:

Notebook	What it does
notebooks/eurusd_1s.ipynb	The last hour of EURUSD at one second, as a pandas DataFrame, and its price updates per minute
notebooks/gold_live.ipynb	Thirty seconds of XAUUSD's live bid and ask, and its one-second bars as they close
notebooks/mcp.ipynb	The MCP server called by hand: the offer and a month's price without a key, candles with one

The first two use adona-market-data, the Python client (pip install "adona-market-data[all]"): candles paged back into pandas, the live stream with reconnection, and refusals with their code.

4. Symbols

46 FX pairs and 5 metals (XAUUSD, XAGUSD, XAUEUR, XPTUSD, XPDUSD). The list, with each symbol's history dates, is on adona-robot.com/en/symbols and in symbols.json; every symbol has its own page, for example EURUSD.

5. Connect an AI agent (MCP)

The MCP server is at https://api.adona-robot.com/mcp (streamable HTTP, stateless). Four tools:

Tool	What it answers	Key
get_offer	The plans, prices, limits, trial, continuous feed and links	No
list_symbols	Every symbol a paid plan carries, with its name and class	No
quote_price_for	The plan and the CHF total, before VAT, for a month of usage	No
get_candles	Candle history for one symbol, one page, oldest first	Yes, billed like GET /v1/candles

The key, when you want get_candles, travels on every call in the Authorization: Bearer header, or in an X-API-Key header for a client or gateway that keeps Authorization for itself (X-API-Key: YOUR_API_KEY, no Bearer). Send one key: two different keys in the two headers, or two different X-API-Key values, are refused as CONFLICTING_API_KEYS. Keep the key in an environment variable, not in a file you commit.

Claude Code: put mcp/claude-code.mcp.json in your project as .mcp.json (it reads ADONA_API_KEY from your environment; unset, the keyless tools still work), or add it from the command line:

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

Cursor: put mcp/cursor.mcp.json in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global); it reads ${env:ADONA_API_KEY}.

Claude Desktop and claude.ai: Customize, then Connectors, then Add custom connector, with the URL https://api.adona-robot.com/mcp and the authentication "No sign-in" (on Team and Enterprise, an owner adds it under Organization settings, then Connectors). The three keyless tools work as is. For get_candles, add the request header Authorization with the value Bearer YOUR_API_KEY, or X-API-Key with the value YOUR_API_KEY, where your account offers request headers (a beta, not yet open to every account).

Then ask, for example: "What would 40 simultaneous users cost on Adona Robot?"

Without a client, the server answers plain JSON-RPC: see curl/mcp.sh.

Support

support@adona-robot.com, by email on business days. Security reports: adona-robot.com/en/security.

The code in this repository is under the MIT License. The data you read with it is governed by the terms of service.