naftiko: 1.0.0-alpha2
info:
  label: ValueRay Symbol Data API
  description: Aggregated AI-ready snapshot of technical, quantitative, sentiment,
    risk, and performance data for a single stock or ETF symbol, optimized for
    consumption by AI agents and LLMs.
  tags:
    - ValueRay
    - AI/LLM
    - ETF
    - Financial Data
    - Quantitative
    - Stocks
    - Technical Analysis
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
    - type: http
      namespace: valueray
      baseUri: https://www.valueray.com/api/v1
      description: ValueRay Symbol Data HTTP API.
      resources:
        - name: symbol-data
          path: /symbolData
          operations:
            - name: getSymbolData
              method: GET
              description: Retrieve AI-ready aggregated symbol data for a stock or ETF.
              inputParameters:
                - name: symbol
                  in: query
                  type: string
                  required: true
                  description: Ticker symbol of the stock or ETF (e.g., AAPL, SPY).
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      port: 8080
      namespace: valueray-rest
      description: REST adapter for the ValueRay Symbol Data API.
      resources:
        - path: /symbolData
          name: getSymbolData
          operations:
            - method: GET
              name: getSymbolData
              description: Retrieve AI-ready aggregated symbol data for a stock or ETF.
              call: valueray.getSymbolData
              with:
                symbol: rest.symbol
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      port: 9090
      namespace: valueray-mcp
      transport: http
      description: MCP adapter for the ValueRay Symbol Data API for AI agent use.
      tools:
        - name: getSymbolData
          description: Retrieve AI-ready aggregated technical, quantitative, sentiment, risk,
            and performance data for a stock or ETF symbol.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: valueray.getSymbolData
          with:
            symbol: tools.symbol
          inputParameters:
            - name: symbol
              type: string
              description: Ticker symbol of the stock or ETF (e.g., AAPL, SPY).
              required: true
          outputParameters:
            - type: object
              mapping: $.
binds: []