naftiko: 1.0.0-alpha2
info:
  label: Market Data API — Stock Pricing Data API
  description: 'Market Data API — Stock Pricing Data API. 16 operations. Lead operation: Get Bar data for multiple stock symbols.
    Self-contained Naftiko capability covering one Alpaca business surface.'
  tags:
  - Alpaca
  - Stock Pricing Data API
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ALPACA_API_KEY: ALPACA_API_KEY
capability:
  consumes:
  - type: http
    namespace: data-stock-pricing-data-api
    baseUri: https://data.alpaca.markets
    description: Market Data API — Stock Pricing Data API business capability. Self-contained, no shared references.
    resources:
    - name: v2-stocks-bars
      path: /v2/stocks/bars
      operations:
      - name: getbarsformultiplestocksymbols
        method: GET
        description: Get Bar data for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-bars-latest
      path: /v2/stocks/bars/latest
      operations:
      - name: getlatestbarsformultiplestocksymbols
        method: GET
        description: Get Latest Bar data for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-meta-conditions-type
      path: /v2/stocks/meta/conditions/{type}
      operations:
      - name: getconditions
        method: GET
        description: Get list of Conditions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: tape
          in: query
          type: string
          description: What kind of conditions to retrieve, "A" and "B" return CTS, where "C" will give you UTP
          required: true
    - name: v2-stocks-meta-exchanges
      path: /v2/stocks/meta/exchanges
      operations:
      - name: getexchanges
        method: GET
        description: Get List of supported exchanges
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-quotes
      path: /v2/stocks/quotes
      operations:
      - name: getquotesformultiplestocksymbols
        method: GET
        description: Get Quotes for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-quotes-latest
      path: /v2/stocks/quotes/latest
      operations:
      - name: getlatestquotesformultiplestocksymbols
        method: GET
        description: Get Latest Quotes for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-snapshots
      path: /v2/stocks/snapshots
      operations:
      - name: getsnapshotsformultiplestocksymbols
        method: GET
        description: Get Snapshots for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-trades
      path: /v2/stocks/trades
      operations:
      - name: gettradesformultiplestocksymbols
        method: GET
        description: Get Trade data for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-trades-latest
      path: /v2/stocks/trades/latest
      operations:
      - name: getlatesttradesformultiplestocksymbols
        method: GET
        description: Get Latest Trades data for multiple stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-symbol-bars
      path: /v2/stocks/{symbol}/bars
      operations:
      - name: getbarsforstocksymbol
        method: GET
        description: Bars
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-symbol-bars-latest
      path: /v2/stocks/{symbol}/bars/latest
      operations:
      - name: getlatestbarforstocksymbol
        method: GET
        description: Get Latest Bars for Symbol
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-stocks-symbol-quotes
      path: /v2/stocks/{symbol}/quotes
      operations:
      - name: getquotesforstocksymbol
        method: GET
        description: Get Quotes for stock symbol
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: symbol
          in: path
          type: string
          description: The symbol to query for
          required: true
    - name: v2-stocks-symbol-quotes-latest
      path: /v2/stocks/{symbol}/quotes/latest
      operations:
      - name: getlatestquoteforstocksymbol
        method: GET
        description: Get Latest Quote for stock symbol
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: symbol
          in: path
          type: string
          description: The symbol to query for
          required: true
    - name: v2-stocks-symbol-snapshot
      path: /v2/stocks/{symbol}/snapshot
      operations:
      - name: getsnapshotforstocksymbol
        method: GET
        description: Get a Snapshot for a stock symbol
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: symbol
          in: path
          type: string
          description: The symbol to query for
          required: true
    - name: v2-stocks-symbol-trades
      path: /v2/stocks/{symbol}/trades
      operations:
      - name: gettradesforstocksymbol
        method: GET
        description: Trades
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: symbol
          in: path
          type: string
          description: The symbol to query for
          required: true
    - name: v2-stocks-symbol-trades-latest
      path: /v2/stocks/{symbol}/trades/latest
      operations:
      - name: getlatesttradeforstocksymbol
        method: GET
        description: Latest Trade
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: symbol
          in: path
          type: string
          description: The symbol to query for
          required: true
    authentication:
      type: apikey
      key: APCA-API-KEY-ID
      value: '{{env.ALPACA_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: data-stock-pricing-data-api-rest
    port: 8080
    description: REST adapter for Market Data API — Stock Pricing Data API. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v2/stocks/bars
      name: v2-stocks-bars
      description: REST surface for v2-stocks-bars.
      operations:
      - method: GET
        name: getbarsformultiplestocksymbols
        description: Get Bar data for multiple stock symbols
        call: data-stock-pricing-data-api.getbarsformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/bars/latest
      name: v2-stocks-bars-latest
      description: REST surface for v2-stocks-bars-latest.
      operations:
      - method: GET
        name: getlatestbarsformultiplestocksymbols
        description: Get Latest Bar data for multiple stock symbols
        call: data-stock-pricing-data-api.getlatestbarsformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/meta/conditions/{type}
      name: v2-stocks-meta-conditions-type
      description: REST surface for v2-stocks-meta-conditions-type.
      operations:
      - method: GET
        name: getconditions
        description: Get list of Conditions
        call: data-stock-pricing-data-api.getconditions
        with:
          tape: rest.tape
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/meta/exchanges
      name: v2-stocks-meta-exchanges
      description: REST surface for v2-stocks-meta-exchanges.
      operations:
      - method: GET
        name: getexchanges
        description: Get List of supported exchanges
        call: data-stock-pricing-data-api.getexchanges
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/quotes
      name: v2-stocks-quotes
      description: REST surface for v2-stocks-quotes.
      operations:
      - method: GET
        name: getquotesformultiplestocksymbols
        description: Get Quotes for multiple stock symbols
        call: data-stock-pricing-data-api.getquotesformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/quotes/latest
      name: v2-stocks-quotes-latest
      description: REST surface for v2-stocks-quotes-latest.
      operations:
      - method: GET
        name: getlatestquotesformultiplestocksymbols
        description: Get Latest Quotes for multiple stock symbols
        call: data-stock-pricing-data-api.getlatestquotesformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/snapshots
      name: v2-stocks-snapshots
      description: REST surface for v2-stocks-snapshots.
      operations:
      - method: GET
        name: getsnapshotsformultiplestocksymbols
        description: Get Snapshots for multiple stock symbols
        call: data-stock-pricing-data-api.getsnapshotsformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/trades
      name: v2-stocks-trades
      description: REST surface for v2-stocks-trades.
      operations:
      - method: GET
        name: gettradesformultiplestocksymbols
        description: Get Trade data for multiple stock symbols
        call: data-stock-pricing-data-api.gettradesformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/trades/latest
      name: v2-stocks-trades-latest
      description: REST surface for v2-stocks-trades-latest.
      operations:
      - method: GET
        name: getlatesttradesformultiplestocksymbols
        description: Get Latest Trades data for multiple stock symbols
        call: data-stock-pricing-data-api.getlatesttradesformultiplestocksymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/bars
      name: v2-stocks-symbol-bars
      description: REST surface for v2-stocks-symbol-bars.
      operations:
      - method: GET
        name: getbarsforstocksymbol
        description: Bars
        call: data-stock-pricing-data-api.getbarsforstocksymbol
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/bars/latest
      name: v2-stocks-symbol-bars-latest
      description: REST surface for v2-stocks-symbol-bars-latest.
      operations:
      - method: GET
        name: getlatestbarforstocksymbol
        description: Get Latest Bars for Symbol
        call: data-stock-pricing-data-api.getlatestbarforstocksymbol
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/quotes
      name: v2-stocks-symbol-quotes
      description: REST surface for v2-stocks-symbol-quotes.
      operations:
      - method: GET
        name: getquotesforstocksymbol
        description: Get Quotes for stock symbol
        call: data-stock-pricing-data-api.getquotesforstocksymbol
        with:
          symbol: rest.symbol
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/quotes/latest
      name: v2-stocks-symbol-quotes-latest
      description: REST surface for v2-stocks-symbol-quotes-latest.
      operations:
      - method: GET
        name: getlatestquoteforstocksymbol
        description: Get Latest Quote for stock symbol
        call: data-stock-pricing-data-api.getlatestquoteforstocksymbol
        with:
          symbol: rest.symbol
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/snapshot
      name: v2-stocks-symbol-snapshot
      description: REST surface for v2-stocks-symbol-snapshot.
      operations:
      - method: GET
        name: getsnapshotforstocksymbol
        description: Get a Snapshot for a stock symbol
        call: data-stock-pricing-data-api.getsnapshotforstocksymbol
        with:
          symbol: rest.symbol
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/trades
      name: v2-stocks-symbol-trades
      description: REST surface for v2-stocks-symbol-trades.
      operations:
      - method: GET
        name: gettradesforstocksymbol
        description: Trades
        call: data-stock-pricing-data-api.gettradesforstocksymbol
        with:
          symbol: rest.symbol
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/stocks/{symbol}/trades/latest
      name: v2-stocks-symbol-trades-latest
      description: REST surface for v2-stocks-symbol-trades-latest.
      operations:
      - method: GET
        name: getlatesttradeforstocksymbol
        description: Latest Trade
        call: data-stock-pricing-data-api.getlatesttradeforstocksymbol
        with:
          symbol: rest.symbol
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: data-stock-pricing-data-api-mcp
    port: 9090
    transport: http
    description: MCP adapter for Market Data API — Stock Pricing Data API. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: get-bar-data-multiple-stock
      description: Get Bar data for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getbarsformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: get-latest-bar-data-multiple
      description: Get Latest Bar data for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getlatestbarsformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-conditions
      description: Get list of Conditions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getconditions
      with:
        tape: tools.tape
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-supported-exchanges
      description: Get List of supported exchanges
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getexchanges
      outputParameters:
      - type: object
        mapping: $.
    - name: get-quotes-multiple-stock-symbols
      description: Get Quotes for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getquotesformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: get-latest-quotes-multiple-stock
      description: Get Latest Quotes for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getlatestquotesformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: get-snapshots-multiple-stock-symbols
      description: Get Snapshots for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getsnapshotsformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: get-trade-data-multiple-stock
      description: Get Trade data for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.gettradesformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: get-latest-trades-data-multiple
      description: Get Latest Trades data for multiple stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getlatesttradesformultiplestocksymbols
      outputParameters:
      - type: object
        mapping: $.
    - name: bars
      description: Bars
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getbarsforstocksymbol
      outputParameters:
      - type: object
        mapping: $.
    - name: get-latest-bars-symbol
      description: Get Latest Bars for Symbol
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getlatestbarforstocksymbol
      outputParameters:
      - type: object
        mapping: $.
    - name: get-quotes-stock-symbol
      description: Get Quotes for stock symbol
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getquotesforstocksymbol
      with:
        symbol: tools.symbol
      outputParameters:
      - type: object
        mapping: $.
    - name: get-latest-quote-stock-symbol
      description: Get Latest Quote for stock symbol
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getlatestquoteforstocksymbol
      with:
        symbol: tools.symbol
      outputParameters:
      - type: object
        mapping: $.
    - name: get-snapshot-stock-symbol
      description: Get a Snapshot for a stock symbol
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getsnapshotforstocksymbol
      with:
        symbol: tools.symbol
      outputParameters:
      - type: object
        mapping: $.
    - name: trades
      description: Trades
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.gettradesforstocksymbol
      with:
        symbol: tools.symbol
      outputParameters:
      - type: object
        mapping: $.
    - name: latest-trade
      description: Latest Trade
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-stock-pricing-data-api.getlatesttradeforstocksymbol
      with:
        symbol: tools.symbol
      outputParameters:
      - type: object
        mapping: $.