> For the complete documentation index, see [llms.txt](https://help.rails.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rails.xyz/trading/ai-assistant.md).

# AI Assistant

**The Rails AI Assistant is in beta.** Its responses may be inaccurate and do not constitute financial advice. You remain responsible for reviewing all information and making your own trading decisions.

***

The Rails AI Assistant allows you to use plain-language requests to access account and market information, and to prepare orders for review. It can retrieve available platform data, calculate order parameters, and create an order card. An order is only placed after you review the card and select Execute.

## Key features

1. **Mobile order preparation:** The assistant can reduce the number of steps required to review account data and prepare an order from a mobile device. You can ask for market information, assess the expected margin impact of a trade, or create an order draft without moving between several trading screens.
2. **Market and product information:** The assistant can retrieve available data across Perpetuals and Options. For example, you can compare Mark and Index prices, review 24-hour trading volume, or check current funding information while remaining on the active trading screen.
3. **Order calculations:** You can describe an order in account-relative terms, such as “use 5% of my account equity at 5x leverage.” The assistant calculates the applicable lot-size rounding, estimated fees, notional value, and margin requirement. It then presents those details in an order card for your review before execution.

*See further down the page for a more detailed list of* [#what-you-can-do](#what-you-can-do "mention") *with the assistant.*

## Using the Assistant

The Rails AI Assistant acts as an order-preparation and account-information tool. It retrieves available platform data, applies the parameters in your request, and prepares an order card for you to review:&#x20;

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FZ58Hqt0ny9bom7KqHxLK%2Fai-assistant-demo.gif?alt=media&amp;token=6e2d8282-6047-4fc7-92b5-14d0f6244ee2" alt=""><figcaption></figcaption></figure>

{% hint style="warning" icon="microchip-ai" %}
**Reminder:** the AI Assistant can make mistakes. It will never submit an order *without your explicit confirmation.* You must verify all details, and choose the execute button to place your order.
{% endhint %}

{% columns %}
{% column width="50%" %}
To use the AI Assistant, open the trading page and select the **AI Assistant** tab beside the **Order form**.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2F7LlELKfYHFRG9Ctw4S1H%2FCleanShot%202026-11-04%20at%2011.39.18%20AM.jpg?alt=media&amp;token=1bc0261a-8ccf-47b2-bf1e-5e6342dad3c1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="50%" %}
Enter a request or choose a suggested prompt. Unless you specify otherwise, the assistant uses the current market and leverage settings.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FsouJI9sAMrw0kIfIMfqM%2FCleanShot%202026-11-04%20at%2011.41.17%20AM.jpg?alt=media&amp;token=14a00631-4839-42a3-b034-6b878c70f5e2" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="50%" %}
For an order request, the assistant prepares an order card that displays the side, size, market, estimated price, notional value, margin requirement, and leverage.

The card may also include notes explaining how it converted a USD amount or rounded the size to the permitted lot size.

Expand the order card to review the full details. You can select **Edit** to change the draft or **Discard** to remove it. Select **Execute** only after you have confirmed that the order details are correct.

{% hint style="info" %}
The order card remains active for five minutes. When it expires, submit a new request to prepare another order.
{% endhint %}
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FpwPLAkgTKTBBznqvdWQj%2FCleanShot%202026-11-03%20at%204.40.42%20PM%402x.jpg?alt=media&amp;token=24b497af-b587-4e71-a40c-345092ed9788" alt=""><figcaption><p>Example expanded order card showing additional order notes, and edit, discard and execute button. The countdown is to the left of the Execute button.</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## What You Can Do

### Order Preparation

The AI Assistant prepares orders for your review based on the order types supported by the order panel:

{% columns %}
{% column width="50%" %}

* Supported Order Types: Stage standard Market, Limit, and native Trigger orders (including Stop-Loss and Take-Profit orders).
* Automatic Parameter Calculation: Auto-calculates size, margin mode, leverage, estimated fill price, fee estimates, and notional value.
* Order Card Review: Every order generates a staged card with a 5-minute countdown. You can expand the card to inspect full details, edit parameters, discard the draft, or execute the order. Unexecuted cards expire automatically to protect you from stale pricing.
  {% endcolumn %}

{% column width="50%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FVFT5phZ8nRkUV74rVKQT%2FCleanShot%202026-11-03%20at%204.38.17%20PM%402x.jpg?alt=media&amp;token=e110d107-dcb0-4c3d-8981-2f7acdbedb0f" alt=""><figcaption><p>Example plain language question, with a prepared order card.</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

* Clarification Prompts: If a request is missing critical parameters (such as specifying Market vs. Limit execution), the assistant asks clarifying questions before generating the draft.

{% hint style="info" %}
Orders placed through the AI Assistant follow the same rules as orders placed from the order panel, and defaults to current settings. Always check the order card before you execute, especially the margin mode, size, price and leverage.
{% endhint %}

### Account & Position Enquiries

{% columns %}
{% column %}
The Assistant can only access your trading information, and it can read from your history to give you more insight at speed.

You can ask the AI Assistant for real-time information regarding your current account status, including:

* Live Positions & History: Check entry prices, unrealized PnL, past position history, and statement data.
* Balances & Equity: Monitor available trading balances, total margin equity, and all-time realized PnL.
* Leverage & Margins: Inspect current leverage configurations and chosen margin modes per market.
* Transfer History: Instantly query prior deposit and withdrawal records.

{% endcolumn %}

{% column %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FZ6YsDinXaye8YGujXq59%2FCleanShot%202026-11-04%20at%209.32.17%20AM.gif?alt=media&amp;token=6a83b010-6572-4334-8ae8-28c14808b290" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Market Data & Contract Specs

{% columns %}
{% column %}
The AI Assistant can report active market statistics across supported trading pairs, including:

* Real-time Pricing: Pull active Mark Prices and Index Prices across supported markets.
* Market Metrics: Check 24-hour trading volumes and active hourly funding rates.

{% hint style="success" %}

## Complex queries are supported, provided the data is available to the Assistant.

In the example to the right, the assistant can quickly give you a market overview of your entire account, or help calculate information such as the exact position size needed within a defined loss amount, but alerts you when there's not enough information to be conclusive.
{% endhint %}

{% endcolumn %}

{% column %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2Fh0EZ7RttSBUa9EZz3Oy0%2FCleanShot%202026-11-04%20at%209.49.55%20AM.jpg?alt=media&amp;token=1e70dd5c-64de-474d-a4d1-7ff281ba9a14" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Limits & Regulatory Guardrails

To protect users and adhere strictly to regulatory standards, the AI Assistant operates within clear system boundaries:

* No Financial or Trading Advice: The assistant is strictly informative and operational. It will never recommend trade strategies, analyze market trends, predict price direction, or offer financial advice.
* Unsupported Order Types: The assistant can only draft order types natively supported by the Rails Order Panel. Advanced or custom conditional types—such as trailing stop-losses—are not supported.
* No Direct Account Actions: Non-trading administrative actions (such as initiating withdrawals or deposits) cannot be performed by the assistant. For administrative tasks or customer support, the assistant will guide you to the appropriate resources in the Help Center.
* Manual Confirmation Required: The AI Assistant cannot submit trades on its own. All staged order cards require manual review and execution.

{% hint style="info" %}
The AI Assistant is not intended to be a replacement for human support, and will direct you to the Help Center if you ask a support-type question. If you ever run into any issues, [Contact Us](https://help.rails.xyz/support/contactus.md) directly - we're always here to help.
{% endhint %}
