> ## 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.

# Get current Long/Short exposure

> Current Futures position counts and revision tokens for historical analytics.

`read` is required for one authorized exact link without instrument restrictions.
Supply `exchange_link_id`, its actual `environment` and an optional reporting
`pair_id` from the analytics asset catalog.

The response contains current Long/Short counts and committed revision tokens.
Unknown counts are null; zero counts are valid. Before reading Long/Short history,
copy `membership_revision` and `direction_revision` into that operation's
`membership_revision` and `revision`. The separate snapshot `revision` is not
the history revision. No WebSocket subscription is required.

See [Account analytics](/api/templates-and-history#account-analytics) for
scope, units, readiness and bounded pagination.


## OpenAPI

````yaml api/openapi.json GET /v1/dashboard/analytics/snapshot
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/analytics/snapshot:
    get:
      summary: Get current Long/Short exposure
      description: >-
        Read current Futures long/short position counts and committed analytics
        revision tokens. Use before liftx_analytics_get_long_short_history; no
        socket subscription is required. Counts are exposure at as_of, not
        cumulative closed trades. 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_analytics_snapshot
      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: 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})?$
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsSnapshot'
        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:
    AnalyticsSnapshot:
      type: object
      properties:
        type:
          type: string
          enum:
            - analytics_snapshot
        scope:
          $ref: '#/components/schemas/AnalyticsScope'
        revision:
          type: string
        as_of:
          type: integer
          format: int64
        long_short:
          $ref: '#/components/schemas/LongShortValue'
        direction_revision:
          type: string
        membership_revision:
          type: string
        orders_revision:
          type: string
        holding_revision:
          type: string
      required:
        - type
        - scope
        - revision
        - as_of
        - long_short
        - direction_revision
        - membership_revision
        - orders_revision
        - holding_revision
      additionalProperties: false
      description: >-
        Current canonical counts and opaque committed analytics revision tokens.
        Copy membership_revision and direction_revision into Long/Short history.
        Revision is observation identity, not a trading revision or execution
        acknowledgement.
    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
    LongShortValue:
      type: object
      properties:
        pair_id:
          type: string
        longs:
          anyOf:
            - type: integer
              format: int64
              minimum: 0
              maximum: 9007199254740991
            - type: 'null'
        shorts:
          anyOf:
            - type: integer
              format: int64
              minimum: 0
              maximum: 9007199254740991
            - type: 'null'
        complete:
          type: boolean
      required:
        - pair_id
        - longs
        - shorts
        - complete
      additionalProperties: false
      description: >-
        Counts of currently exposed Futures positions. Unknown counts are null;
        a proven zero remains zero. Ratio longs/shorts is undefined at 0/0 and
        infinite when only longs remain. This is a position count, not
        size-weighted or market-wide sentiment.
  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.