naftiko: 1.0.0-alpha2
info:
  label: Factset Tick History — TickHistory
  description: 'Factset Tick History — TickHistory. 5 operations. Lead operation: Factset Request returns data for the first
    trade (official and unofficial) after the specified time. Self-contained Naftiko capability covering one Factset business
    surface.'
  tags:
  - Factset
  - TickHistory
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FACTSET_API_KEY: FACTSET_API_KEY
capability:
  consumes:
  - type: http
    namespace: intraday-tick-history-tickhistory
    baseUri: https://api-sandbox.factset.com
    description: Factset Tick History — TickHistory business capability. Self-contained, no shared references.
    resources:
    - name: TickHistory-firsttrade
      path: /TickHistory/firsttrade
      operations:
      - name: get
        method: GET
        description: Factset Request returns data for the first trade (official and unofficial) after the specified time
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: 'Requested symbol or security. The symbol can be a FactSet exchange symbol, CUSIP, or SEDOL. **NOTE**:
            Only one identifier can be requested per request.<P>**TRY '
          required: true
        - name: req_id
          in: query
          type: string
          description: 'Request Identification String. Can be used by the application to keep track of requests. The id is
            not used by this service, however, it is included in the XML '
        - name: start_date
          in: query
          type: string
          description: This is the start date for the Snapshot History. Requests should be made in the format YYYYMMDD Default
            is current business day. Field can be sd or date. TRY IT
        - name: start_time
          in: query
          type: string
          description: This is the start time for the snapshot history requested. Requests should be made in a **HHMMSSS**
            format.Range from 000000 - 235959. **TRY IT OUT** Cannot use
        - name: format
          in: query
          type: string
          description: The format of the output file. TRY IT OUT Choose from JSON, CSV, CSV_NO_HEADER
        - name: include_request
          in: query
          type: string
          description: Flag to include request id and key in the CSV output.
        - name: dataset
          in: query
          type: string
          description: Decides what type of trades to return, default is all trades and quotes, alternatively charting can
            be selected which will filter out unofficial trades.
    - name: TickHistory-history
      path: /TickHistory/history
      operations:
      - name: gettickhistory
        method: GET
        description: Factset Tick History service returns trade data and associated quotes for a client specified interval
          and time period
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: 'Requested symbol or security. The symbol can be a FactSet exchange symbol, CUSIP, or SEDOL. **NOTE**:
            Only one identifier can be requested per request.<P>**TRY '
          required: true
        - name: req_id
          in: query
          type: string
          description: Request Identification String. Can be used by the application to keep track of requests.  The id is
            not used by this service, however, it is included in the XML
        - name: format
          in: query
          type: string
          description: The format of the output file. **TRY IT OUT** Choose from JSON, CSV, CSV_NO_HEADER
        - name: fields
          in: query
          type: string
          description: All available fields. This is a comma-seperated list (no spaces). See definitions for details. Default
            is all fields when left blank.
        - name: ed
          in: query
          type: string
          description: This is the end date for teh Snapshot History. Requests should be made in the format **YYYYMMDD**.
            If the period requested is larger than Max. Days requested, r
        - name: st
          in: query
          type: string
          description: Requested start time. This is the start time for the snapshot history requested. Requests should be
            made in a **HHMMSSS** format. Range from 000000 - 235959. **
        - name: et
          in: query
          type: string
          description: 'Requested end time. This is the end time for the snapshot history requested. Requests should be made
            in a **HHMMSSS** format. Range from 000000 - 235959. **TRY '
        - name: interval
          in: query
          type: string
          description: Requested time interval. This is the interval the data is returned from the service. Possible values
            from 1 Second (1S) to 1 Hour (1H). A maximum of 10 Tick His
        - name: include_request
          in: query
          type: string
          description: Flag to include request id and key in the CSV output.
        - name: dataset
          in: query
          type: string
          description: Decides what type of trades to return, default is all trades and quotes, alternatively charting can
            be selected which will filter out unofficial trades.
    - name: TickHistory-lasttrade
      path: /TickHistory/lasttrade
      operations:
      - name: get
        method: GET
        description: Factset Request returns data for the last trade and associated quotes before the specified time
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: 'Requested symbol or security. The symbol can be a FactSet exchange symbol, CUSIP, or SEDOL. **NOTE**:
            Only one identifier can be requested per request.<P>**TRY '
          required: true
        - name: format
          in: query
          type: string
          description: The format of the output file. TRY IT OUT Choose from JSON, CSV, CSV_NO_HEADER
        - name: date
          in: query
          type: string
          description: Request should be made in the format **YYYYMMDD**. The initial release only supports requests from
            completed trading days
        - name: time
          in: query
          type: string
          description: Request should be made in the format **HHMMSS**.HH- Hour, MM- Minutes, SSS- Seconds
    - name: TickHistory-qat
      path: /TickHistory/qat
      operations:
      - name: get
        method: GET
        description: Factset Request returns a quote at the specified time
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: 'Requested symbol or security. The symbol can be a FactSet exchange symbol, CUSIP, or SEDOL. **NOTE**:
            Only one identifier can be requested per request.<P>**TRY '
          required: true
        - name: date
          in: query
          type: string
          description: Request should be made in the format **YYYYMMDD**. The initial release only supports requests from
            completed trading days
        - name: time
          in: query
          type: string
          description: Request should be made in the format **HHMMSSS**.HH- Hour, MM- Minutes, SS- Seconds
        - name: format
          in: query
          type: string
          description: The format of the output file. TRY IT OUT Choose from JSON, CSV, CSV_NO_HEADER
    - name: TickHistory-tradesattime
      path: /TickHistory/tradesattime
      operations:
      - name: get
        method: GET
        description: Factset Request returns the before and after trade data along with the associated quotes for the specified
          time
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
          description: 'Requested symbol or security. The symbol can be a FactSet exchange symbol, CUSIP, or SEDOL. **NOTE**:
            Only one identifier can be requested per request.<P>**TRY '
          required: true
        - name: req_id
          in: query
          type: string
          description: 'Request Identification String. Can be used by the application to keep track of requests. The id is
            not used by this service, however, it is included in the XML '
        - name: format
          in: query
          type: string
          description: The format of the output file. TRY IT OUT Choose from JSON, CSV, CSV_NO_HEADER
        - name: date
          in: query
          type: string
          description: Request should be made in the format **YYYYMMDD**. The initial release only supports requests from
            completed trading days
        - name: time
          in: query
          type: string
          description: Request should be made in the format **HHMMSSS**.HH- Hour, MM- Minutes, SS- Seconds
    authentication:
      type: basic
      username: '{{env.FACTSET_USER}}'
      password: '{{env.FACTSET_PASS}}'
  exposes:
  - type: rest
    namespace: intraday-tick-history-tickhistory-rest
    port: 8080
    description: REST adapter for Factset Tick History — TickHistory. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/tickhistory/firsttrade
      name: tickhistory-firsttrade
      description: REST surface for TickHistory-firsttrade.
      operations:
      - method: GET
        name: get
        description: Factset Request returns data for the first trade (official and unofficial) after the specified time
        call: intraday-tick-history-tickhistory.get
        with:
          id: rest.id
          req_id: rest.req_id
          start_date: rest.start_date
          start_time: rest.start_time
          format: rest.format
          include_request: rest.include_request
          dataset: rest.dataset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tickhistory/history
      name: tickhistory-history
      description: REST surface for TickHistory-history.
      operations:
      - method: GET
        name: gettickhistory
        description: Factset Tick History service returns trade data and associated quotes for a client specified interval
          and time period
        call: intraday-tick-history-tickhistory.gettickhistory
        with:
          id: rest.id
          req_id: rest.req_id
          format: rest.format
          fields: rest.fields
          ed: rest.ed
          st: rest.st
          et: rest.et
          interval: rest.interval
          include_request: rest.include_request
          dataset: rest.dataset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tickhistory/lasttrade
      name: tickhistory-lasttrade
      description: REST surface for TickHistory-lasttrade.
      operations:
      - method: GET
        name: get
        description: Factset Request returns data for the last trade and associated quotes before the specified time
        call: intraday-tick-history-tickhistory.get
        with:
          id: rest.id
          format: rest.format
          date: rest.date
          time: rest.time
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tickhistory/qat
      name: tickhistory-qat
      description: REST surface for TickHistory-qat.
      operations:
      - method: GET
        name: get
        description: Factset Request returns a quote at the specified time
        call: intraday-tick-history-tickhistory.get
        with:
          id: rest.id
          date: rest.date
          time: rest.time
          format: rest.format
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tickhistory/tradesattime
      name: tickhistory-tradesattime
      description: REST surface for TickHistory-tradesattime.
      operations:
      - method: GET
        name: get
        description: Factset Request returns the before and after trade data along with the associated quotes for the specified
          time
        call: intraday-tick-history-tickhistory.get
        with:
          id: rest.id
          req_id: rest.req_id
          format: rest.format
          date: rest.date
          time: rest.time
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: intraday-tick-history-tickhistory-mcp
    port: 9090
    transport: http
    description: MCP adapter for Factset Tick History — TickHistory. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: factset-request-returns-data-first
      description: Factset Request returns data for the first trade (official and unofficial) after the specified time
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: intraday-tick-history-tickhistory.get
      with:
        id: tools.id
        req_id: tools.req_id
        start_date: tools.start_date
        start_time: tools.start_time
        format: tools.format
        include_request: tools.include_request
        dataset: tools.dataset
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-tick-history-service-returns
      description: Factset Tick History service returns trade data and associated quotes for a client specified interval and
        time period
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: intraday-tick-history-tickhistory.gettickhistory
      with:
        id: tools.id
        req_id: tools.req_id
        format: tools.format
        fields: tools.fields
        ed: tools.ed
        st: tools.st
        et: tools.et
        interval: tools.interval
        include_request: tools.include_request
        dataset: tools.dataset
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-request-returns-data-last
      description: Factset Request returns data for the last trade and associated quotes before the specified time
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: intraday-tick-history-tickhistory.get
      with:
        id: tools.id
        format: tools.format
        date: tools.date
        time: tools.time
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-request-returns-quote-specified
      description: Factset Request returns a quote at the specified time
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: intraday-tick-history-tickhistory.get
      with:
        id: tools.id
        date: tools.date
        time: tools.time
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.
    - name: factset-request-returns-before-and
      description: Factset Request returns the before and after trade data along with the associated quotes for the specified
        time
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: intraday-tick-history-tickhistory.get
      with:
        id: tools.id
        req_id: tools.req_id
        format: tools.format
        date: tools.date
        time: tools.time
      outputParameters:
      - type: object
        mapping: $.