What you need first
| Component | Requirement |
|---|---|
| Operating system | Windows, 64-bit. The licence is tied to the Windows machine identity, not to a user account. |
| StrategyQuant X | Tested on build 145. StrategyQuant X is a separate product that you license yourself. On a build that ships its own equivalent of something here (the COT blocks in build 145, for example) the matching entry in our blocks is flagged or hidden so you are not offered two of the same thing. |
| MetaTrader 5 | Needed to run the MT5 indicators, to deploy NN Lab models, and as the source of the calendar for News. You do not need MetaEditor or any MQL5 source: the indicators ship compiled. |
| Free API keys | Alternative Data only: a FRED key and an EIA key, both free and registered by you. CFTC data and News need no key. |
| Internet | To activate, to download the packages, for Alternative Data downloads, and for the licence and update check. Day-to-day licence verification is offline. |
Installing
The installer is a small download with no product code inside. It asks for your licence key first, then downloads only the products that licence covers, checks them against a signed manifest, and copies them into your SQX user folder and your MT5 data folders. It runs per user and needs no administrator rights.
Close SQX and MetaTrader 5
Files are replaced, so nothing should be using them.
Run the installer and enter your licence key
One key covers what it was bought for. A later purchase comes with its own key, and the installer takes one key at a time. The next page, Your products, lists what the licence covers with every box ticked; untick any you want to leave out. Run the installer again later to add one.
Choose your folders
Pick the SQX folder and the MT5 terminals (up to eight; you can add a portable terminal folder). The page asks for the terminal’s data folder, which is the one MetaTrader opens with File → Open Data Folder, not its program folder.
Install
The packages are downloaded and verified first; files are copied only when every package has passed. The installer writes
license.licunder%ProgramData%\Alphasworthfor the Java side and under the MetaTrader Common files folder for the MT5 side. It can register one per-user scheduled task, the updater, and the MT5 feed services you tick. It never starts or closes MetaTrader.Start SQX
SQX compiles our block sources itself while it starts, so the first launch after an install or an update takes longer. A block that fails to compile is simply absent from the builder. The plugins (NN Lab, Edge Finder, Alternative Data, News, NameSmith, GapSmith) are delivered already built: there is nothing for you to compile, but SQX loads them only at start, so always restart SQX after installing or updating, or the previous version keeps running.
You never need Code Editor, Compile plugin or MetaEditor to use a licensed install. If a screen still shows an older version after an update, SQX was not restarted.
Where each module appears
| Module | Where to find it in SQX |
|---|---|
| Edge Finder | A tab in the left navigation, labelled Edge Finder. |
| NN Lab | A tab in the left navigation, labelled NN Lab. Trained models also appear as indicators and condition blocks. |
| Institutional Indicators | Building blocks in the Builder and in AlgoWizard (Wyckoff, Cumulative Delta, TWAP, moving-average, pattern, structure, session and candle families). Strategy templates under Wyckoff. |
| Alternative Data | The Alternative data tab in the Data Manager, and blocks under AW AltData. |
| News | The News tab in the Data Manager, and the News timing blocks. |
| SpecSmith | A SpecSmith tab in the Data Manager, plus the AWSpecFeed service (Navigator, Services), which exports your broker’s symbol data, and the AWSpecExport script (Navigator, Scripts) as a manual fallback. |
| GapSmith | A Fix gaps button in the footer of the Data Manager’s Analyze data quality dialog. |
| NameSmith | A NameSmith button among the databank actions. |
Timezones: which modules need you to set one
Most modules need nothing from you. Where a timezone matters, the table says whether you set it.
| Module | Do you set a timezone? |
|---|---|
| SpecSmith | Yes, if you create a broker profile with a timezone: you type it. The Timezone check tests it against a currency pair’s weekly reopening (assuming 17:00 New York) and reports CONFIRMED, MISMATCH, DST-SHIFTED or CANNOT VERIFY; it never changes your setting. MetaTrader’s own offset is today’s only and serves as a cross-check. The separate Fix timezones button checks M1 history whose weekly reopening is one hour off its label. |
| GapSmith | No. The patched symbol keeps the original’s timezone. |
| Edge Finder | Only if the dataset declares no timezone: then type one into Data clock for Time Windows. For currency pairs on H1 or shorter the clock is also checked against the weekly reopening, and a contradiction with the label is flagged. |
| Institutional Indicators | Only for the opening-range block, whose session hours you type in the chart’s own timezone. Session and day boundaries in the other families follow the bar timestamps as stored; no timezone is detected. TWAP has no timezone setting. |
| Alternative Data | No. Observations are dated by UTC date. |
| News | Only if the dataset declares no timezone: set Price data timezone in the News tab. SQX symbols normally carry one. The calendar’s own clock is measured, not set. |
| NN Lab, NameSmith | No timezone setting. |
What is installed, and where
You do not need to touch any of these, but it helps to know where to look when a log or a file is mentioned.
In the StrategyQuant X folder
| Folder | Contents |
|---|---|
user\extend\Plugins\ | The built plugins: NNLab, EdgeFinder, AWAltData (it also hosts News), NameSmith, GapSmith, SpecSmith. |
user\extend\Snippets\SQ\ | Block sources, compiled by SQX at start: indicators and condition blocks, plus the shared libraries they use. |
user\libs\ | Precompiled Java libraries (jar files) that Institutional Indicators blocks call for part of their logic. See the note below. |
user\extend\Code\<platform>\blocks\ | Export templates for each platform. Only MetaTrader 5 and PseudoCode are functional for these blocks; see Platforms. |
user\settings\StrategyTemplates\, user\strategies\ | Wyckoff and book-based strategy templates and example strategies. |
user\extend\AltData\ | Alternative Data’s data root: features\, raw\, backup\, logs\, catalog.csv, and altdata.config (your keys; never share this file). |
user\extend\News\ | The normalised calendar (events.csv, events.meta). |
user\extend\Models\AWNN\ | NN Lab models (.awnn, .awnnm) and the sweeps\ reports. |
user\extend\SpecSmith\backups\ | The values saved before each SpecSmith apply, so it can be undone. |
user\extend\GapSmith\patches\ | The patched CSV and audit log for each GapSmith run. |
user\extend\NameSmith\namesmith.json | Your saved NameSmith templates and the last template used. |
Precompiled libraries
Block sources stay readable source, because StrategyQuant X compiles them itself. For Institutional Indicators, part of the logic is shipped separately as precompiled, obfuscated Java libraries (jar files in user\libs\) that those blocks call by name. Obfuscation makes the code harder to read; it does not make it unreadable, since a jar can be decompiled, and the licence check runs on your own computer.
In MetaTrader 5
| Folder | Contents |
|---|---|
MQL5\Indicators\ | The compiled AW* indicators for the products you installed. |
MQL5\Services\ | AWAltDataFeed, AWNewsFeed and AWSpecFeed (SpecSmith), if you ticked them. |
MQL5\Scripts\ | AWNewsExport and AWAltDataKeys. |
Common\Files\AWNN\ | NN Lab model files read by the NN indicators. |
Common\Files\AWNews\ | The raw calendar dump and the event file read by AWNews. |
Common\Files\AWAltData\ | The alternative-data feature files, their raw caches, and (optionally) altdata.keys. |
Common\Files is shared by every terminal on the computer, which is why one export serves all of them. It is normally %APPDATA%\MetaQuotes\Terminal\Common\Files.
MetaTrader 5 set-up
Indicators
The installed indicators appear in the Navigator under Indicators. Nothing is compiled on your machine. Attach one to a chart as usual; its inputs are documented in the module manual.
Feed services
Alternative Data and News each have an MT5 service that keeps a file current on a terminal that SQX cannot reach, such as a VPS. The installer registers the ones you tick. MetaTrader starts a registered service by itself whenever the terminal runs, so start MetaTrader yourself (on a VPS, set it to start at logon). If a service is not running, start it under Navigator → Services.
Alternative Data’s service downloads from the public data providers, so allow its three hosts, each as its own entry, host only, under Tools → Options → Expert Advisors → Allow WebRequest for listed URL:
https://api.stlouisfed.org
https://publicreporting.cftc.gov
https://api.eia.gov
The installer adds these for you when you tick the service. News needs no WebRequest hosts, because it reads the terminal’s own calendar.
Exported Expert Advisors need StrategyQuant’s own indicators
Every EA that SQX exports calls StrategyQuant’s indicators (SqATR and the other Sq* files), which this product does not include. Copy the Sq*.mq5 files from custom_indicators\MetaTrader5\Indicators in your SQX folder into the terminal’s MQL5\Indicators folder and compile them once in MetaEditor. The AW indicators the strategy uses must be there as well. If this is missing, the EA stops with error 4802 or “cannot load indicator Sq…”.
Running on a VPS
A VPS is normally set up by uploading your terminal from your own PC, so the installer does not run there. Install on your PC, make sure the services and indicators you need are in the terminal you upload, and keep the updater task enabled on any computer that trades live. A VPS needs automatic logon, because the updater task only runs while a user is logged on. The installer defaults to the standard x64 MetaTrader build, which starts on every computer; an optimised (AVX) build is faster but only helps if your VPS CPU supports it.
Your licence
What you bought
A perpetual licence: you pay once, there is no subscription, and every update and future version of the product you bought is included. A licence runs on up to two computers at a time, for example a research PC and a trading VPS, each with the MT5 terminals on that computer that you list at activation.
How it is checked
The licence is a signed file, locked to the Windows machine identity and to the terminals you listed, and it is verified offline by the software against a public key built into it. The activation server is contacted only to activate, refresh, move or reset a licence, to check for updates, to download packages, and to free your seat when you uninstall.
A licence file is valid for 3 days. The updater task renews it at logon and every 24 hours. If a renewal is missed, the software keeps working for a 2-day grace period and tells you to connect to the internet; at the very worst a computer that never goes online again stops 5 days after its last successful refresh.
Moving to a new computer
Run the installer on the new computer and enter your key. If two computers already use the key, the one used least recently is released automatically. You do not need to contact anyone or reset anything first, even if the old computer is gone. The old computer is not switched off at that instant: its licence file stops working at its next refresh, which is within about a day if its updater task is still there. If you only want to free a seat without installing anywhere, use the reset form on the download page. If you lost the key, have it e-mailed to you.
If a licence stops being valid
This happens after a refund, a chargeback or a revocation for sharing a key, and when the file cannot be renewed within the grace period. Gated components then show a clear “unlicensed” message instead of crashing, and never alter or corrupt your SQX projects. Gated blocks return an empty value and log once. A live strategy that depends on a gated block will stop receiving values, which is why the updater task should stay enabled on any computer that trades live.
Updating and uninstalling
Automatic updates
The updater task runs at logon and at the interval above. Each pass refreshes the licence, asks the activation server which packages your licence entitles, and downloads any that are newer (within the same major version, so a lifetime licence is never asked to pay for an update). Every download is checked against a signed manifest and against per-file hashes before anything is applied.
Nothing is installed behind your back: a popup offers Install now or Later, and if SQX or MetaTrader 5 is open it says which to close first. Later, a timeout or Cancel keeps the verified download and asks again at the next pass. Every file a package replaces is backed up first, any failure restores them, and one previous version per product is kept so an update can be rolled back. When it finishes, you are told that SQX needs a restart. The updater’s log is %LOCALAPPDATA%\AWUpdater\updater.log.
Versions, and what changed
Each product has its own version number. The suite also has a release label (currently 1.1.6), which names a batch of updates; a product’s own number changes only when that product’s files do. The changelog shows each product’s number for the release. The updater compares each product separately, so a product that did not change in a release is not downloaded again. The changelog lists every release product by product and marks each change either Behaviour change (strategy results can differ from the previous version) or No change to results code. Read it before you press Install now if you have strategies running.
How update notes appear
The updater does not carry release notes. Its popup names the products that are ready to install and says which of SQX and MetaTrader 5 to close first. When it finishes, a notification and the file %LOCALAPPDATA%\AWUpdater\notice.txt say which products were updated and that SQX needs a restart. What changed is on the changelog.
Going back one version
The updater keeps one previous version per product. To return a product to it, run AWUpdater.ps1 -Rollback <product> in PowerShell from the updater folder inside your Alphasworth install folder, with SQX and MetaTrader 5 closed, where <product> is the package name the updater uses: institutional, nnlab, edgefinder, altdata, news, autorename (NameSmith), gapsmith or specsmith. AWUpdater.ps1 -Status lists the installed packages with their versions and says which have a rollback copy; a package with no rollback copy cannot be rolled back.
Updating by hand, adding a product, repairing
Close SQX and MT5 and run the installer again. On an existing install it offers to repair or update in place, and lets you add or remove products and terminals and set the Alternative Data keys without uninstalling first. Restart SQX afterwards, and re-attach an indicator in MT5 if it was already on a chart.
Uninstalling
Uninstalling removes the files the packages installed and frees your licence seat. It never removes your own data: the Alternative Data keys and downloads, the News event file, trained NN Lab models, and any template or strategy file you changed are left in place. Strategies, models and settings you create belong to you.
Check that it worked
- Start SQX and wait for the first, slower launch. In the Builder, open the Building blocks tab and search for “Wyckoff” or “NN”: the blocks of every product you installed should be listed.
- Open Edge Finder or NN Lab in the left navigation. They should load without an “unlicensed” banner.
- Open the Data Manager and look for the Alternative data and News tabs.
- In MetaTrader 5, open the Navigator and confirm the
AW*indicators are listed.
Troubleshooting installation
| Symptom | Likely cause and fix |
|---|---|
| A tab or block is missing after install | SQX was not restarted, or is still compiling. Restart it and wait for the first launch to finish. A block that fails to compile is absent; the SQX log says why. |
| News or Alternative Data blocks never appear in the Builder | A block is only offered if it can be evaluated. With no calendar imported, or no data downloaded, those blocks are unavailable by design. Import the calendar, or press Update all on the Alternative data tab. |
| A screen still shows the old version | Restart SQX. Plugins are loaded only at start. |
| “Licence expires in N days - connect to the internet” | The licence file has not been renewed. Connect the computer; the updater task refreshes it at the next logon or interval. |
| Third computer will not activate | Entering a key on a third computer releases the one used least recently; if it was refused, check the key was typed in full and the computer has internet access. |
| MT5 EA stops with error 4802 or “cannot load indicator Sq…” | Copy and compile the Sq*.mq5 files, as described above. |
| A service shows nothing in the Experts log | Start it under Navigator → Services; for Alternative Data, allow the three hosts under Tools → Options → Expert Advisors. |
The log files for each module are named in its manual. SQX’s own log is under user\log\StrategyQuant\ in your SQX folder.