> ## 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 order templates
> Returns a bare array, including an empty array when no templates exist.
Preview contract. Production availability remains subject to activation and release qualification. Examples are synthetic; the documentation cannot submit requests.
## Authorization
`read`; templates are account-owned.
## Behavior
Returns a bare array, including an empty array when no templates exist. It is not wrapped in success/data and not limited to the credential instrument. Template reads place no trades.
## Request example
```http theme={null}
GET /v1/templates/list
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/templates-and-history) for lifecycle, units and recovery semantics.
## OpenAPI
````yaml api/openapi.json GET /v1/templates/list
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/templates/list:
get:
summary: Canonical template list
operationId: get_v1_templates_list
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/OrderTemplate'
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:
- id: 44444444-4444-4444-8444-444444444444
user_id: 1
name: Illustrative derivative limit
instrument_type: 2
position_side: 1
margin_mode: 1
leverage: 2
order_grid_enabled: false
open_price_deltas: []
open_quantity_percent:
- 1000000
sl_enabled: false
sl_price_rearrangement: false
slx_enabled: false
slx_tp_trailing_enabled: false
slx_each_tp_trailing: false
slx_sl_trailing_breakeven_enabled: false
slx_sl_trigger_price_trailing_enabled: false
tp_enabled: false
tp_price_rearrangement: false
tp_grid_enabled: false
tp_pnls: []
tp_quantity_percent: []
open_order_type: 1
sl_order_type: 2
tp_order_type: 1
created_at: 1893456000
updated_at: 1893456000
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:
OrderTemplate:
type: object
properties:
id:
type: string
format: uuid
user_id:
type: integer
format: int64
name:
type: string
instrument_type:
type: integer
format: int64
position_side:
type: integer
format: int64
margin_mode:
anyOf:
- type: integer
format: int64
- type: 'null'
leverage:
anyOf:
- type: integer
format: int64
- type: 'null'
order_grid_enabled:
type: boolean
num_open_orders:
anyOf:
- type: integer
format: int64
- type: 'null'
open_orders_step:
anyOf:
- type: integer
format: int64
- type: 'null'
open_orders_factor:
anyOf:
- type: integer
format: int64
- type: 'null'
open_price_deltas:
type: array
items:
type: integer
format: int64
open_quantity_percent:
type: array
items:
type: integer
format: int64
sl_enabled:
type: boolean
sl_type:
anyOf:
- type: integer
format: int64
- type: 'null'
sl_step_percent:
anyOf:
- type: integer
format: int64
- type: 'null'
sl_price_rearrangement:
type: boolean
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'
slx_sl_trigger_price_trailing_enabled:
type: boolean
slx_sl_trigger_price_trailing_pl_percent_activation:
anyOf:
- type: integer
format: int64
- type: 'null'
slx_sl_trigger_price_trailing_indent_percent:
anyOf:
- type: integer
format: int64
- type: 'null'
slx_sl_trigger_price_trailing_step:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_enabled:
type: boolean
tp_price_rearrangement:
type: boolean
tp_grid_enabled:
type: boolean
num_tp_orders:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_orders_step:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_orders_factor:
anyOf:
- type: integer
format: int64
- type: 'null'
tp_pnls:
type: array
items:
type: integer
format: int64
tp_quantity_percent:
type: array
items:
type: integer
format: int64
open_order_type:
type: integer
format: int64
sl_order_type:
type: integer
format: int64
tp_order_type:
type: integer
format: int64
created_at:
type: integer
format: int64
updated_at:
type: integer
format: int64
required:
- id
- user_id
- name
- instrument_type
- position_side
- order_grid_enabled
- open_price_deltas
- open_quantity_percent
- sl_enabled
- sl_price_rearrangement
- slx_enabled
- slx_tp_trailing_enabled
- slx_each_tp_trailing
- slx_sl_trailing_breakeven_enabled
- slx_sl_trigger_price_trailing_enabled
- tp_enabled
- tp_price_rearrangement
- tp_grid_enabled
- tp_pnls
- tp_quantity_percent
- open_order_type
- sl_order_type
- tp_order_type
- created_at
- updated_at
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
securitySchemes:
ApiKey:
type: http
scheme: bearer
bearerFormat: lx_api_.<256-bit secret>
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.