# Liftx Docs

> Build trading integrations with the Liftx API and TradingView. Exact contracts, scoped access, JSON alerts, and Pine examples.

- [Build with Liftx](https://docs.liftx.io/index.md): API contracts, TradingView automation, and practical guides for account-scoped trading integrations.
- [Choose your integration](https://docs.liftx.io/getting-started.md): Select API or TradingView access and validate the complete command-to-position workflow.
- [Availability and boundaries](https://docs.liftx.io/availability.md): Understand the documented release state and what each integration currently supports.
- [Integration glossary](https://docs.liftx.io/glossary.md): Understand account links, instruments, strategy sources, position references, and execution evidence.
- [Credential and execution security](https://docs.liftx.io/security.md): Scope keys, handle one-time secrets, rotate access, and reconcile uncertain execution.
- [Integrations](https://docs.liftx.io/integrations/overview.md): Choose a scoped connection for chart alerts, automated controllers, and future AI clients.
- [Read integration Activity](https://docs.liftx.io/integrations/activity.md): Inspect command evidence, group outcomes, and positions without confusing an accepted signal with execution.
- [API overview](https://docs.liftx.io/api/overview.md): Build exchange-neutral automation on Liftx position and order management.
- [API keys and permissions](https://docs.liftx.io/api/authentication.md): Create, restrict, rotate and revoke a Liftx API key.
- [Accounts, instruments and balances](https://docs.liftx.io/api/accounts-and-instruments.md): Resolve an exact execution market and understand precision, units and snapshots.
- [Prices, quantities and exact decimals](https://docs.liftx.io/api/precision-and-units.md): Copy a valid order request or encode decimal strings without floating-point rounding.
- [Position, order and fill state](https://docs.liftx.io/api/position-state.md): Interpret canonical publications, numeric status projections and exact exposure accounting.
- [Commands, receipts and retries](https://docs.liftx.io/api/commands-and-receipts.md): Separate durable intent, execution ownership and actual trading outcome.
- [Complete position JSON](https://docs.liftx.io/api/position-request.md): Every OPEN, SL, SLx, TP, grid and modification field in the canonical request.
- [Open a position](https://docs.liftx.io/api/open-positions.md): Build catalog-sized market or limit entries with complete SL, SLx and TP configuration.
- [Modify positions and attached orders](https://docs.liftx.io/api/modify-positions.md): Use a fresh revision and exact current row identities for a complete modification.
- [Cancel or close a position](https://docs.liftx.io/api/terminate-positions.md): Terminate an exact lifecycle, then verify cancellation, exposure and completion independently.
- [Protections, grids and rearrangement](https://docs.liftx.io/api/protections-and-grids.md): Configure fill-aware protection once and retain Liftx execution ownership.
- [Templates, history and reporting](https://docs.liftx.io/api/templates-and-history.md): Manage account templates and consume canonical P&L reporting safely.
- [Scoped WebSocket protocol](https://docs.liftx.io/api/streams.md): Decode binary frames, maintain exact-link snapshots and recover from state gaps.
- [Errors, limits and safe recovery](https://docs.liftx.io/api/errors-and-limits.md): Interpret admission failures without converting uncertainty into duplicate trades.
- [Professional bot patterns](https://docs.liftx.io/api/bot-patterns.md): Compose supported operations without inventing atomicity, feedback or strategy isolation.
- [Session-owned Settings API](https://docs.liftx.io/api/settings-contract.md): Document credential administration without granting it to trading API keys.
- [Discover API capabilities](https://docs.liftx.io/api/reference/get-v1-discovery.md): Returns version, canonical action names, scopes, advertised request/pending/group bounds and MCP availability.
- [List linked accounts](https://docs.liftx.io/api/reference/get-v1-exchange-links.md): Returns only exact authorized links with registry exchange identity and `live`/`demo` environment.
- [Read balances](https://docs.liftx.io/api/reference/get-v1-balances.md): Returns exact fixed-point free balances, link identity and snapshot_complete.
- [Read the instrument catalog](https://docs.liftx.io/api/reference/get-v1-symbols-list.md): instrument_type is 1 spot or 2 derivatives.
- [Read settlement currencies](https://docs.liftx.io/api/reference/get-v1-symbols-trading-currencies.md): Returns eligible settlement currencies in success/message/data.
- [Read fee rates](https://docs.liftx.io/api/reference/get-v1-fee-rates-list.md): Returns success/message/data, with data.fee_rates and expiration.
- [Read liquidation context](https://docs.liftx.io/api/reference/get-v1-liquidation-context.md): The current endpoint requires margin_mode=2 (isolated).
- [List positions](https://docs.liftx.io/api/reference/get-v1-positions-list.md): Returns a canonical positions page for one exact link.
- [Get a position](https://docs.liftx.io/api/reference/get-v1-positions-get.md): Returns success/message/data with a canonical Position publication.
- [Read modification state](https://docs.liftx.io/api/reference/get-v1-positions-get-for-modification.md): Returns the current active Position publication with revision, slots and physical order identities.
- [Look up a position](https://docs.liftx.io/api/reference/get-v1-positions-lookup.md): Resolve an authorized canonical position UUID without inferring account or venue from the UUID.
- [Read position P&L history](https://docs.liftx.io/api/reference/get-v1-positions-pnl-history.md): Returns canonical history for one position.
- [Read dashboard history](https://docs.liftx.io/api/reference/get-v1-dashboard-history.md): Specify the link, its actual live/demo environment and a supported reporting currency.
- [List reporting pairs](https://docs.liftx.io/api/reference/get-v1-dashboard-pairs.md): Returns account reporting dimensions, including closed-only pairs.
- [List order templates](https://docs.liftx.io/api/reference/get-v1-templates-list.md): Returns a bare array, including an empty array when no templates exist.
- [Get an order template](https://docs.liftx.io/api/reference/get-v1-templates-get.md): Returns the full bare template object.
- [Create an order template](https://docs.liftx.io/api/reference/post-v1-templates-create.md): Body limit is 64 KiB.
- [Update an order template](https://docs.liftx.io/api/reference/put-v1-templates-update.md): Use the query id and a complete reviewed template.
- [Delete an order template](https://docs.liftx.io/api/reference/delete-v1-templates-delete.md): Deletes the exact account-owned template, not a position or its orders.
- [Submit a trading command](https://docs.liftx.io/api/reference/post-v1-commands.md): Complete OPEN, MODIFY and TERMINATE requests, acceptance receipts and admission errors.
- [List command receipts](https://docs.liftx.io/api/reference/get-v1-commands.md): Page through up to 50 top-level receipts in the authenticated integration namespace.
- [Get a command receipt](https://docs.liftx.io/api/reference/get-v1-commands-get.md): Read one command or a TradingView group with its exact child outcomes.
- [Open a scoped state stream](https://docs.liftx.io/api/reference/get-v1-stream.md): Upgrade with a Bearer header, subscribe within one exact link and decode versioned binary data.
- [Receive a TradingView alert](https://docs.liftx.io/api/reference/post-v1-tradingview-events.md): Use the hooks host, valid JSON and exactly one nonnull alert or command.
- [List credential metadata](https://docs.liftx.io/api/reference/get-integrations-credentials.md): Returns at most 100 active-first/recent credential metadata entries plus tradingview_available.
- [Issue an approved credential](https://docs.liftx.io/api/reference/post-integrations-credentials.md): Submit the same operation_id and full approved request.
- [List TradingView setups](https://docs.liftx.io/api/reference/get-integrations-bindings.md): Returns unrevoked bindings with exact link/instrument, source, immutable revision, quantity cap and management policy.
- [Create a TradingView setup](https://docs.liftx.io/api/reference/post-integrations-bindings.md): Create one restricted setup/credential for an exact link and instrument.
- [Revoke an API or TradingView key](https://docs.liftx.io/api/reference/post-integrations-credentials-revoke.md): 200 revoked:true confirms revocation.
- [Disconnect a TradingView setup](https://docs.liftx.io/api/reference/post-integrations-bindings-revoke.md): Revoke the integration namespace and its access through all associated credentials.
- [Start fresh authentication](https://docs.liftx.io/api/reference/post-integrations-reauth-start.md): Bind a canonical operation UUID, purpose and exact request to a five-minute approval attempt.
- [Verify fresh authentication](https://docs.liftx.io/api/reference/post-integrations-reauth-verify.md): Proof has exactly one of password or apple_token, with mfa_code when required.
- [List account Activity receipts](https://docs.liftx.io/api/reference/get-integrations-commands.md): Returns an account-owned receipt page, unlike the API namespace list.
- [Read an Activity receipt](https://docs.liftx.io/api/reference/get-integrations-commands-get.md): Returns one account-owned receipt and bounded group targets when present.
- [TradingView integration](https://docs.liftx.io/integrations/tradingview/overview.md): Send chart alerts or Pine signals to Liftx while retaining Liftx position and protection management.
- [Create and manage a TradingView setup](https://docs.liftx.io/integrations/tradingview/setup.md): Every permission, opening policy, quantity cap and one-time secret control in Liftx Settings.
- [JSON alerts without Pine](https://docs.liftx.io/integrations/tradingview/ordinary-alerts.md): A complete entry-and-exit setup using TradingView price or indicator alerts and generated Liftx JSON.
- [TradingView placeholders](https://docs.liftx.io/integrations/tradingview/placeholders.md): Which TradingView substitutions belong in Liftx JSON, and when Pine must construct the message.
- [Pine Script integration](https://docs.liftx.io/integrations/tradingview/pine.md): Set up private Pine v6 alerts, select a helper, and customize signal logic without losing lifecycle identity.
- [Continuous Pine example](https://docs.liftx.io/integrations/tradingview/pine-continuous.md): Repeated confirmed-bar OPEN and termination intents with one running strategy and fresh lifecycle references.
- [One-shot Pine example](https://docs.liftx.io/integrations/tradingview/pine-one-shot.md): A bounded demonstration emitting at most one OPEN and one later termination.
- [Exit-only Pine example](https://docs.liftx.io/integrations/tradingview/pine-exit-only.md): Confirmed-bar group termination without any opening payload or inferred position reference.
- [Existing strategies and order-fill alerts](https://docs.liftx.io/integrations/tradingview/strategy-alerts.md): Integrate a Pine strategy deliberately, with complete messages and no ambiguous buy/sell mapping.
- [Advanced webhook command format](https://docs.liftx.io/integrations/tradingview/command-format.md): The canonical Pine envelope, event identity, complete position requests and exact lifecycle follow-ups.
- [Position targets and lifecycles](https://docs.liftx.io/integrations/tradingview/targets-and-lifecycles.md): Exact references, strategy exits, market exits, reusable keys, frozen target sets and ordering fences.
- [Strategy scenarios and boundaries](https://docs.liftx.io/integrations/tradingview/scenarios.md): Practical configurations for continuous cycles, independent markets, grids, protection changes and risk exits.
- [Delivery, Activity and troubleshooting](https://docs.liftx.io/integrations/tradingview/troubleshooting.md): Follow a signal from TradingView delivery through Liftx receipts to actual positions and orders.
- [MCP · Planned](https://docs.liftx.io/mcp/overview.md): Future AI-client access will reuse Liftx API authorization and command semantics.
- [ChatGPT · Planned](https://docs.liftx.io/mcp/chatgpt.md): ChatGPT connection instructions will be published after the Liftx MCP server is available.
- [Claude · Planned](https://docs.liftx.io/mcp/claude.md): Claude connection instructions will be published after the Liftx MCP server is available.

## OpenAPI Specs

- [openapi](/api/openapi.json)


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