Users

Users

Creating and managing application keys

Using the App Keys tab, you can create and manage application keys for logging in to TT with your own custom TT Core SDK and TT REST API trading applications. When you create an application key, Setup will generate a key value that you can copy and paste into the login calls of your application.

When you log in to TT via a trading application, TT authenticates your application key and allows you to retrieve a token for accessing the services on the TT platform. After logging in with your trading application, you will use the same order permissions, risk settings, and account restrictions, etc., that have been assigned to you in Setup.

The same order permissions and account restrictions assigned to you as a user in Setup also apply to you when you log in and trade via your key-based trading application.

Whether you log in via a browser or key-based trading application, your same user order permissions and account restrictions apply in both cases.

App key types

You can create the following types of application keys:

  • TT Core SDK: Allows you to run custom applications created using the TT Core SDK.
  • TT REST API: Allows you to run TT REST API applications based on a selected usage plan which can incur additional costs.

    Select one of the following:
    • Free: Allows you to develop and test TT REST applications in UAT only.
    • Low: Allows you to run TT REST applications in the Live environment with limit of 5 requests per second and 15,000 requests per day.
    • Medium: Allows you to run TT REST applications in the Live environment with limit of 10 requests per second and 30,000 requests per day.
    • High: Allows you to run TT REST applications in the Live environment with limit of 25 requests per second and 75,000 requests per day.

    Note: For more information about the cost associated with the usage plans, contact TT Customer Success.

Creating an application key

As a user or company administrator, you can create and manage your own application keys. In addition, as a company administrator, you can also create and manage application keys for provisional users in your company. However, if a provisional user accepts an invitation to join your company, Setup deletes the application keys and the user must then create their own application keys.

Note: You can only create an application key for your own username in Setup.

To create an application key:

  1. Click Users in the left navigation panel and select a user in the data grid.
  2. Click the App Keys tab.
  3. In the title bar of the App Keys data grid, click New.

  4. In the Create New Application Key screen, enter a user-defined name in the Application Key Name field.

    The key name must be unique.

  5. Select the desired Application Key Type type.
    • TT REST API (Visible only if Can create TT API REST Key is enabled in the user's profile.
    • TT Core SDK
  6. If you select TT REST API, select the desired usage plan in the Applicate Key Usage Plan drop-down.
  7. Click Create.

    The application key is generated and displayed in the Secret field.
  8. Click Copy Secret to Clipboard to save the value on your machine.

    Add the copied secret to the login call in your REST API trading application.
  9. To exit and close the Create New Application Key screen, click Ok.

Managing application keys

Using the App Keys tab, you can delete, rename, or deactivate an existing application key.

To manage application keys:

  1. Click Users in the left navigation panel and select a user in the data grid.

    Multiple users can be selected.
  2. Click the App Keys tab.
  3. Select an application key in the App Keys data grid.

    Multiple keys can be selected.
  4. To deactivate and delete the application key, click Delete.

    Note: Ensure that the deleted key is removed and replaced in your trading application.
  5. To rename the application key, click the Name and enter the new name.
  6. To deactivate an application key, click the Inactive checkbox. When the box is checked, the application key is inactive.

    Note: If needed, ensure that the deactivated key is replaced in your trading application.

    To re-activate an application key, uncheck the Inactive checkbox.
  7. Click Save Changes.

Note: When the TT Inactive setting is checked, it indicates that a TT Administrator has manually disabled the app key. To reactivate the app key, contact your company administrator.