> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liftx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Read executed-order activity

> Daily first-native-fill counts in a selected local calendar range.

`read` is required for one authorized exact link without instrument restrictions.
Supply the link, its environment, an explicit IANA `timezone` and inclusive
Gregorian `from`/`to`. Optional `market` and reporting `pair_id` narrow the cohort.
One request admits at most 570 dates, through no later than today plus six dates.

Each physical order counts once at its first native fill, including partially
filled entry/exit orders. Unfilled orders and synthetic evidence are excluded.
Sum available local days for Monday-Sunday weekly totals; the current week is
week-to-date. Null is not zero; future and nonexistent dates are not activity.
Use bounded nonoverlapping six-month windows and `has_earlier` for older pages.

See [Account analytics](/api/templates-and-history#account-analytics) for
readiness, authoritative UTC boundaries and capacity handling.


## OpenAPI

````yaml api/openapi.json GET /v1/dashboard/order-heatmap
openapi: 3.1.0
info:
  title: Liftx integrations
  version: 1.0.0
  description: >-
    The Liftx API, TradingView webhook and session-owned integration settings.
    External access requires Pro or trial entitlement and is unmetered within
    bounded resource limits. Receipt acceptance does not confirm execution
    completion. MCP uses personal OAuth access and the same trading permissions
    and command receipts.
servers:
  - url: https://api.liftx.io
security: []
paths:
  /v1/dashboard/order-heatmap:
    get:
      summary: Get executed order activity
      description: >-
        Count each physical order once at its first native fill, including
        partially filled entry and exit orders; unfilled orders and synthetic
        evidence are excluded. Supply inclusive Gregorian from/to dates in the
        required IANA timezone, at most 570 dates and no later than today plus
        six dates. Counts through the current whole-second cutoff are eligible.
        Null is not zero. Sum returned available days for Monday–Sunday weekly
        totals in that timezone; current week is week-to-date. For older history
        use bounded nonoverlapping six-month windows and has_earlier; do not
        scan raw orders. Requires read permission for one authorized exact link
        with unrestricted instrument access. No account-wide or
        instrument-policy bypass; no trading action.
      operationId: get_v1_dashboard_order_heatmap
      parameters:
        - name: exchange_link_id
          in: query
          required: true
          schema:
            type: integer
            minimum: 1
            maximum: 9007199254740991
        - name: environment
          in: query
          required: true
          schema:
            type: string
            enum:
              - live
              - demo
        - name: market
          in: query
          required: false
          schema:
            type: string
            enum:
              - all
              - spot
              - futures
        - name: pair_id
          in: query
          required: false
          schema:
            type: string
            maxLength: 64
            description: >-
              Opaque reporting pair_id from liftx_analytics_list_assets; omit
              for All Assets. Not an executable instrument_id.
            pattern: ^([a-f0-9]{64})?$
        - name: timezone
          in: query
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
            description: >-
              User-selected IANA timezone, e.g. Europe/London. Required; do not
              infer it from server time or locale.
        - name: from
          in: query
          required: true
          schema:
            type: string
            format: date
            pattern: ^\d{4}-\d{2}-\d{2}$
        - name: to
          in: query
          required: true
          schema:
            type: string
            format: date
            pattern: ^\d{4}-\d{2}-\d{2}$
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionHeatmap'
        default:
          description: >-
            Integration errors use Error; existing trading handlers retain their
            own JSON or text/plain error codec. Inspect status and content type.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            text/plain:
              schema:
                type: string
      security:
        - ApiKey: []
components:
  schemas:
    ExecutionHeatmap:
      type: object
      properties:
        scope:
          $ref: '#/components/schemas/AnalyticsScope'
        market:
          type: string
          enum:
            - all
            - spot
            - futures
        pair_id:
          type: string
        boundaries:
          type: array
          items:
            $ref: '#/components/schemas/ExecutionCalendarInterval'
        revision:
          type: string
        as_of:
          type: integer
          format: int64
        state:
          type: string
          enum:
            - ready
            - loading
            - updating
            - unavailable
        timezone:
          type: string
        calendar_generation:
          type: string
        from:
          type: string
          format: date
          pattern: ^\d{4}-\d{2}-\d{2}$
        to:
          type: string
          format: date
          pattern: ^\d{4}-\d{2}-\d{2}$
        days:
          type: array
          items:
            $ref: '#/components/schemas/ExecutionHeatmapDay'
          maxItems: 570
        earliest_date:
          anyOf:
            - type: string
              format: date
              pattern: ^\d{4}-\d{2}-\d{2}$
            - type: 'null'
        has_earlier:
          type: boolean
      required:
        - scope
        - market
        - pair_id
        - boundaries
        - revision
        - as_of
        - state
        - timezone
        - calendar_generation
        - from
        - to
        - days
        - earliest_date
        - has_earlier
      additionalProperties: false
    Error:
      type: object
      properties:
        success:
          const: false
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          additionalProperties: false
      required:
        - success
        - error
      additionalProperties: false
    AnalyticsScope:
      type: object
      properties:
        exchange_link_id:
          type: integer
          format: int64
          minimum: 0
          maximum: 9007199254740991
        environment:
          type: string
          enum:
            - live
            - demo
      required:
        - exchange_link_id
        - environment
      additionalProperties: false
    ExecutionCalendarInterval:
      type: object
      properties:
        from:
          type: integer
          format: int64
        to:
          type: integer
          format: int64
      required:
        - from
        - to
      additionalProperties: false
      description: >-
        Half-open UTC interval in Unix seconds, resolved from Gregorian civil
        dates in the supplied IANA timezone. Days need not contain 24 hours.
    ExecutionHeatmapDay:
      type: object
      properties:
        date:
          type: string
          format: date
          pattern: ^\d{4}-\d{2}-\d{2}$
        count:
          anyOf:
            - type: integer
              format: int64
              minimum: 0
              maximum: 9007199254740991
            - type: 'null'
        intervals:
          type: array
          items:
            $ref: '#/components/schemas/ExecutionCalendarInterval'
          maxItems: 4
      required:
        - date
        - count
        - intervals
      additionalProperties: false
      description: >-
        One local calendar date. Null count is unavailable, loading, future or
        nonexistent, never zero. Empty intervals identify nonexistent dates;
        consult response state and as_of. Each physical order counts once at its
        first native fill, including partial entry and exit orders.
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: lx_api_<credential UUID>.<256-bit secret>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.