adona-robot-com API

openapi: 3.1.0
info:
  title: adona-robot-com API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 4 operation(s) read from 40 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; adona-robot-com has published no machine-readable contract that
    the pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 2
    documentation: 2
    pages-with-code: 34
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://adona-robot.com/en/reference
  - https://api.adona-robot.com/v1/openapi.json
  - https://adona-robot.com/en/use/live-gold-price-api
  - https://adona-robot.com/en/use/real-time-forex-api
  - https://adona-robot.com/en/use/1-second-fx-data-api
  - https://adona-robot.com/en/use/swiss-market-data-api
  - https://adona-robot.com/en/use/forex-ohlc-candles-api
  - https://adona-robot.com/en/use/gold-price-in-euros-api
  - https://adona-robot.com/en/use/precious-metals-price-api
  - https://adona-robot.com/en/quickstart
  - https://adona-robot.com/examples/browser.ts
  - https://adona-robot.com/en/use/forex-api-json
  - https://adona-robot.com/examples/token-server.ts
  - https://adona-robot.com/en/use/gold-price-websocket
  - https://adona-robot.com/en/use/forex-websocket-price-stream
  - https://api.adona-robot.com
  - https://api.adona-robot.com\
  - https://api.adona-robot.com\\\
  - https://adona-robot.com/en/security
  - https://adona-robot.com/en/use/redistributable-forex-data-feed
  - https://adona-robot.com/en/use/market-data-redistribution
  - https://adona-robot.com/en/use/display-forex-rates-in-your-app
  - https://adona-robot.com/en/use/tick-volume
  - https://adona-robot.com/en/use/one-second-ohlc-vs-tick-data
  - https://adona-robot.com/en/use/market-data-mcp-server-ai-agent
  - https://adona-robot.com/en/symbols/audcad
  - https://adona-robot.com/en/symbols/audchf
  - https://adona-robot.com/en/symbols/audjpy
  - https://adona-robot.com/en/symbols/audnzd
  - https://adona-robot.com/en/symbols/audsgd
  - https://adona-robot.com/en/symbols/audusd
  - https://adona-robot.com/en/symbols/cadchf
  - https://adona-robot.com/en/symbols/cadjpy
  - https://adona-robot.com/en/symbols/chfjpy
  - https://adona-robot.com/en/symbols/euraud
  - https://adona-robot.com/en/symbols/eurcad
  - https://adona-robot.com/en/symbols/eurchf
  - https://adona-robot.com/en/symbols/eurdkk
  - https://adona-robot.com/en/symbols/eurgbp
  - https://adona-robot.com/en/symbols/eurjpy
paths:
  /v1/candles:
    get:
      operationId: get_v1_candles
      tags:
      - Candles
      summary: GET /v1/candles
      x-source: https://adona-robot.com/en/reference
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: symbol
        in: query
        required: false
        schema:
          type: string
      - name: timeframe
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CandlesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s ''https://api.adona-robot.com/v1/candles?symbol=EURUSD&timeframe=S1&limit=1000''  -H "Authorization: Bearer $TOKEN"
          OpenAPI 3.1, for your tools Point your client generator, Postman or your agent at this URL. Copy code https://api.adona-robot.com/v1/openapi.json
          Authentication Two secrets, both on Authorization: Bearer . A long-lived API key ( adk_live_… ) is exchanged at POST /v1/tokens for '
  /v1/tokens:
    get:
      operationId: get_v1_tokens
      tags:
      - Tokens
      summary: Exchange the API key for a short-lived token.
      x-source: https://adona-robot.com/en/use/swiss-market-data-api
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token with the API key
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1TokensResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_tokens
      tags:
      - Tokens
      summary: POST /v1/tokens
      x-source: https://adona-robot.com/en/reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1TokensRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1TokensResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s https://api.adona-robot.com/v1/tokens  -H ''Content-Type: application/json''  -H "Authorization: Bearer $ADONA_API_KEY"  -d
          ''{"end_user_id":"u-42"}'')

          TOKEN=$(echo "$RESP" | grep -o ''"access_token":"[^"]*'' | cut -d''"'' -f4)

          [ -n "$TOKEN" ] || echo "refused: $RESP"'
  /v1/ws-ticket:
    post:
      operationId: post_v1_ws_ticket
      tags:
      - Ws Ticket
      summary: A single-use ticket to open the live stream.
      x-source: https://adona-robot.com/en/reference
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1WsTicketResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetV1CandlesResponse:
      type: object
      properties:
        symbol:
          type: string
        timeframe:
          type: string
        candles:
          type: array
          items:
            type: object
            properties:
              time:
                type: string
                format: date-time
              open:
                type: string
              high:
                type: string
              low:
                type: string
              close:
                type: string
              volume:
                type: string
        next_before:
          type: string
          format: date-time
    GetV1TokensResponse:
      type: object
      properties:
        access_token:
          type: string
          description: Short-lived token for reading candles
    PostV1TokensRequest:
      type: object
      properties:
        end_user_id:
          type: string
    PostV1TokensResponse:
      type: object
      properties:
        symbol:
          type: string
        timeframe:
          type: string
        candles:
          type: array
          items:
            type: object
            properties:
              time:
                type: string
                format: date-time
              open:
                type: string
              high:
                type: string
              low:
                type: string
              close:
                type: string
              volume:
                type: string
        next_before:
          type: string
          format: date-time
    PostV1WsTicketResponse:
      type: object
      properties:
        ticket:
          type: string
          description: Single use. Open wss://<host>/v1/stream offering two subprotocols, adona.data.v1 and ticket.<ticket> ; never put the ticket
            in the URL.
        expires_in_seconds:
          type: integer
          description: Seconds before an unused ticket expires.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Candles
- name: Tokens
- name: Ws Ticket