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

# List TradingView setups

> Returns unrevoked bindings with exact link/instrument, source, immutable revision, quantity cap and management policy.

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

## Authorization

Authenticated Liftx Settings session.

## Behavior

Returns unrevoked bindings with exact link/instrument, source, immutable revision, quantity cap and management policy. An expired credential does not automatically remove its setup.

This is a session-owned application contract, not an ordinary API-key endpoint. Use [Settings → Integrations](https://app.liftx.io/settings/integrations). The public API base URL does not grant session access.

## Request example

```http theme={null}
GET /integrations/bindings
```

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/settings-contract) for lifecycle, units and recovery semantics.


## OpenAPI

````yaml api/openapi.json GET /integrations/bindings
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:
  /integrations/bindings:
    get:
      summary: List binding metadata
      description: >-
        Session-owned Settings contract. Ordinary API keys and TradingView
        capabilities cannot authenticate this route. Use the Liftx Settings
        application; this is not a third-party bot endpoint. Unrevoked bindings;
        namespace cap 64 applies independently of credential expiry.
      operationId: get_integrations_bindings
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  bindings:
                    type: array
                    items:
                      $ref: '#/components/schemas/Binding'
                required:
                  - bindings
                additionalProperties: false
              examples:
                synthetic:
                  summary: Synthetic success response
                  description: >-
                    Synthetic documentation data, not an account snapshot,
                    executable market configuration or production-availability
                    assertion. IDs, quantities, prices, times and values are
                    illustrative.
                  value:
                    bindings:
                      - integration_id: 88888888-8888-4888-8888-888888888888
                        mode: guided
                        exchange_link_id: 17
                        instrument_id: COPY_EXACT_CATALOG_ID
                        position_request:
                          action: 1
                          exchange_link_id: 17
                          instrument_id: COPY_EXACT_CATALOG_ID
                          quantity_asset: BTC
                          position_side: 1
                          open_order_type: 1
                          open_prices_atomic:
                            - '70000'
                          open_prices_scale:
                            - 0
                          open_quantities_atomic:
                            - '1'
                          open_quantities_scale:
                            - 4
                          order_grid_enabled: false
                          margin_mode: 1
                          leverage: 2
                          sl_enabled: true
                          sl_type: 1
                          sl_step_percent: 2000000
                          sl_price_atomic: '68600'
                          sl_price_scale: 0
                          sl_price_rearrangement: true
                          sl_order_type: 2
                          slx_enabled: true
                          slx_tp_trailing_enabled: false
                          slx_each_tp_trailing: false
                          slx_sl_trigger_price_trailing_enabled: true
                          slx_sl_trigger_price_trailing_pl_percent_activation: 1000000
                          slx_sl_trigger_price_trailing_indent_percent: 500000
                          slx_sl_trigger_price_trailing_step: 250000
                          slx_sl_trailing_breakeven_enabled: false
                          tp_enabled: true
                          tp_price_rearrangement: true
                          tp_grid_enabled: false
                          tp_order_type: 1
                          tp_prices_atomic:
                            - '72100'
                          tp_prices_scale:
                            - 0
                          tp_quantities_atomic:
                            - '0'
                          tp_quantities_scale:
                            - 0
                          tp_quantity_percents:
                            - 1000000
                          tp_pnls:
                            - 3000000
                        max_quantity: '0.001'
                        source_instance_id: 55555555-5555-4555-8555-555555555555
                        revision: 1
                        position_mode: single
                        allow_market_terminate: 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:
        - SessionBearer: []
components:
  schemas:
    Binding:
      type: object
      properties:
        integration_id:
          type: string
          format: uuid
        mode:
          type: string
        exchange_link_id:
          type: integer
          format: int64
        instrument_id:
          type: string
        position_request:
          anyOf:
            - $ref: '#/components/schemas/PositionRequest'
            - type: 'null'
        max_quantity:
          type: string
        source_instance_id:
          type: string
          format: uuid
        revision:
          type: integer
          format: int64
        position_mode:
          type: string
          enum:
            - single
            - multiple
          description: >-
            Single rejects a new OPEN while this setup has known active or
            pending/uncertain work. Multiple permits distinct simultaneous
            lifecycle references.
        allow_market_terminate:
          type: boolean
          description: >-
            Explicit permission for termination targeting all captured Liftx
            positions on the exact linked market, including manual and other
            strategies. Immutable and fresh-auth bound.
      required:
        - integration_id
        - mode
        - exchange_link_id
        - instrument_id
        - position_request
        - max_quantity
        - source_instance_id
        - revision
        - position_mode
        - allow_market_terminate
      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
    PositionRequest:
      type: object
      properties:
        action:
          type: integer
          const: 1
        instrument_id:
          type: string
          description: >-
            Opaque canonical catalog ID on the exact exchange link. Determines
            spot/derivative/inverse topology; never derive from chart ticker.
        trading_currency:
          type: string
          description: >-
            Eligible spot settlement currency; preserve canonical currency on
            modification.
        quantity_asset:
          type: string
          description: >-
            Catalog base or quote asset for input quantities. Normalization and
            venue contract conversion remain adapter-owned.
        position_side:
          type: integer
          enum:
            - 1
            - 2
          description: >-
            1 long; 2 short. Immutable after creation; exact catalog/account
            eligibility applies.
        open_order_type:
          type: integer
          format: int64
          enum:
            - 1
            - 2
            - 3
          description: >-
            1 limit, 2 market, 3 virtual limit. Supported combinations depend on
            the typed adapter and order role.
        exchange_link_id:
          type: integer
          format: int64
          minimum: 1
        open_slot_ids:
          type: array
          items:
            type: string
          maxItems: 65535
        order_amendments:
          type: array
          items:
            $ref: '#/components/schemas/OrderAmendment'
        margin_mode:
          anyOf:
            - type: integer
              format: int64
              enum:
                - 1
                - 2
            - type: 'null'
          description: >-
            Derivatives: 1 cross, 2 isolated. Required on creation and immutable
            thereafter.
        leverage:
          anyOf:
            - type: integer
              format: int64
              minimum: 1
              maximum: 32767
            - type: 'null'
          description: >-
            Required positive derivative creation leverage within the exact
            catalog/adapter limit; omit unchanged leverage on modify to avoid
            unnecessary preflight.
        order_grid_enabled:
          type: boolean
        num_open_orders:
          anyOf:
            - type: integer
              format: int64
              minimum: 0
              maximum: 65535
            - type: 'null'
        sl_enabled:
          type: boolean
        sl_type:
          anyOf:
            - type: integer
              format: int64
              enum:
                - 1
                - 2
            - type: 'null'
          description: 1 from position, 2 from average.
        sl_step_percent:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
          description: >-
            Percentage points multiplied by 1,000,000; trading owner validates
            applicability.
        sl_price_rearrangement:
          type: boolean
        sl_order_type:
          type: integer
          format: int64
          enum:
            - 1
            - 2
            - 3
          description: >-
            1 limit, 2 market, 3 virtual limit. Supported combinations depend on
            the typed adapter and order role.
        slx_enabled:
          type: boolean
        slx_tp_trailing_enabled:
          type: boolean
        slx_tp_breakeven:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
        slx_each_tp_trailing:
          type: boolean
        slx_sl_trailing_breakeven_enabled:
          type: boolean
        slx_sl_trailing_breakeven_indent_percent:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
          description: >-
            Percentage points multiplied by 1,000,000; trading owner validates
            applicability.
        slx_sl_trigger_price_trailing_enabled:
          type: boolean
        slx_sl_trigger_price_trailing_pl_percent_activation:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
          description: >-
            Percentage points multiplied by 1,000,000; trading owner validates
            applicability.
        slx_sl_trigger_price_trailing_indent_percent:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
          description: >-
            Percentage points multiplied by 1,000,000; trading owner validates
            applicability.
        slx_sl_trigger_price_trailing_step:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
          description: >-
            Percentage points multiplied by 1,000,000; trading owner validates
            applicability.
        tp_enabled:
          type: boolean
        tp_price_rearrangement:
          type: boolean
        tp_grid_enabled:
          type: boolean
        num_tp_orders:
          anyOf:
            - type: integer
              format: int64
              minimum: 0
              maximum: 65535
            - type: 'null'
        tp_quantity_percents:
          type: array
          items:
            type: integer
            format: int32
            minimum: 1
            maximum: 2147483647
          maxItems: 65535
          description: >-
            Required for enabled TP. Preserve builder weights: single full TP
            uses 1000000; grid weights use percentage points times 1000000.
            Canonical protection normalization handles both.
        tp_pnls:
          type: array
          items:
            type: integer
            format: int64
          maxItems: 65535
          description: >-
            Required for enabled TP. Rearranged TP: positive price-distance
            percent from fee-aware breakeven times 1000000, maximum 100000000;
            not leveraged ROI. Static unused entries may be zero.
        tp_slot_ids:
          type: array
          items:
            type: string
          maxItems: 65535
        tp_order_type:
          type: integer
          format: int64
          enum:
            - 1
            - 2
            - 3
          description: >-
            1 limit, 2 market, 3 virtual limit. Supported combinations depend on
            the typed adapter and order role.
        open_prices_atomic:
          type: array
          items:
            type: string
            pattern: ^-?[0-9]{1,128}$
          maxItems: 65535
        open_prices_scale:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 30
          maxItems: 65535
        open_quantities_atomic:
          type: array
          items:
            type: string
            pattern: ^-?[0-9]{1,128}$
          maxItems: 65535
        open_quantities_scale:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 30
          maxItems: 65535
        tp_prices_atomic:
          type: array
          items:
            type: string
            pattern: ^-?[0-9]{1,128}$
          maxItems: 65535
        tp_prices_scale:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 30
          maxItems: 65535
        tp_quantities_atomic:
          type: array
          items:
            type: string
            pattern: ^-?[0-9]{1,128}$
          maxItems: 65535
          description: >-
            Builder may use zero placeholders; canonical protection owner sizes
            from actual exposure and TP weights.
        tp_quantities_scale:
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 30
          maxItems: 65535
        sl_price_atomic:
          type: string
          pattern: ^-?[0-9]{1,128}$
        sl_price_scale:
          type: integer
          minimum: 0
          maximum: 30
        slx_activation_price_atomic:
          type: string
          pattern: ^-?[0-9]{1,128}$
        slx_activation_price_scale:
          type: integer
          minimum: 0
          maximum: 30
        slx_price_atomic:
          type: string
          pattern: ^-?[0-9]{1,128}$
        slx_price_scale:
          type: integer
          minimum: 0
          maximum: 30
      required:
        - action
        - instrument_id
        - exchange_link_id
        - quantity_asset
        - position_side
        - open_order_type
        - order_grid_enabled
        - open_prices_atomic
        - open_prices_scale
        - open_quantities_atomic
        - open_quantities_scale
        - sl_enabled
        - slx_enabled
        - tp_enabled
      additionalProperties: false
      description: >-
        Existing PositionRequest codec, also used by advanced TradingView.
        Paired row arrays must have equal lengths. Adapter batch limits and 256
        KiB command body apply below the post-decode row ceiling. Creation and
        enabled protections require their operational fields. API modify
        requires outer expected_revision and fresh exact slot/order identities.
        TV modify must preserve OPEN rows. See position-request.md for all
        fields and units.
      allOf:
        - if:
            properties:
              sl_enabled:
                const: true
            required:
              - sl_enabled
          then:
            required:
              - sl_price_rearrangement
              - sl_order_type
        - if:
            properties:
              tp_enabled:
                const: true
            required:
              - tp_enabled
          then:
            required:
              - tp_price_rearrangement
              - tp_grid_enabled
              - tp_order_type
              - tp_prices_atomic
              - tp_prices_scale
              - tp_quantities_atomic
              - tp_quantities_scale
              - tp_quantity_percents
              - tp_pnls
    OrderAmendment:
      type: object
      properties:
        slot_id:
          type: string
        order_id:
          type: string
          format: uuid
          description: Exact current Liftx physical order UUID, not an exchange order ID.
        price_atomic:
          type: string
          pattern: ^-?[0-9]{1,128}$
        price_scale:
          type: integer
          format: int64
          minimum: 0
          maximum: 30
        quantity_atomic:
          type: string
          pattern: ^-?[0-9]{1,128}$
        quantity_scale:
          type: integer
          format: int64
          minimum: 0
          maximum: 30
      required: []
      additionalProperties: false
      description: >-
        Existing amendment decoder accepts optional exact slot/order identity
        and optional paired price/quantity fields; trading owner validates
        applicability. Preserve identities from the current modification
        snapshot.
  securitySchemes:
    SessionBearer:
      type: http
      scheme: bearer
      bearerFormat: existing authenticated Liftx session

````

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