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

# Find analytics reporting assets

> Bounded asset discovery for exposure, executed orders and holding analytics.

`read` is required for one authorized exact link without instrument restrictions.
Supply the link, environment and `kind=long_short`, `orders` or `holding`.
Long/Short uses Futures: omit `market` or use `all`/`futures`; `spot` is rejected.
Other kinds support `market=all`, `spot` or `futures`. No reporting currency is needed.

Search uses uppercase letters, digits, dot, underscore and hyphen. Pages contain
at most 100 options. Copy `next_cursor` unchanged while nonempty. A reporting
`pair_id` is not an executable `instrument_id`; omit pair selection from analytics
reads for All Assets.

See [Account analytics](/api/templates-and-history#account-analytics).


## OpenAPI

````yaml api/openapi.json GET /v1/dashboard/analytics/pairs
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/pairs:
    get:
      summary: List execution analytics assets
      description: >-
        Find up to 100 reporting asset pairs for Long/Short exposure
        (kind=long_short), executed-order activity (kind=orders) or holding-time
        analytics (kind=holding). Use liftx_analytics_list_pnl_assets for
        P&L-history filters. Use search and copy next_cursor unchanged until
        empty. long_short uses Futures; omit market or use all/futures, never
        spot. A reporting pair_id is not an executable instrument_id; omit
        pair_id in analytics reads for All Assets. Does not require a reporting
        currency. 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_pairs
      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: kind
          in: query
          required: true
          schema:
            type: string
            enum:
              - long_short
              - orders
              - holding
        - name: market
          in: query
          required: false
          schema:
            type: string
            enum:
              - all
              - spot
              - futures
        - name: search
          in: query
          required: false
          schema:
            type: string
            maxLength: 65
            pattern: ^[A-Z0-9._-]*$
            description: >-
              Optional uppercase search using letters, digits, dot, underscore
              or hyphen.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            maxLength: 64
            pattern: ^([a-f0-9]{64})?$
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsPairOptions'
        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:
    AnalyticsPairOptions:
      type: object
      properties:
        scope:
          $ref: '#/components/schemas/AnalyticsScope'
        kind:
          type: string
          enum:
            - long_short
            - orders
            - holding
        market:
          type: string
          enum:
            - all
            - spot
            - futures
        search:
          type: string
        cursor:
          type: string
        options:
          type: array
          items:
            $ref: '#/components/schemas/Pair'
          maxItems: 100
        next_cursor:
          type: string
      required:
        - scope
        - kind
        - market
        - search
        - cursor
        - options
        - next_cursor
      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
    Pair:
      type: object
      properties:
        pair_id:
          type: string
        base:
          type: string
        quote:
          type: string
      required:
        - pair_id
        - base
        - quote
      additionalProperties: false
  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.