This is the v2 documentation and is no longer maintained. Please use the v3 documentation.
Skip to content

The Config File ​

Where is the Config File? ​

The directory to the config file is printed when you launch the terminal. It is the text after Config dir. Paste that directory into your file explorer and look for a file called config_0.properties.

launch.png

Documented values ​

Below is a copy of the most recent default config file. Notice that each field is thoroughly documented.

bash
# Copyright © 2021-2024, Bailey Danseglio, AxiomX LLC, Theta Data, their subsidiaries & affiliates. All rights reserved.

# Theta Terminal v1.3.6 Configuration. Altering these values might cause instability.
# Delete your config file and restart the terminal to reset all fields to their default value.
# All time values are in milliseconds.
# A local server is hosted on your machine.

#------------------------------------------------ Connectivity ------------------------------------------------
# The MDDS region to connect to. The IP and port series is cycled through while trying to connect to a server (left to right).
MDDS_REGION=MDDS_NJ_HOSTS

# The FPSS region to connect to. The IP and port series is cycled through while trying to connect to a server (left to right).
FPSS_REGION=FPSS_NJ_HOSTS

#------------------------------------------------ Networking ------------------------------------------------
# Http (REST API) server port.
HTTP_PORT=25510

# WebSocket server port.
WS_PORT=25520

# The Python API query-based (MDDS) socket port.
CLIENT_PORT=11000

# The Python API streaming (FPSS) port.
STREAM_PORT=10000

# How frequently should this client ping MDDS.
PING=1000

# How long should the MDDS or FPSS client wait to reconnect after the connection is lost.
RECONNECT_WAIT=5000

# How long should the client live without receiving any messages from the server.
MDDS_TIMEOUT=10000
FPSS_TIMEOUT=10000

#------------------------------------------------ MDDS HOSTS ------------------------------------------------
# Production servers located in our New Jersey Campus.
MDDS_NJ_HOSTS=nj-a.thetadata.us:12000,nj-a.thetadata.us:12001,nj-b.thetadata.us:12000,nj-b.thetadata.us:12001

# TESTING AND DEVELOPMENT ONLY! Occasional reboots. Potential issues with data and certain requests. This server is not stable.
MDDS_STAGE_HOSTS=nj-a.thetadata.us:12100,test-server.thetadata.us:12100,test-server.thetadata.us:12101

# TESTING AND DEVELOPMENT ONLY! Frequent reboots. Potential issues with data and certain requests. This server is not stable.
MDDS_DEV_HOSTS=nj-a.thetadata.us:12200,test-server.thetadata.us:12200,test-server.thetadata.us:12201

#------------------------------------------------ FPSS HOSTS ------------------------------------------------
# Production servers located in our New Jersey Campus.
FPSS_NJ_HOSTS=nj-a.thetadata.us:20000,nj-a.thetadata.us:20001,nj-b.thetadata.us:20000,nj-b.thetadata.us:20001

# TESTING ONLY! Occasional reboots. Potential issues with data and certain requests. This server is not stable.
FPSS_STAGE_HOSTS = nj-a.thetadata.us:20100,test-server.thetadata.us:20100,test-server.thetadata.us:20101

#------------------------------------------------    Misc    ------------------------------------------------
# The amount of memory buffers allocated for processing http requests. Set this equal to the # of threads you're using.
HTTP_CONCURRENCY=2

# Splits web socket messages over different lines. This helps with load balancing.
WS_LINES=1

# The maximum amount of ticks that can be returned in a single http response. The "Next-Page" will contain the local url
# to the next page of data. Making this value too high will degrade performance and cause instability. V2 requests only
HTTP_TICK_LIM=100000

# The maximum amount of time allotted to request the next page. If this limit is reached, the page is eligible to be
# discarded and no longer accessible.
HTTP_PAGE_EXPIRE=10000

# If using a web browser to make http requests, you must change this to the domain name of the website making requests.
# Specify '*' to allow everything. It is a security risk if the Theta Terminal http port is exposed to the internet.
HTTP_ACCESS_ORIGIN = https://http-docs.thetadata.us