Bloomberg API (BLPAPI) — refdata

naftiko: 1.0.0-alpha2
info:
  label: Bloomberg API (BLPAPI) — refdata
  description: 'Bloomberg API (BLPAPI) — refdata. 6 operations. Lead operation: Request data for a Bloomberg Equity Screening
    (EQS) screen. Self-contained Naftiko capability covering one Bloomberg Apis business surface.'
  tags:
  - Bloomberg Apis
  - refdata
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    BLOOMBERG_APIS_API_KEY: BLOOMBERG_APIS_API_KEY
capability:
  consumes:
  - type: http
    namespace: bloomberg-blpapi-refdata
    baseUri: ''
    description: Bloomberg API (BLPAPI) — refdata business capability. Self-contained, no shared references.
    resources:
    - name: refdata-BeqsRequest
      path: /refdata/BeqsRequest
      operations:
      - name: beqsrequest
        method: POST
        description: Request data for a Bloomberg Equity Screening (EQS) screen
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: refdata-HistoricalDataRequest
      path: /refdata/HistoricalDataRequest
      operations:
      - name: historicaldatarequest
        method: POST
        description: Request end-of-day historical data over a date range
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: refdata-IntradayBarRequest
      path: /refdata/IntradayBarRequest
      operations:
      - name: intradaybarrequest
        method: POST
        description: Request intraday bar (OHLCV) history for a single security
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: refdata-IntradayTickRequest
      path: /refdata/IntradayTickRequest
      operations:
      - name: intradaytickrequest
        method: POST
        description: Request tick-by-tick history for a single security
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: refdata-PortfolioDataRequest
      path: /refdata/PortfolioDataRequest
      operations:
      - name: portfoliodatarequest
        method: POST
        description: Request portfolio positions and member data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: refdata-ReferenceDataRequest
      path: /refdata/ReferenceDataRequest
      operations:
      - name: referencedatarequest
        method: POST
        description: Request reference data for one or more securities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.BLOOMBERG_APIS_API_KEY}}'
  exposes:
  - type: rest
    namespace: bloomberg-blpapi-refdata-rest
    port: 8080
    description: REST adapter for Bloomberg API (BLPAPI) — refdata. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/refdata/beqsrequest
      name: refdata-beqsrequest
      description: REST surface for refdata-BeqsRequest.
      operations:
      - method: POST
        name: beqsrequest
        description: Request data for a Bloomberg Equity Screening (EQS) screen
        call: bloomberg-blpapi-refdata.beqsrequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/refdata/historicaldatarequest
      name: refdata-historicaldatarequest
      description: REST surface for refdata-HistoricalDataRequest.
      operations:
      - method: POST
        name: historicaldatarequest
        description: Request end-of-day historical data over a date range
        call: bloomberg-blpapi-refdata.historicaldatarequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/refdata/intradaybarrequest
      name: refdata-intradaybarrequest
      description: REST surface for refdata-IntradayBarRequest.
      operations:
      - method: POST
        name: intradaybarrequest
        description: Request intraday bar (OHLCV) history for a single security
        call: bloomberg-blpapi-refdata.intradaybarrequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/refdata/intradaytickrequest
      name: refdata-intradaytickrequest
      description: REST surface for refdata-IntradayTickRequest.
      operations:
      - method: POST
        name: intradaytickrequest
        description: Request tick-by-tick history for a single security
        call: bloomberg-blpapi-refdata.intradaytickrequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/refdata/portfoliodatarequest
      name: refdata-portfoliodatarequest
      description: REST surface for refdata-PortfolioDataRequest.
      operations:
      - method: POST
        name: portfoliodatarequest
        description: Request portfolio positions and member data
        call: bloomberg-blpapi-refdata.portfoliodatarequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/refdata/referencedatarequest
      name: refdata-referencedatarequest
      description: REST surface for refdata-ReferenceDataRequest.
      operations:
      - method: POST
        name: referencedatarequest
        description: Request reference data for one or more securities
        call: bloomberg-blpapi-refdata.referencedatarequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: bloomberg-blpapi-refdata-mcp
    port: 9090
    transport: http
    description: MCP adapter for Bloomberg API (BLPAPI) — refdata. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: request-data-bloomberg-equity-screening
      description: Request data for a Bloomberg Equity Screening (EQS) screen
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bloomberg-blpapi-refdata.beqsrequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: request-end-day-historical-data
      description: Request end-of-day historical data over a date range
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bloomberg-blpapi-refdata.historicaldatarequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: request-intraday-bar-ohlcv-history
      description: Request intraday bar (OHLCV) history for a single security
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bloomberg-blpapi-refdata.intradaybarrequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: request-tick-tick-history-single
      description: Request tick-by-tick history for a single security
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bloomberg-blpapi-refdata.intradaytickrequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: request-portfolio-positions-and-member
      description: Request portfolio positions and member data
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bloomberg-blpapi-refdata.portfoliodatarequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: request-reference-data-one-more
      description: Request reference data for one or more securities
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bloomberg-blpapi-refdata.referencedatarequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.