The below guides offer step by step instructions for using TDAmeritrade's authorization process, how to setup your own personal consumer key or troubleshoot any problems.

Please select:

For xlq to work with TDAmeritrade market data provided with your account, you need to authorize it. If you are not using your own personal consumer key (see 'configure personal consumer key' below, you need to ensure 'use personal consumer key' is blank, and display the signin window by clicking the ... button in secure login, or clicking 'open signin windows, or pressing Alt-Ctrl-Shift-T
Doing so grants access for 90 days, and you should renew it again before it expires to avoid disruption.

TDA Preferences Authorization 

This will open a browser window allowing you to login to your TDAmeritrade account. Enter your User ID, password, click Login and follow instructions for any 2-step security questions

TDA signin

You will then be asked to Allow xlq access. xlq only accesses market data, and does not place trades, display balances or move money as is shown by TDAmeritrade.

TDA Allow

Once Allow is clicked and authorization completed, a message is displayed. Clicking OK will automatically close the windows. xlq will now connect automatically and return data based on the permissions granted.

TDAAuthComplete

By default xlq is configured to work with TDAmeritrade with multiple users, but it is possible to request your own consumer key providing extra advantages including added security (only managed by you, working only with your account) and control (any limits apply to you and not as a group). A TDAmeritrade authorization will only return data to 1 computer at a time.

If you have not already done so you would need to register at https://developer.tdameritrade.com
Click Register, and enter your user details, i.e.
first name, last name, user name (best use an 8 character name as it refuses if it contains spaces, is too long or too short),
your email address (if using with your TDAmeritrade account it needs to be the same email as associated with your account. If you plan to open an account later, or if it is for delayed data, another email may be used).
Accept the API Developer License agreement, and enter the characters shown in the image to confirm that you are not a robot,
then click Create new account.
Once your developer account is setup you may add an application by selecting 'my apps' then 'Add a new App'.
Give your App a name (no more than 15 characters). This is the name that will be referenced when you sign into TDAmeritrade to authorize its use. Then complete the other fields.
Once added, approval is usually immediate, but it will indicate 'approved' once active.
You will then need to select your app and choose edit, and specify the callback URL which needs to be https://www.qmatix.com/OAuth2.php. Once completed, selecting 'Details' you would see something similar to

TDA App Details 

Then select 'Keys' and note your consumer key, which you will need to enter into xlq preferences

TDA Consumer Key 

From the xlq menu, choose preferences, then select data source specific, TDAmeritrade and enter the consumer key, or copy / paste it as it needs to be identical. Once entered the value is encrypted and only the first 5 characters are displayed. If you change it, you would need to re-enter it entirely. Once entered click Apply which will remove any prior authentication

TDA preferences consumer key 


You may then signin to authorize by clicking the ... button in secure login, or clicking 'open signin windows, or pressing Alt-Ctrl-Shift-T

TDA Authenticate Private key

Once allowed, all connections will be via your personal consumer keys authorization.
xlq uses built in windows Internet Explorer / Edge web browsing to login and authorize with TDAmeritrade. A version compatibility setting is required to be set in the windows registry and is done automatically.
If this setting is not present TDA login will fail with a script error as below, and is likely due to your security software blocking the registry update and you would need to enter it manually.

script error

 
To do so, run regedit and browse to Computer\HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION
Add a new DWORD 32 bit value called xlqeng1.exe,then modify the value, setting it to decimal 11001

 

TDAregedit

You may then restart xlq and signin.
New Tips and Tricks Page
  • A quick reference guide to using xlq2 with excel including shortcuts, tips etc.

  • Examples and explanations for all user levels.
Also available via the Resource menu above, along with references for formulae, symbols etc.

LATEST NEWS:

20 March 2025

XLQ2 25.2 released

  • Balance Of Power

    Balance Of Power indicator now supported.

  • Norgate Data

    Adjusted dividends (xlqhDividendAmountAdjusted) and unadjusted close (xlqhUnadjustedClose) now supported for Norgate.

  • More. >>

Current Offers

1 year of upgrades included
Purchase xlq2Lite for $159
Purchase xlq2 for $299

Pleased with the service and support
or feel extra has been earned?

Your acknowledgement is appreciated.
Thank you

User Comments

It is so uncommon in this day and age to receive top-level, human support and I appreciate that immensely. The quality, breadth and utility of your product is incredible, but even more impressive is the level of support you provided to me, just one individual customer. You may quote me on that. Thank you.

- C.B.

Join the XLQ2 Users Group

Books

xlq2 has been recommended in the following:

Definitive Guide to Position Sizing

Van Tharp

Paul King