Welcome to GTS Trading 👋
New here and it feels like a lot? It isn't. Everything you do follows one simple chain: write a condition → wrap it in a strategy → get alerted or trade it → watch it run. This guide answers the exact questions in the order most people ask them.
Tip: use the table of contents on the left to jump to any question. Click a question to expand its answer.
1 Getting started
Read this section first — it removes 90% of the confusion. The three words below (expression, strategy, handler) are the whole mental model.
Q What is this app and what can I do here? ▶
GTS Trading lets you describe market conditions (e.g. "RSI on the 1h is below 30") and then choose what happens when that condition becomes true: get a signal/alert, or open and close positions on a connected exchange (paper or real).
You do all of this without writing code — though you can bring your own C++ or Lua if you want. The main areas, from the top nav:
| Area | What it's for |
|---|---|
| Builder | Create expressions, strategies & handlers. Where you start. |
| My Expressions | Your saved conditions library. |
| My Strategies | Strategies you've assembled and can deploy. |
| Signal Monitor | Live feed of which conditions/strategies are firing. |
| History Requests | Run a strategy over past data to see how it would have behaved. |
| Monitor | Deep operational view of running strategies & positions. |
| Charts / SEC Edgar | Price charts and company filings for research. |
| Plans / Settings / API Docs | Billing, exchange connections, programmatic access. |
Q What's the difference between an Expression, a Strategy, and a Handler? ▶
This is the thing to understand. They stack:
| Term | Plain meaning | Example |
|---|---|---|
| Expression | A single condition that is either true or false right now. | RSI(14) < 30 |
| Handler | The "what to do" — open a buy, close, send an alert — and the rules around it (size, take-profit, stop-loss). | "Buy 1 lot, TP +2%, SL −1%" |
| Strategy | The package: one or more expressions wired to handlers, on a symbol/timeframe, ready to deploy. | "On EURUSD 1h, when RSI<30 → buy; when RSI>70 → close" |
Q What's the typical flow from start to finish? (the 60-second tour) ▶
- In Builder → Expression Builder, type a condition in plain English and hit Parse. Save it.
- Switch to Builder → Strategy & Handler. Pick your expression as the entry condition, set the action (alert or open position).
- Decide: do you just want to be alerted, or do you want it to open/close positions?
- Deploy it. Start on paper/demo until you trust it.
- Open Monitor / Signal Monitor to watch fires and positions live.
Q Alerts vs trades — what actually happens when a signal fires? ▶
- Alert: you get notified (in Signal Monitor and any channels you've set up). Nothing is bought or sold.
- Trade (paper): the strategy opens/closes a position on the GTS paper-trading account — a simulated account GTS manages. This is the default and needs no broker.
2 Expressions (the Builder)
An expression is one true/false condition. There are four ways to make one — pick whichever feels easiest. They all produce the same thing.
Q How do I build a simple expression in plain English? ▶
The quickest way is a Quick Template: pick an indicator, fill in the params, and Save — done. Prefer to type it out in plain English? Use the Quick Create box at the top of the Expression Builder:
- Type the condition the way you'd say it:
RSI(14) < 30 5minorMACD cross above signal 15min. - Click ⚡ Parse.
- The builder fills in below. Give it a name and Save.
Don't know where to start? Click one of the example chips under the box — RSI(14) < 30, SMA(50) > SMA(200), Close > BB Upper — to load it instantly.
The basic shape is LEFT OPERATOR RIGHT with an optional timeframe (no symbol — on the trading side a symbol is applied later, at the strategy) — but Quick Create handles more than that:
- Unary (getter) — a single value on its own, no operator, e.g.
RSI(14)orDonchian upper. (A comparison likebullish engulfing > 0is binary — it has two sides.) - Compound — type the whole condition and it auto-builds the legs plus combiner:
RSI(14) < 30 and balance > 100, 3+ terms, mixedAND/ORwith parentheses ((a OR b) AND c), and crossings (RSI(14) crossed 30). Intermediate steps are created automatically on Save. - Saved-expression refs — reuse a saved expression by name as an operand:
My_SignalA AND My_SignalB.
Prefer plain English? The Generate with AI box turns a free-form description into a validated expression. Full syntax reference: Quick Create — NLP Reference.
Q How do I let AI build the expression for me? ▶
Use the Generate with AI box. Describe what you want in everyday language and the AI writes, validates, and loads the expression for you.
- Type a description: "EURUSD when RSI 14 on 1h is below 30" or "gold 5min close crosses above EMA 200".
- Press Generate with AI (or Ctrl+Enter).
- Review what it loaded, then Save.
0 / 8,000,000 tokens used · 100% left). Every paid plan includes a daily token allowance; the Free plan has none (use Quick Create instead). Run out? Buy a prepaid top-up pack or wait for the daily reset. See §6 plans & tokens.Q How do I import an expression as JSON, or from ChatGPT / Claude? ▶
Use JSON Import ADVANCED at the bottom of the Expression Builder.
- Have a complete expression JSON object? Paste it in the box and hit Import — it loads straight into the builder.
- Don't want to hand-write JSON? Click Copy AI Schema Link, paste it into ChatGPT / Claude / Gemini, and ask the model to generate the expression JSON for you.
- Paste the model's result back here and Import.
Q How do I build an expression by hand (visual builder)? ▶
Below the Quick Create methods is the visual operand builder for full control:
- Set the left operand (e.g. an indicator, price, or account value).
- Pick the operator (
>,<, cross above, etc.). - Set the right operand (another indicator, or a fixed value).
- Choose the symbol and timeframe, then Save.
Q How do I add an expression from the Community? ▶
There are tens of thousands of shared expressions you can reuse.
- In the left library panel, click the Community tab.
- Search or browse, then click an expression to preview it.
- Use Import / Copy to mine — it's added to My Expressions so you can edit it freely.
Q What's the difference between All / Mine / Community / Old? ▶
- All — everything visible to you.
- Mine — only expressions you created or imported.
- Community — shared by other users; import to reuse.
- Old — archived/previous versions (e.g. items moved aside on a plan downgrade).
The filter chips ANY HELPER ALERT narrow the list by role (next question).
Q What's a Helper expression vs an Alert expression? ▶
- ALERT Alert expression — a complete condition meant to fire on its own (notify you / trigger a handler).
- HELPER Helper expression — a reusable building block you reference inside bigger expressions. Helpers usually don't fire by themselves; they feed the ones that do.
Q What expression types exist? ▶
GTS has 35+ operand types — far more than the basics. Each is an ElementType plus that type's required fields, producing a value or a boolean event you compare. Grouped by family:
| Family | Types (ElementType) | What they read |
|---|---|---|
| Indicators | TA_Indicators, ExtendedIndicators | RSI, SMA, MACD, ATR… plus advanced tools (FVG, Order Block, SMC/ICT, adaptive & ML/regime) |
| Price & bars | OHLC_Bar, Quotes, RenkoBar, HeikinAshiBar, TickRevBar, TicksPerPeriod | Open/High/Low/Close/volume, bid/ask, and alternative bar types |
| Patterns | TA_CandlePatterns, PricePattern, ABCPattern, FibonnaciBar, PivotObject | Candlestick & price-structure events, pivots, Fibonacci, ABC waves |
| Trend & channels | TrendObject, ChannelObject, PriceMoveObject, ConsensusScore | Trend side/length/speed, channel bounds, price moves, multi-signal consensus |
| Account & positions | AccountObject, AccFrameObject, RollingAccFrameObject, LastOpenPositionObject, ClosePositionObject, StrategyOpenPositions | Balance, equity, used margin, open P&L, and open/closed position details |
| Fundamentals | Fundamental | EDGAR financials — revenue, EPS, ratios… |
| Date & time | DateValue, HourValue | A date, or the hour of day |
| Fixed values | FixedVal, SideValue | A fixed number, or a trade direction (long / short) |
| Reference data | Symbol | Symbol context — tick size, margin, contract specs, and other instrument reference data |
| Reusable & composition | UserExpression, StateMachineExpression, CollectionTransform, HistValue, ExpressionMeta | Any saved expression is reusable — reference it by name as a UserExpression building block. Plus multi-step state machines, history lookback & transforms |
| Code (Private) | LuaScriptOperand (Lua), CustomizedUserOperand (C++) | Inject your own Lua or C++ operand — private servers only (2 code-injection types) |
> 0 (not == 100), and a trend is required.UserExpression) inside a bigger expression. That's how small helpers compose upward into full alert/strategy logic.GET /api/v1/expression-schema?type=<ElementType> returns that type's exact required fields and a runnable example (add ?format=json for structured output); POST /api/v1/expressions/validate checks any JSON against the live validator before saving; POST /api/v1/expressions pushes it. The schema endpoint is the authoritative, always-current list of every type — see Control via API.Q How do I compose a complex expression? ▶
Build bottom-up:
- Define the atomic value getters first as named, reusable helpers (e.g. a named "RSI 1h" or "ATR band").
- Compose the upper levels on top by referencing those helpers instead of re-typing them.
- Combine with
AND/ORto express multi-condition logic.
Q How do I view / inspect an expression (and see its JSON)? ▶
Click an expression in the left library to open the Expression Viewer. It shows the full definition — what it reads, the operator, the symbol/timeframe, and any helpers it references.
- Copy JSON — copy the raw expression JSON (useful to share, version, or feed to an AI model).
- Export — save the definition out (see Share / export).
- Site link — get a link back to the expression.
Q How do I test an expression's live value before I save it? ▶
As you build, the Expression Preview panel evaluates your expression and shows the result so you can sanity-check it before saving.
- Build or load the expression in the builder.
- Look at the Expression Preview panel — it reads "Build your expression above to see a preview here" until the expression is valid, then shows the evaluated value/result.
- If the preview looks wrong, fix the operands and watch it update.
Q How do I edit, duplicate, or delete an expression? ▶
Each item in the left library has three icons:
- ✏️ Edit — load it back into the builder to change it.
- 📋 Duplicate — make a copy to tweak without touching the original.
- 🗑️ Delete — remove it from your library.
8/100000 saved counter in the header).Q How do I create and control expressions remotely via the API? ▶
Everything you do in the Builder you can also do programmatically with your API key (Settings / Account → API). The versioned endpoints:
| Action | Endpoint |
|---|---|
| Create an expression | POST /api/v1/expressions |
| List your expressions | GET /api/v1/expressions |
| Validate without saving | POST /api/v1/expressions/validate |
| Update an expression | POST /api/v1/expressions/update |
| Duplicate | POST /api/v1/expressions/copy |
| Pause / unpause | POST /api/v1/expressions/pause · /unpause |
| Delete | POST /api/v1/expressions/delete |
| Browse community | GET /api/v1/community/expressions |
Full request/response shapes and auth: API Docs.
/api/v1/expressions.3 Using an expression as an Alert
The simplest use of an expression: get notified when it becomes true, without any trading.
Q How do I turn an expression into an alert? ▶
- Make sure the expression is marked as an ALERT (not just a helper).
- Attach it to a strategy/handler whose action is alert / notify rather than open-position.
- Deploy it. It now evaluates on live data and notifies you when true.
Q Where do alerts get delivered? ▶
Fires show up in the Signal Monitor in-app feed. Additional delivery channels are configured in your account/settings.
Q How do I make something alert-only / report-only (no trade)? ▶
Choose a handler action that notifies but never issues an order. In strategy terms this is a report/alert-only handler — it reports the fire and stops there, so no position is opened even on a real account.
Q How do I pause or stop an alert? ▶
Un-deploy / stop the strategy that carries the expression (from My Strategies or Monitor). The expression stays saved in your library; it just stops evaluating.
4 Strategies, handlers & positions
When you want the platform to actually open and close positions, you wrap expressions in handlers inside a strategy. Built in Builder → Strategy & Handler.
Q How do I build a strategy? ▶
- Open Builder → Strategy & Handler.
- Pick the symbol. The timeframe is derived from the expressions you select — a default is used only if it can’t be derived.
- Add an entry handler: choose your expression as the trigger and the action (open position / alert).
- Add an exit handler: a condition or TP/SL that closes the position.
- Name and Save it — it appears under My Strategies.
Q How do I view / inspect a strategy? ▶
Open My Strategies to see your library. Each strategy shows its symbol, timeframe, the expressions it uses, its handlers, and its current status (saved / deployed). Click one to inspect the full definition.
The strategy library has source tabs so you can also browse strategies that aren't hand-built:
- Config — your own saved strategies.
- Community — strategies shared by others.
- Permutation — strategies generated by a Mass / permutation session.
Q How do I edit or duplicate a strategy? ▶
- From My Strategies, open the strategy and choose Edit — it loads back into the Strategy & Handler builder.
- Change the symbol/timeframe, swap the arm expressions, or adjust the strategy parameters (position size, SL/TP, hedging, trailing).
- Save to update it.
To experiment without touching the original, Duplicate it first and edit the copy.
Q How do expressions drive a strategy? (the 4 handler arms) ▶
This is the key idea. A strategy has four handler arms, each with its own expression box:
| Arm | What it does when its expression is true |
|---|---|
| Open Bid | Opens a position on the bid side. |
| Open Ask | Opens a position on the ask side. |
| Close Bid | Closes the bid-side position. |
| Close Ask | Closes the ask-side position. |
You map any saved expression into each arm's box. The rule is identical for all four arms: when that arm's expression evaluates true, that arm's operation fires. Open and close work exactly the same way — close is not a special case.
- Open Builder → Strategy & Handler.
- For each arm you want active, pick an expression in its box (leave arms you don't need empty).
- Set that arm's policy and zone, then Save.
Q How does a position get opened? ▶
You don't open it by hand — the engine does it for you. That's the whole point of algotrading: the strategy triggers the position automatically when your condition becomes true. There's no manual "buy" step.
- Put your entry expression in the Open Bid or Open Ask arm (whichever side you want).
- Deploy the strategy to a trading account.
- When that arm's expression evaluates true, the engine opens the position automatically — on the GTS paper-trading account (no real order is ever placed).
How big, and with what risk controls, is decided once at the strategy level — position size, SL/TP, hedging, trailing — not on the arm.
0.01 units) may be needed — set the strategy size accordingly and check your symbol's minimum.Q How do I close a position? ▶
Closing works exactly like opening — you just use the Close Bid / Close Ask arms instead. Any expression you set in a close box can trigger the close; there is no special "exit expression" type.
- Put the condition you want to close on (e.g.
RSI(14) > 70or an account-P&L condition) into the Close Bid or Close Ask box. - When that expression evaluates true, that side's position is closed automatically.
Because it's the same mechanism as open, you can close the bid side and the ask side dynamically and independently, each by whatever expression you choose. (Strategy-level SL/TP and trailing also close positions automatically — those are set once on the strategy, separate from the close arms.)
Q What are Mass / Permutation strategies for? ▶
The Mass Strategies tab generates many variations of a strategy at once — e.g. the same logic across many symbols, or sweeping a parameter (RSI 20/25/30…). It's how you test a whole grid of ideas instead of building each by hand.
Q How do I deploy a strategy? ▶
- From My Strategies (or the builder), choose Deploy.
- Confirm. It begins evaluating on live data; opened/closed positions and alerts appear in Monitor.
Q How do I stop / undeploy a strategy? ▶
- Go to My Strategies or Monitor and find the running strategy.
- Choose Stop / Undeploy. It stops evaluating live data and stops issuing alerts/orders.
The strategy definition stays saved — you can re-deploy it later. Undeploying is the safe way to pause something that's misbehaving.
Q Why is my strategy limited when a real exchange is active? ▶
Because GTS never places live orders, a strategy running against a real-mode exchange may only use account-monitoring expressions (e.g. account balance, margin, open P&L). There are no buy/sell orders to place on a real account — only metrics to watch and alert on. A safety guard at deploy time enforces this. Common causes of a block:
- The strategy uses trade/entry expressions that aren't valid against a monitor-only real account.
- The provider isn't connected, has no valid credentials, or isn't Set Active.
- The strategy bundle didn't pass validation (missing handler/expression pieces).
Want order-opening behaviour? Run on the default GTS paper-trading account — paper execution has no such restriction. Use real-mode providers for monitoring + alerting on your actual account.
Q How do I delete a strategy? ▶
- If it's deployed, stop/undeploy it first (see above).
- From My Strategies, choose Delete on the strategy.
Q How do I create and control strategies remotely via the API? ▶
Everything in the Strategy builder is available programmatically with your API key:
| Action | Endpoint |
|---|---|
| Create / save a strategy | POST /api/v1/strategies |
| List your strategies | GET /api/v1/strategies |
| Save a strategy + handler | POST /api/v1/strategy-handler |
| Get the strategy JSON schema | GET /api/v1/strategy-schema |
| Duplicate | POST /api/v1/strategies/copy |
| Delete | POST /api/v1/strategies/delete |
| Deploy (one / many) | POST /api/v1/deploy · /deploy-batch |
| List deployed strategies | GET /api/v1/deployed |
Full request/response shapes and auth scopes: API Docs.
/api/v1/strategy-schema, give it to an AI model, and have it generate a valid strategy JSON you POST straight to /api/v1/strategies — the same pattern as expressions.5 Monitoring & history
See what's firing now, and test how a strategy would have behaved in the past.
Q How do I see my live strategies and fired signals? ▶
Two views:
- Signal Monitor — a clean feed of conditions firing.
- Monitor — the deep operational view: running strategies, open positions, P&L, status.
Q How do I run a History Request (backtest-style) and read the results? ▶
- Open History Requests.
- Select the strategies to test (from Mine / Community / your permutation sessions).
- Submit the run. Submit = start, Cancel = stop.
- Watch status, then open the results to see how it would have behaved.
Q How do I view Charts? ▶
Open Charts from the nav for price charts, or SEC Edgar for company filings/fundamentals research. These are read-only research tools — they don't change your strategies.
6 Quotas, limits & plans
Every plan has limits. The good news: the app shows them to you right in the header.
Q How do I know my quota? ▶
Look at the top-right of the header — it shows live counters, e.g. 8 / 100000 saved and 2.4k / 100k fires. The kinds of quota:
| Quota | Where to see it |
|---|---|
| Saved expressions/strategies | Header X/Y saved counter. |
| Signal fires | Header X/Y fires counter. |
| AI tokens | Under the Generate-with-AI box (0 / 8,000,000 used). |
| History runs | On the History Requests page. |
| Full breakdown | Account → Usage tab. |
Q What are the Plans and what does each include? ▶
Open the Plans page from the nav to compare tiers and what each unlocks (limits on saved items, fires, AI tokens, history runs, real-account trading, API access). Upgrade/downgrade from there or the Account → Billing tab.
AI tokens — what each plan includes
Every paid plan comes with a free daily AI-token allotment that resets each day (a per-plan staircase — higher tiers get more). The Free plan includes no AI tokens, so use the always-free Quick Create there. Tokens are spent only by Generate with AI and in-app AI JSON generation — never by Quick Create, hand-building, or pasting your own JSON.
Need more than your daily amount? Buy a prepaid top-up pack from the Plans / Billing page. Top-up tokens are spent after your daily plan tokens are used up, and they don't expire at the daily reset. The live Plans page shows the exact daily amount and pack sizes for each tier.
Q What happens when I hit a limit or downgrade? ▶
If you exceed a cap (or drop to a smaller plan), over-cap saved items aren't deleted — they're archived to a "Previous-Config" area and retained (90 days). Your live items keep working up to the new cap.
Q How do I upgrade or restore archived config? ▶
- Upgrade your plan from Plans or Account → Billing.
- Open the Previous-Config tab to review archived items.
- Restore the ones you want back into your active library (within the 90-day window).
7 Settings, account & deletion
Q How do I connect an exchange, and what does it do? ▶
Open Settings → Providers. Supported providers: Bybit, FXCM, Binance, OANDA. Credentials are stored per-user.
- On the provider you want, click Configure and enter your API credentials. Pick the mode: Demo or Real (Run Mode).
- You must explicitly turn it on — flip Set Active on that provider's card. (Set Active stays disabled until valid credentials are saved.)
- Only one provider is active at a time — activating one switches the others off. Turning the active one off returns you to the GTS default stream + paper trading.
| Mode | What happens |
|---|---|
| No provider (default) | GTS default stream + GTS paper-trading account. Strategies open/close positions internally. Nothing real. |
| Provider — Demo mode | Monitors the provider's demo account + alerts on metric changes. No trades placed. |
| Provider — Real mode | Monitors your real account + alerts on any metric change. Still no live trading. |
Q How do I manage my account, security, and billing? ▶
Click your avatar (top-right) to open Account. Tabs: Overview, Usage, Security (password / sessions), Billing (plan / invoices), and History.
Q How do I delete an expression, a strategy, or my account? ▶
- Expression / strategy — use the 🗑️ delete icon in its library list.
- Deployed strategy — stop/un-deploy it first (Monitor / My Strategies), then delete.
- Your account — Account → Security/Billing, or contact support@gts-trade.com.
Q How do I use the API? ▶
Open API Docs from the nav. The versioned /api/v1/* layer lets you create expressions/strategies, run permutations, deploy, and pull stats programmatically using a personal API key (read / write / control scopes).
8 Troubleshooting
Q My expression won't parse or validate — why? ▶
- Check the
LEFT OPERATOR RIGHTshape — a missing operand is the usual cause. - Candle patterns need a trend and compare
> 0(not== 100). - Decimal indicator params (e.g.
SAR(0.02,0.2)) must use function syntax, not dot-notation. - Still stuck? Try Generate with AI — it validates as it builds — or check the NLP reference.
Q Why is a Community import "blocked / missing deps"? ▶
The shared expression references helper building-blocks that weren't bundled when it was published, so its dependency closure is incomplete. It's a data issue with that shared item, not your account.
Pick a different community item, or rebuild the logic yourself with the four creation methods in §2.
Q My strategy didn't fire or didn't trade — why? ▶
- Not deployed, or deployed to the wrong account (paper vs real).
- The condition simply wasn't true yet on live data — check Signal Monitor.
- Real-account guard blocked the trade — see §4.
- No exit path, so a position opened but never closed (or vice-versa).
- You hit a fires/quota cap — check the header counters.
- The handler is alert/report-only, so it notifies but never trades by design.