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

# Discover API capabilities

> Returns version, canonical action names, scopes, advertised request/pending/group bounds and MCP availability.

<Note>Preview contract. Production availability remains subject to activation and release qualification. Examples are synthetic; the documentation cannot submit requests.</Note>

## Authorization

Any valid ordinary API key; no additional scope.

## Behavior

Returns version, canonical action names, scopes, advertised request/pending/group bounds and MCP availability. Discovery does not attest exchange readiness or production activation. Use the exact values for feature detection.

## Request example

```http theme={null}
GET /v1/discovery
Authorization: Bearer YOUR_API_KEY_FROM_PRIVATE_STORAGE
```

All IDs and dates are illustrative. URL-encode opaque query values and supply each allowed key once. Optional filters and their types appear in the generated schema below.

## Response and errors

The generated response schema below is the wire contract. Preserve fixed-point strings, nullable fields and endpoint-specific envelopes. Inspect HTTP status and Content-Type before decoding failures; reused trading routes may return JSON or plain text. Authentication, entitlement and exact link/instrument restrictions apply in addition to endpoint validation. See [errors and recovery](/api/errors-and-limits).

Read the [related guide](/api/overview) for lifecycle, units and recovery semantics.


## OpenAPI

````yaml api/openapi.json GET /v1/discovery
openapi: 3.1.0
info:
  title: Liftx integrations
  version: 1.0.0
  description: >-
    Preview contract for the Liftx API, TradingView webhook and session-owned
    integration settings. Production availability is pending activation and
    release qualification. External access requires Pro or trial entitlement and
    is unmetered within bounded resource limits. Receipt acceptance does not
    confirm execution completion. MCP is not active.
servers:
  - url: https://api.liftx.io
security: []
paths:
  /v1/discovery:
    get:
      summary: Discover API actions, scopes and bounds
      operationId: get_v1_discovery
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    const: v1
                  command_actions:
                    type: array
                    items:
                      type: string
                  scopes:
                    type: array
                    items:
                      type: string
                  limits:
                    type: object
                    properties:
                      request_bytes:
                        type: integer
                        format: int64
                      pending_per_user:
                        type: integer
                        format: int64
                      command_lifetime_seconds:
                        type: integer
                        format: int64
                      receipt_retention_days:
                        type: integer
                        format: int64
                      group_targets:
                        type: integer
                        const: 64
                    required:
                      - group_targets
                    additionalProperties: true
                  mcp_available:
                    const: false
                required:
                  - version
                  - command_actions
                  - scopes
                  - limits
                  - mcp_available
                additionalProperties: false
              examples:
                synthetic:
                  summary: Actual published contract values; not activation evidence
                  description: >-
                    Synthetic documentation data, not an account snapshot,
                    executable market configuration or production-availability
                    assertion. IDs, quantities, prices, times and values are
                    illustrative.
                  value:
                    version: v1
                    command_actions:
                      - open
                      - modify
                      - terminate
                    scopes:
                      - read
                      - positions:open
                      - positions:modify
                      - positions:terminate
                      - templates:write
                    limits:
                      request_bytes: 262144
                      pending_per_user: 64
                      group_targets: 64
                      command_lifetime_seconds: 300
                      receipt_retention_days: 30
                    mcp_available: false
        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:
    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
  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.