> For the complete documentation index, see [llms.txt](https://support.tiger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.tiger.com/english/platform-updates/version-7.0.md).

# Version 7.0

## New features <a href="#novovvedeniya" id="novovvedeniya"></a>

**New Authorization Algorithm**

We have updated the authorization flow in the terminal. Now, four login modes are supported:

1. `Crypto` → Login using Tiger.com Broker credentials to trade on crypto markets
2. `Player` → Login via Player license to trade on historical data
3. `Stock` → Trading on stock markets only
4. `All-in-one` → Combined access to stock and crypto exchanges

🔗 Login instructions: <https://support.tiger.com/english/how-to-start/licenses-and-login>

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FbpNABkkTsthqT3R9aDZ9%2Fnew%20auth.gif?alt=media&amp;token=8dd47ef6-8f43-4f91-802c-16ef68f96bd8" alt=""><figcaption></figcaption></figure>

**Connection to TigerX Exchange**

TigerX is a unified solution for trading on Binance and OKX through a single interface, without switching platforms, while saving up to 50% in fees.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FyLWi2mvSjsfj6r9LGhnD%2FAnimation.gif?alt=media&amp;token=2df5c07d-32c2-4ca8-bb4c-4d872b373013" alt=""><figcaption></figcaption></figure>

**Gate.io Futures Integration**

The terminal now supports connection to the Gate.io Futures section. You can trade futures and access an extended set of trading instruments and market features.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FzkkbUVb6qTB0jW10zUte%2FAnimation.gif?alt=media&amp;token=5e2e7d52-5f09-4129-a60a-b96179c309cc" alt=""><figcaption></figcaption></figure>

**Unified Margin Account Support on Gate.io**

The terminal now supports Unified Margin Account trading on Gate.io. A new connection type is available in the account connection settings.

Margin types supported:

* `Classic Spot`
* `Single-Currency`
* `Multi-Currency`
* `Portfolio`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2F5PynSyhn0wVRBymSlMvi%2Fgta%20uta.gif?alt=media&amp;token=06c4d160-5957-4e26-ab7a-383b46d19629" alt=""><figcaption></figcaption></figure>

**MEXC Spot Integration**

Support for MEXC Spot has been added, allowing access to a broader range of assets and new trading capabilities.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2F7uckTC3BAJlSVLC1IbjN%2FAnimation.gif?alt=media&amp;token=6460ecc4-5a09-450c-a264-a379de5d6657" alt=""><figcaption></figcaption></figure>

**Pre-market Trading Support**

Pre-market session trading is now available on Binance, Bybit, OKX, and Gate.io Spot. You can enter markets early and prepare for the main session with more strategic options.

**Server Alerts**

Support for server-side alerts — independent signal lines that work even when the terminal is not running. Alerts are processed server-side and delivered via Telegram.

**Settings**: `Settings` → `Telegram Alerts` → `Enable server alerts notifications`

Alerts can be managed directly from the chart (as a dedicated object) and from the DOM.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FiKmIcPhkQpRoFf4lPZ0b%2Fserver%20alerts.gif?alt=media&amp;token=2eb74207-04da-4307-8c4e-5785c24faa11" alt=""><figcaption></figcaption></figure>

**Dynamic Average Price Calculation Algorithms**

Final implementation of the new average price calculation modes, supporting isolated position handling while preserving legacy options for flexibility.

**Settings**: `Settings` → `General Settings` → `Trading` → `Average price calculation mode`

**Available modes**:

* `[Unified] Open Only` → Classic formula without “partial close” option
* `[Unified] Part Close` → Classic formula with “partial close” enabled
* `[Isolated] Open Only` → Weighted average of each entry, ignoring partial closes
* `[Isolated] LIFO` → Last-In-First-Out model for average price
* `[Isolated] FIFO` → First-In-First-Out model for average price

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FgsmAaN6J6tQGKJX8x5fk%2FAnimation.gif?alt=media&amp;token=7be09e51-83e8-4ae0-bd32-14830f4cde9f" alt=""><figcaption></figcaption></figure>

**Fast Ticker Switching Across Exchanges**

Clicking on an exchange icon in the chart or DOM opens a menu with similar tickers on other exchanges.

**New setting**: `Settings` → `General Settings` → `Other` → `Market type unavailable display mode`

**Options**:

* `Hide Market Data`
* `Switch to available market type`
* `Auto-switch Exchange`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2Fi0PKAqFt2PtrKAYHhazH%2Ficon%20switcher.gif?alt=media&amp;token=d207ba21-a9ee-4cde-97fb-b331465246e7" alt=""><figcaption></figcaption></figure>

**Bybit Demo Account for Full License Holders**

Bybit Demo trading is now supported for all users with an active `Full` license.

Steps:

* Create demo keys in your Bybit personal area
* In the terminal, create a new Bybit connection
* Choose `Unified Trading Account Demo` and paste your demo keys

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FQwVBG2zEfzzAWFkD05zT%2Fbybit%20demo.gif?alt=media&amp;token=3f8eb1de-222c-4a1f-bde3-5bc259852bd9" alt=""><figcaption></figcaption></figure>

**Chart Object Sync**

Chart objects now sync across windows by color link and ticker.

Enabled via: `Settings` → `General Settings` → `Chart` → `Objects sync`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FHag8wv8ZY5xmUxES7CDZ%2FAnimation.gif?alt=media&amp;token=35d439bb-23ff-4e0e-b454-e46b81ca462f" alt=""><figcaption></figcaption></figure>

**SL/TP Closure Size Display**

Planned PnL is now shown on SL/TP markers in the chart and DOM.

* **Chart**: enabled by default
* **DOM**: `DOM Settings` → `DOM` → `Trading` → `View` → `Planned SL/TP PnL`

Display options:

* `Points`
* `Money`
* `Percent`

PnL display syncs with account currency. You can switch formats via:

* Double-click in DOM
* `DOM Settings` / `Chart Settings` → `Trading` → `View` → `PnL Display Mode`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FxFrtyeKx6b89V30yZdJK%2FAnimation.gif?alt=media&amp;token=d4d27031-c7eb-4fde-a10a-a1349ee54a14" alt=""><figcaption></figcaption></figure>

**Server Protective Orders for OKX**

Stop-loss and take-profit orders can now be placed directly on OKX servers. In case of connection loss, these orders remain active.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FzLaLoBnlavmjZHTM70jl%2FAnimation.gif?alt=media&amp;token=7de6e1d9-7ff8-4707-aa47-99a3081f33a0" alt=""><figcaption></figcaption></figure>

**Open Orders Widget**

New widget shows all active orders, allowing quick review, cancellation, and modification. Located at the top-right near the trading mode toggle.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FYI0TGRYZb2ZyW2rdIM23%2FAnimation.gif?alt=media&amp;token=5413c14a-f6ff-41d3-8038-86d6800d0f3c" alt=""><figcaption></figcaption></figure>

**Exchange-synced Clock Widget**

New clock widget synced with exchange time. Displays custom timers and alerts.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FuDOVrT9lt04p1TZpWGGe%2FAnimation.gif?alt=media&amp;token=a4a4235a-71ff-420e-aacd-c1e02b1fb624" alt=""><figcaption></figcaption></figure>

**Funding Rate Timer**

Displays the current funding rate and countdown until the next update.

Enable in:

* `Chart` → `Settings` → `General Settings` → `Chart` → `Show funding rate`
* `DOM` → `Settings` → `General Settings` → `DOM` → `Show funding rate`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FyfNou08hSRGeq25Z8MhY%2Ffunding%20rate.gif?alt=media&amp;token=e5899fcd-e10d-4087-935a-e95e93499880" alt=""><figcaption></figcaption></figure>

**Long/Short Position Indicator**

Visualize a hypothetical long or short entry before placing a trade.

Calculates projected PnL and risk.

**Location**: `Chart` → `Indicator menu`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2F6wMvylPOsomSwTKGJmkC%2FAnimation.gif?alt=media&amp;token=f4f6aa45-dbed-438c-8d5e-1be8e37cb340" alt=""><figcaption></figcaption></figure>

**Position Sizing by Deposit %**

Specify a percentage of your balance in the lot widget. The terminal auto-calculates trade volume based on base/quote currency and leverage.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FK8d4AGXAd5jauP3xvqzL%2Fexecute%20in%20perc.gif?alt=media&amp;token=b85a0b27-dad2-4c46-b2cd-88906bba80c0" alt=""><figcaption></figcaption></figure>

**Volatility Table Indicator**

Shows:

* Daily volume
* Custom timeframe volume
* NATR
* BTC correlation coefficient

Helps assess volatility and market correlation.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FUE2Ss0T443TvBw78mkaM%2FAnimation.gif?alt=media&amp;token=2a1c4d50-41b7-4b94-82c1-966c37d346cb" alt=""><figcaption></figcaption></figure>

**Current Candle Delta**

Displays % change (delta) of the current bar in the trade tape. Alerts can be configured.

Enable via: `DOM Settings` → `Current Bar Delta`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FR6xeXwrVZr7FK7OXAKfv%2FAnimation.gif?alt=media&amp;token=1e8b9844-9ec8-431f-9d76-e81d84799093" alt=""><figcaption></figcaption></figure>

**Ruler with USDT Mode**

The ruler tool can now measure price movement in USDT.

Enable via: `DOM Settings` → `Ruler` → `USDT`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FX4bBVXnTosUm5vqiDIkC%2FAnimation.gif?alt=media&amp;token=234a8a04-6fd4-49c3-8555-e26b591b8f3b" alt=""><figcaption></figcaption></figure>

**Scroll to Change Volume**

Use mouse scroll in the lot widget to adjust volume.

**Hotkey**: `Settings` → `HotKeys Manager` → `Common` → `Order Size` → `Volume Adjustment via Scroll`

**Scroll type**: `Settings` → `General Settings` → `Trading` → `Lot widget volume adjustment mode`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2F5Gq5WIDMHpkDDPIv0zBQ%2FAnimation.gif?alt=media&amp;token=546e2279-d637-4ca8-a2fa-47d66c5ddff2" alt=""><figcaption></figcaption></figure>

**Isolated DOM Settings**

DOM settings can now be applied individually, using checkboxes next to each parameter.

Enable via: `Settings` → `DOM settings` → `Individual settings mode`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FZkNfnVAoc0c6elU51GrM%2FAnimation.gif?alt=media&amp;token=af91e30d-8225-420b-b91b-f581dd34c9e5" alt=""><figcaption></figcaption></figure>

**Copy Ticker from Quotes**

`Right-click` any ticker in the Quotes panel → `Copy ticker name`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FcrRyLdzD7PRNp86t3cot%2FAnimation.gif?alt=media&amp;token=acb1ced3-388b-426b-beba-87f19bacb8ba" alt=""><figcaption></figcaption></figure>

**Tab-linked Table Sync**

Trade tables can now sync with active tabs using color link. For example, Positions table.

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2Fjdc2hYvv44Q5161OEElD%2FAnimation.gif?alt=media&amp;token=a99a54f6-8344-44ab-afd7-66ac28ff7a7c" alt=""><figcaption></figcaption></figure>

**New Color Themes**

New chart/DOM themes: `Tiger`, `Neo`, `Purple Gray`, `Blue Amber`, `Dimmed`

**Location**: `Settings` → `General Settings` → `Chart Theme` / `DOM Theme`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FCBHTJjBdzxfsGvvRxyWY%2Fthemes.gif?alt=media&amp;token=5444ee92-6597-4ac4-b5a9-447fe6cf6dcd" alt=""><figcaption></figcaption></figure>

**Short Number Format**

Quotes and Screener now abbreviate large numbers:

* `K` → Thousands
* `M` → Millions
* `B` → Billions

**Setting**: `Settings` → `General Settings` → `Tables` → `Short number format`

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2FjyaUbRQGoFv9kcTvSGe5%2Fshort%20num%20format.gif?alt=media&amp;token=bc8f7756-45bd-473e-a090-444d2a1280a1" alt=""><figcaption></figcaption></figure>

**Screener Exchange Filter**

Added filter by exchange. Currently available:

* Binance Futures
* TigerX Binance Futures

<figure><img src="https://2207507098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSB2AVpWygd626dcnm1c%2Fuploads%2Fhg09jFDPsPVwo56Z88zo%2Fscreener%20filter.gif?alt=media&amp;token=2c80e149-e5ae-4144-96a9-1720be0b8310" alt=""><figcaption></figcaption></figure>

## Improvements

**Significant performance optimization**

Rendering of the DOM and trade tape has been optimized to reduce latency, even under high volatility and heavy data flow. This ensures faster system responsiveness.

**SL/TP synchronization upon reconnection**

When the connection is interrupted, server-side protective orders (SL/TP) on OKX are automatically restored, preventing loss and ensuring position protection.

**Timeframe display on chart background**

An option to display the current timeframe in the chart background helps traders remain aware of the analysis interval, supporting more informed trading.

**Tick timer in the clock widget**

The clock widget now shows a countdown until the timeframe changes and can trigger signals accordingly. First, it announces the timeframe, then begins a tick countdown.

**Table depth settings**

An option has been added to control the depth of history in the orders and trades tables. This helps reduce system load by limiting the data volume while preserving necessary information.

**Local time zone display in the clock widget**

The clock can now display time according to the user’s local time zone.

**Updated alert logic for current candle delta**

The logic for generating alerts and displaying the widget has been changed. Now, the alert triggers only once within the current candle.

**Exchange name in notifications**

All notifications now include the name of the exchange associated with the event.

**Exit drawing mode with ESC key**

Chart usability has been improved — now you can exit drawing mode by pressing a single key (ESC).

**Updated Transaq library**

Compatibility and stability with the Transaq terminal connection have been improved.

**Data Virtualization for the Watchlist**

Performance has been optimized for working with large instrument lists in the Quotes table.

**Optional exchange icon in tables**

Users can choose whether to display the exchange icon next to tickers in the Quotes and Orders tables. Configured via:\
Settings → General Settings → Tables → Show exchange icons

**Delivery futures on Bybit**

Support added for trading delivery futures on Bybit.

**Auto-refresh frequency selection**

The app now automatically adjusts rendering frequency based on system load, choosing optimal parameters.

**Ed25519 keys for Binance Spot**

The user data stream has been migrated to WebSocket API v3. The old listenKey mechanism is deprecated.\
New stream provides lower latency and better compatibility.

🔐 **Recommendation**: All Binance Spot traders (except those using Binance Spot via Tiger.com Broker) must generate new Ed25519 API keys in the Binance dashboard and update their connection settings.

📘 Key generation guide: <https://www.binance.com/en/support/faq/detail/6b9a63f1e3384cf48a2eedb82767a69a>

**Improved Funding Rate indicator**

The indicator display algorithm has been updated. Contract specs and time sync with the exchange are now considered. Display unified between Bybit and OKX.

**Short number format in Screener**

Large values (volume, market cap) are now displayed in a short format — e.g., 1.2M, 3.5B.

**Delta calculation from extremes in DOM**

Delta can now be calculated from the candle’s High/Low.\
Settings:\
`DOM Settings` → `General` → `Current bar price delta change, %` → `From Low/High`

**Batch Order support for OKX in TigerX**

Large orders are now automatically split into smaller ones on TigerX OKX.

**Save current logs button**

A quick “Save Logs” button has been added to the diagnostics menu.\
**Location**: `File` → `Diagnostics` → `Save logs` — **no restart required**.

## Fixes

* Protective orders on Binance — SL/TP disappearing after disconnect has been fixed.
* Terminal crash on MEXC — fixed critical error when working with some instruments.
* OKX time sync issue — resolved desynchronization between local and exchange time.
* Trigger order persistence — restored correctly after reconnect.
* SL/TP on Bybit — now restored properly after connection is re-established.
* Stop-market orders on Gate.io Spot — placement and execution issues resolved.
* Cannot close position on GOLDENCAT/USDT (MEXC) — now fixed.
* INVALID\_PARAM\_VALUE on Gate.io — sell stop-orders below last price now accepted.
* Order too small error (Gate.io Spot) — fixed for market orders with small volume.
* Stop-order on Bybit — fixed incorrect level calculation.
* Limit order modification on Binance — volume updates now applied correctly.
* SL/TP sync on Bybit Spot — parameters now restored from exchange correctly.
* Stop-market volume recalc (Gate.io) — resizing no longer breaks logic.
* Average price on partial close — now recalculated properly with “Partial close” enabled.
* Auto SL/TP level correction in DOM — applied exactly as per user settings.
* Editing Gate.io Spot connector — now stable.
* Global DOM settings — no longer overwritten by individual presets.
* Fee calculation on MEXC — correct for all instrument types.
* Horizontal level deletion — now syncs between chart and DOM properly.
* Hotkeys for Long/Short indicator — now working reliably.
* “Magnet” tool crash — “Out of range exception” resolved.
* Missing instrument menu — fixed disappearance after restart.
* Price scaling in trade tape — quote currency volume now scales correctly.
* Ping calculation — optimized for accurate latency.
* \[Gate.io] Order Book depth cap — visible bid/ask levels increased.
* SL/TP cancellation visibility — shows correctly after reconnect.
* Tab text color in light theme — improved for readability.
* Bybit Spot depth — increased for better liquidity visibility.
* Liquidation price column — added to Positions table for better risk control.
* Cumulative Delta indicator — display errors resolved.
* Volume/Open Interest filters — precision improved.
* Auto-filled account in Stats tab — preserved correctly now.
* Docs update across terminal — all links point to latest version.
* Clock widget disappearance — fixed on workspace deletion.
* Settings templates — now correctly applied even if no individual settings exist.
* Volume tick on OKX — step size mismatch resolved.
* Font theme switching — font color now updates correctly.
* Chart shift on object manager close — no more “jumping.”
* OKX position display after restart — now stable.
* Stop order rejection on OKX — fixed behavior and execution logic.
* DOM rendering bug on zoom — no longer loses data.
* Chart resizing — now adjusts smoothly.
* Connection icon overlap — no visual overlap of exchange icons.
* Canceled orders in DOM — background now draws properly.
* Ghost position after Binance Futures liquidation — removed.
* Ticker Ctrl+C copy — now works from Quotes table.
* Mouse scroll volume step in USDT — behavior fixed in lot widget.
* Symbol update on Gate.io — works reliably.
* Crash on custom fonts — now handled safely.
* Bybit: ADL position ghost — removed correctly.
* Fee reset — works when account config is cleared.
* UnifiedOpen strategy fix — average price logic no longer fails.
* TigerX position closing logic — fully rebuilt and stabilized.
* WebSocket reconnect on TigerX — improved recovery and fewer disconnects.
* Incorrect fixed symbol in DOM — now opens correct futures symbol.
* Open positions on OKX — now shown accurately in chart and stats.
* Alert false triggers — resolved during timeframe change.
* Trailing TP — now follows price correctly.
* Lot widget fields — editable regardless of % or USDT mode.
* Chart object sync via link — all changes now applied/undone properly.
* Unified price calc — duplicate profit calc on partial close removed.
* Sloped lines shift on timeframe change — fixed left anchor issue.
* History loading on deep timeframes — now stable.
* Player chart loading — no more missing chart fragments.
* UsedMargin on Binance — displays exact blocked margin.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.tiger.com/english/platform-updates/version-7.0.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
