Theta Data

https://http-docs.thetadata.us/
Admin
Theta Data is a low latency market data platform, providing institutional grade financial data to...
Tokens:106,656
Snippets:738
Trust Score:6.5
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install Java on Ubuntu

Source: https://http-docs.thetadata.us/Articles/Getting-Started/Getting-Started.html

Install OpenJDK 21 using the apt package manager.

```shell
apt install openjdk-21-jdk openjdk-21-jre
```

--------------------------------

### Advanced Configuration Examples

Source: https://http-docs.thetadata.us/Articles/Performance-And-Tuning/Launch-Arguments.html

Examples demonstrating combined usage of configuration files with credentials, memory settings, or manual password entry.

```bash
java -jar ThetaTerminal.jar --creds-file=creds.txt --config=/path/to/config_1.properties
```

```bash
java -Xms4G -Xmx8G -jar ThetaTerminal.jar username password --config=/path/to/config_1.properties
```

```bash
java -jar ThetaTerminal.jar --config=/path/to/config_1.properties
```

--------------------------------

### Bulk Snapshot Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_snapshot-option-greeks_second_order.html

Example JSON responses for call and put option contracts containing tick data and contract details.

```json
{   "ticks": [     [       57599934,       221.9,       225.65,       0,       -0.0012,       0.0004,       1.2035,       0.4814,       0.725,       0,       71985879,       243.35,       20250103     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20260116,     "strike": 20000,     "right": "C"   } }
```

```json
{   "ticks": [     [       34204994,       0.02,       0.04,       0,       -0.0044,       0.0018,       3.6821,       1.7959,       0.8562,       0.015,       71985879,       243.35,       20250103     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20260116,     "strike": 20000,     "right": "P"   } }
```

--------------------------------

### Response Schema Example

Source: https://http-docs.thetadata.us/operations/get-bulk_snapshot-option-open_interest.html

Example JSON response structure for the open interest endpoint.

```json
{   "ticks": [     [       23400000,       0,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 50000,     "right": "C"   } }
```

```json
{   "ticks": [     [       23404000,       4910,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 50000,     "right": "P"   } }
```

--------------------------------

### Bulk Quote Snapshot Response Examples

Source: https://http-docs.thetadata.us/operations/get-v2-bulk_snapshot-stock-quote.html

JSON response examples showing the structure of tick data and contract details.

```json
{   "ticks": [     [       70840632,       100,       29,       469,       0,       100,       29,       571.5,       0,       20250129     ]   ],   "contract": {     "root": "CVCO"   } }
```

```json
{   "ticks": [     [       72000032,       100,       29,       22.98,       0,       100,       29,       38.98,       0,       20250129     ]   ],   "contract": {     "root": "KLXY"   } }
```

--------------------------------

### Latency Output Example

Source: https://http-docs.thetadata.us/Streaming/US-Options/Python-Example.html

Sample output showing latency values in milliseconds.

```text
latency: 3
latency: 47
latency: 25
latency: 16
latency: 4
latency: 20
latency: 18
latency: 17
latency: 37
latency: 21
latency: 5
latency: 48
latency: 26
latency: 38
latency: 47
latency: 1
```

--------------------------------

### Bulk Option Trade Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_at_time-option-trade.html

Example JSON responses containing tick data and contract details for call and put options.

```json
{   "ticks": [     [       36476240,       325086878,       255,       255,       255,       255,       18,       1,       69,       294.62,       0,       3,       0,       0,       20240116     ]   ],   "contract": {     "root": "SPY",     "expiration": 20240119,     "strike": 180000,     "right": "C"   } }
```

```json
{   "ticks": [     [       34394294,       235308063,       255,       255,       255,       255,       130,       1,       43,       0.01,       0,       7,       0,       0,       20240116     ]   ],   "contract": {     "root": "SPY",     "expiration": 20240119,     "strike": 180000,     "right": "P"   } }
```

--------------------------------

### Initial Request URL

Source: https://http-docs.thetadata.us/Articles/Performance-And-Tuning/Pagination.html

Example URL for requesting historical option quotes.

```text
http://127.0.0.1:25510/v2/hist/option/quote?root=QQQ&start_date=20231004&end_date=20231004&strike=356000&exp=20231004&right=C
```

--------------------------------

### Bulk Snapshot Option All Greeks Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_snapshot-option-all_greeks.html

Example JSON responses for call and put option contracts containing tick data and contract details.

```json
{   "ticks": [     [       50709357,       316.2,       319.5,       0.889,       -1.6478,       254.9316,       250.3638,       -266.0386,       16.9724,       0.0007,       -1.1576,       2.1708,       1905.5221,       8.0136,       0,       0,       -1.1273,       -100,       0.1926,       0,       50709000,       6067.86,       20250210     ]   ],   "contract": {     "root": "SPXW",     "expiration": 20250228,     "strike": 5770000,     "right": "C"   } }
```

```json
{   "ticks": [     [       50709677,       10.5,       10.7,       -0.0932,       -1.0769,       224.7201,       -28.4387,       27.916,       -53.401,       0.0006,       -1.2025,       2.0802,       2140.1218,       7.3513,       0,       0,       -0.9044,       -100,       0.1776,       0,       50709000,       6067.86,       20250210     ]   ],   "contract": {     "root": "SPXW",     "expiration": 20250228,     "strike": 5770000,     "right": "P"   } }
```

--------------------------------

### Bulk Option Quote Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_at_time-option-quote.html

Example JSON responses showing the structure of tick data and contract details for call and put options.

```json
{   "ticks": [     [       44100000,       75,       5,       294.61,       50,       75,       5,       295.01,       50,       20240116     ]   ],   "contract": {     "root": "SPY",     "expiration": 20240119,     "strike": 180000,     "right": "C"   } }
```

```json
{   "ticks": [     [       44100000,       0,       7,       0,       50,       12287,       42,       0.01,       50,       20240116     ]   ],   "contract": {     "root": "SPY",     "expiration": 20240119,     "strike": 180000,     "right": "P"   } }
```

--------------------------------

### Bulk Snapshot Option Greeks Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_snapshot-option-greeks.html

Example JSON responses for call and put option contracts containing tick data and contract metadata.

```json
{   "ticks": [     [       57599934,       221.9,       225.65,       0.9999,       -0.0011,       0.0754,       20.2037,       -251.3314,       1.0874,       0.725,       0,       71985879,       243.35,       20250103     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20260116,     "strike": 20000,     "right": "C"   } }
```

```json
{   "ticks": [     [       34204994,       0.02,       0.04,       -0.0004,       -0.0004,       0.3847,       -0.1402,       0.1088,       -3.4606,       0.8562,       0.015,       71985879,       243.35,       20250103     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20260116,     "strike": 20000,     "right": "P"   } }
```

--------------------------------

### GET /v2/file/option/open_interest

Source: https://http-docs.thetadata.us/operations/get-v2-flat-file-getting-started.html

Retrieves a flat file for option open interest.

```APIDOC
## GET /v2/file/option/open_interest

### Description
Retrieves a flat file containing option open interest data for a specified date.

### Method
GET

### Endpoint
http://127.0.0.1:25510/v2/file/option/open_interest

### Parameters
#### Query Parameters
- **start_date** (string) - Required - The date for the requested data in YYYYMMDD format.
```

--------------------------------

### Sample Stream Output

Source: https://http-docs.thetadata.us/Streaming/US-Options/Full-Trade-Stream.html

Example of the JSON structure returned by the trade stream.

```json
{
  "header": {
    "status": "CONNECTED",
    "type": "TRADE"
  },
  "contract": {
    "security_type": "OPTION",
    "root": "QQQ",
    "expiration": 20231110,
    "strike": 360000,
    "right": "P"
  },
  "trade": {
    "ms_of_day": 49531278,
    "sequence": -563040482,
    "size": 5,
    "condition": 18,
    "price": 1.06,
    "exchange": 65,
    "date": 20231103
  }
}
```

--------------------------------

### GET /v2/hist/stock/eod

Source: https://http-docs.thetadata.us/operations/get-v2-hist-stock-eod.html

Retrieves the national EOD report for a specific security symbol between a start and end date.

```APIDOC
## GET /v2/hist/stock/eod

### Description
Retrieves a national EOD report for a specified stock symbol. The report is generated daily at 17:15 ET.

### Method
GET

### Endpoint
http://127.0.0.1:25510/v2/hist/stock/eod

### Parameters
#### Query Parameters
- **root** (string) - Required - The symbol of the security.
- **start_date** (integer) - Required - The start date (inclusive) of the request formatted as YYYYMMDD.
- **end_date** (integer) - Required - The end date (inclusive) of the request formatted as YYYYMMDD.
- **use_csv** (boolean) - Optional - Output is in comma-separated values if true, legacy JSON if false. Default: false.
- **pretty_time** (boolean) - Optional - If true, formats time and date as 09:30:00.000 and 2020-01-01. If false, returns milliseconds since midnight EST. Default: false.
```

--------------------------------

### Launch with Configuration File

Source: https://http-docs.thetadata.us/Articles/Performance-And-Tuning/Launch-Arguments.html

Specify a custom configuration file path using the --config argument.

```bash
java -jar ThetaTerminal.jar --config=/path/to/config_0.properties
```

--------------------------------

### GET /v2/hist/stock/dividend

Source: https://http-docs.thetadata.us/operations/get-v2-hist-stock-dividend.html

Retrieves historical dividend data for a specified stock symbol between a start and end date.

```APIDOC
## GET /v2/hist/stock/dividend

### Description
Retrieves historical stock dividend messages for a given security. Data is typically reported on the ex-dividend date.

### Method
GET

### Endpoint
http://127.0.0.1:25510/v2/hist/stock/dividend

### Parameters
#### Query Parameters
- **root** (string) - Required - The symbol of the security.
- **start_date** (integer) - Required - The start date (inclusive) of the request formatted as YYYYMMDD.
- **end_date** (integer) - Required - The end date (inclusive) of the request formatted as YYYYMMDD.
- **use_csv** (boolean) - Optional - Output is in comma-separated values if true, legacy JSON if false. Default: false.
- **pretty_time** (boolean) - Optional - If true, ms_of_day and date will take formatted strings (e.g., 09:30:00.000 and 2020-01-01). Default: false.

### Response
#### Success Response (200)
- **header** (object) - Metadata about the response.
- **id** (integer) - The request ID.
- **latency_ms** (integer) - Time in milliseconds for the server to respond.
- **error_type** (string) - Error type if an error occurred, otherwise null.
- **error_msg** (string) - Additional error information.
- **format** (array) - The order of fields in each inner array of the response.
- **response** (array) - A list of contracts, where each item is an array of values matching the header format.
```

--------------------------------

### GET /v2/hist/stock/split

Source: https://http-docs.thetadata.us/operations/get-v2-hist-stock-split.html

Retrieves historical stock split data for a given security symbol between a start and end date.

```APIDOC
## GET /v2/hist/stock/split

### Description
Retrieves historical stock split data for a security. A stock split represents a change in the total amount of shares of a company, and this endpoint returns the date of the split along with the shares prior to and after the split.

### Method
GET

### Endpoint
http://127.0.0.1:25510/v2/hist/stock/split

### Parameters
#### Query Parameters
- **root** (string) - Required - The symbol of the security.
- **start_date** (integer) - Required - The start date (inclusive) of the request formatted as YYYYMMDD.
- **end_date** (integer) - Required - The end date (inclusive) of the request formatted as YYYYMMDD.
- **use_csv** (boolean) - Optional - Output is in comma-separated values if true, legacy JSON if false. Default: false.
- **pretty_time** (boolean) - Optional - If true, ms_of_day and date will take the format of 09:30:00.000 and 2020-01-01. Default: false.

### Response
#### Success Response (200)
- **header** (object) - The response header containing metadata.
- **id** (integer) - The request id.
- **latency_ms** (integer) - The time in milliseconds it took for the server to respond.
- **error_type** (string) - The error type, null if no error occurred.
- **error_msg** (string) - Additional information about the error if available.
- **format** (array) - The order of fields in each inner array of the response.
- **response** (array) - A list of contracts, where each item is an array of values matching the header.format.
```

--------------------------------

### Launch with Credentials File

Source: https://http-docs.thetadata.us/Articles/Performance-And-Tuning/Launch-Arguments.html

Use the --creds-file argument to point to a local file containing credentials, avoiding exposure in task managers.

```bash
java -jar ThetaTerminal.jar --creds-file=creds.txt
```

--------------------------------

### Stream Trades with Go

Source: https://http-docs.thetadata.us/Streaming/US-Options/Full-Trade-Stream.html

Example implementation using the gorilla/websocket library to manage the connection and stream lifecycle.

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/url"
	"os"
	"os/signal"
	"syscall"

	"github.com/gorilla/websocket"
)

type InitialMessage struct {
	MsgType string `json:"msg_type"`
	SecType string `json:"sec_type"`
	ReqType string `json:"req_type"`
	Add     bool   `json:"add"`
	ID      int    `json:"id"`
}

func main() {
	interrupt := make(chan os.Signal, 1)
	signal.Notify(interrupt, os.Interrupt, syscall.SIGTERM)

	u := url.URL{Scheme: "ws", Host: "127.0.0.1:25520", Path: "/v1/events"}
	log.Printf("connecting to %s", u.String())

	c, _, err := websocket.DefaultDialer.Dial(u.String(), nil)
	if err != nil {
		log.Fatal("dial:", err)
	}
	defer c.Close()

	done := make(chan struct{})

	go func() {
		defer close(done)
		for {
			_, message, err := c.ReadMessage()
			if err != nil {
				log.Println("read:", err)
				return
			}
			fmt.Printf("%s\n", message)
		}
	}()

	initialMessage := InitialMessage{
		MsgType: "STREAM_BULK",
		SecType: "OPTION",
		ReqType: "TRADE",
		Add:     true,
		ID:      0,
	}
	msg, err := json.Marshal(initialMessage)
	if err != nil {
		log.Println("error in marshalling:", err)
		return
	}

	err = c.WriteMessage(websocket.TextMessage, msg)
	if err != nil {
		log.Println("write:", err)
		return
	}

	for {
		select {
		case <-done:
			return
		case <-interrupt:
			log.Println("interrupt")
			err := c.WriteMessage(websocket.CloseMessage, websocket.FormatCloseMessage(websocket.CloseNormalClosure, ""))
			if err != nil {
				log.Println("write close:", err)
				return
			}
			<-done
			return
		}
	}
}
```

--------------------------------

### Deploy live algorithm with ThetaData

Source: https://http-docs.thetadata.us/Articles/Getting-Started/QuantConnect.html

Deploy a live algorithm using ThetaData as the live data provider. Requires specifying a brokerage and relevant brokerage options.

```shell
lean live deploy [projectName] --data-provider-live ThetaData --thetadata-subscription-plan [plan] --brokerage [brokerageName] [requiredBrokerageOptions]
```

```shell
$ lean live deploy "My Project" --data-provider-live ThetaData --thetadata-subscription-plan Standard --brokerage "Paper Trading"
```

```shell
lean live deploy [projectName] --brokerage [brokerageName]
```

--------------------------------

### Option Right Enum Example

Source: https://http-docs.thetadata.us/operations/get-bulk_at_time-option-trade.html

Example value for the contract right field indicating a call option.

```json
C
```

--------------------------------

### Launch with Custom Log Directory

Source: https://http-docs.thetadata.us/Articles/Performance-And-Tuning/Launch-Arguments.html

Define the directory where application logs are stored using the --log-directory argument.

```bash
java -jar ThetaTerminal.jar --log-directory=/path/to/log/directory
```

--------------------------------

### Historical Option Greeks Response Example

Source: https://http-docs.thetadata.us/operations/get-hist-option-greeks.html

Example of the array structure returned in the response field containing option quote data.

```json
[   34290000,   10.3,   10.4,   0.9135,   -0.1739,   2.9676,   1.6881,   -1.8015,   15.8829,   0.4086,   0,   34289992,   179.94,   20230911 ]
```

```json
[   34380000,   10.35,   10.5,   0.9231,   -0.1566,   2.7177,   1.7074,   -1.8216,   15.9525,   0.3945,   0,   34379988,   180.06,   20230911 ]
```

--------------------------------

### Fetch Options Data with Python

Source: https://http-docs.thetadata.us/Code-Examples/python.html

Demonstrates both non-streaming and streaming approaches to retrieve options data from the Theta Terminal. Requires the Theta Terminal to be running and the httpx library installed.

```python
import httpx  # install via pip install httpx
import csv

BASE_URL = "http://127.0.0.1:25510/v2"  # all endpoints use this URL base

# set params to fetch a snapshot of all contracts for Microsoft
params = {'root': 'MSFT', 'exp': '0', 'use_csv': 'true'}

#
# This is the non-streaming version, and the entire response
# will be held in memory.
#
url = BASE_URL + '/bulk_snapshot/option/ohlc'

while url is not None:
    response = httpx.get(url, params=params, timeout=60)  # make the request
    response.raise_for_status()  # make sure the request worked

    # read the entire response, and parse it as CSV
    csv_reader = csv.reader(response.text.split("\n"))

    for row in csv_reader:
        print(row)  # do something with the data

    # check the Next-Page header to see if we have more data
    if 'Next-Page' in response.headers and response.headers['Next-Page'] != "null":
        url = response.headers['Next-Page']
        params = None
    else:
        url = None


#
# This is the streaming version, and will read line-by-line
#
url = BASE_URL + '/bulk_snapshot/option/ohlc'

while url is not None:
    with httpx.stream("GET", url, params=params, timeout=60) as response:
        response.raise_for_status()  # make sure the request worked
        for line in response.iter_lines():
            print(line)  # do something with the data

    # check the Next-Page header to see if we have more data
    if 'Next-Page' in response.headers and response.headers['Next-Page'] != "null":
        url = response.headers['Next-Page']
        params = None
    else:
        url = None
```

--------------------------------

### Option Trade Greeks Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_hist-option-trade_greeks.html

Example JSON payloads representing the structure of historical option trade greeks data.

```json
{   "ticks": [     [       56167951,       299720858,       255,       255,       255,       255,       18,       1,       42,       86.15,       0,       7,       0,       0,       1,       0,       0,       0,       0,       0,       0,       0.0004,       56167951,       186.09,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 100000,     "right": "C"   } }
```

```json
{   "ticks": [     [       41064023,       -745524183,       255,       255,       255,       255,       125,       1,       43,       79.9,       0,       7,       0,       0,       0.9997,       -0.0172,       0.023,       2.0107,       -3.543,       2.3122,       1.2,       0,       41064019,       184.79,       20231110     ],     [       43614362,       -561477748,       255,       255,       255,       255,       125,       1,       9,       79.97,       0,       3,       0,       0,       1,       0,       0,       0,       0,       0,       0,       0.0004,       43614340,       184.9,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 105000,     "right": "C"   } }
```

--------------------------------

### Fetch Bulk Option Snapshots in Python

Source: https://http-docs.thetadata.us/operations/get-bulk_snapshot-option-all_greeks.html

Uses the httpx library to stream bulk option data and handle pagination via the Next-Page header.

```python
import httpx  # install via pip install httpx
import csv
import sys
import io
from datetime import datetime

BASE_URL = "http://127.0.0.1:25510/v2"  # all endpoints use this URL base

# set params
params = {
  'root': 'AAPL',
  'exp': '20250117',
  'use_csv': True,
}

# Weekend Check (Sat/Sun)
now = datetime.now()

if now.weekday() >= 5: # 5=Sat, 6=Sun
    print("Market is Closed snapshots may not work")
    sys.exit(0)

#
# This is the streaming version, and will read line-by-line
#
url = BASE_URL + '/bulk_snapshot/option/all_greeks'

while url is not None:
    with httpx.stream("GET", url, params=params, timeout=60) as response:
        response.raise_for_status()  # make sure the request worked
        for line in response.iter_lines():
            for row in csv.reader(io.StringIO(line)):
                print(row)  # Now you get a parsed list of fields

    # check the Next-Page header to see if we have more data
    if 'Next-Page' in response.headers and response.headers['Next-Page'] != "null":
        url = response.headers['Next-Page']
        params = None
    else:
        url = None
```

--------------------------------

### Bulk OHLC Snapshot Sample URL

Source: https://http-docs.thetadata.us/operations/get-v2-bulk_snapshot-stock-ohlc.html

A direct URL example for retrieving bulk OHLC snapshot data.

```text
http://127.0.0.1:25510/v2/bulk_snapshot/stock/ohlc?root=0
```

--------------------------------

### Historical Option Trade Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_hist-option-trade.html

Example JSON responses containing tick data and contract details for historical option trades.

```json
{   "ticks": [     [       56167951,       299720858,       255,       255,       255,       255,       18,       1,       42,       86.15,       0,       7,       0,       0,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 100000,     "right": "C"   } }
```

```json
{   "ticks": [     [       41064023,       -745524183,       255,       255,       255,       255,       125,       1,       43,       79.9,       0,       7,       0,       0,       20231110     ],     [       43614362,       -561477748,       255,       255,       255,       255,       125,       1,       9,       79.97,       0,       3,       0,       0,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 105000,     "right": "C"   } }
```

--------------------------------

### List Dates Request URLs

Source: https://http-docs.thetadata.us/operations/get-v2-list-dates.html

Example URLs for querying available dates for different security types and option configurations.

```text
http://127.0.0.1:25510/v2/list/dates/stock/quote?root=AAPL
```

```text
http://127.0.0.1:25510/v2/list/dates/index/trade?root=SPX
```

```text
http://127.0.0.1:25510/v2/list/dates/option/quote?root=AAPL&exp=20220930
```

```text
http://127.0.0.1:25510/v2/list/dates/option/quote?root=AAPL&exp=20220930&strike=140000&right=C
```

--------------------------------

### Contract Message Example

Source: https://http-docs.thetadata.us/Streaming/Getting-Started.html

Example of a QUOTE or TRADE message containing a contract object, where option strike prices are represented in 1/10th of a cent.

```json
{
    "header": {
        "status": "CONNECTED",
        "type": "QUOTE"
    },
    "contract": {
        "security_type": "OPTION",
        "root": "TTWO",
        "expiration": 20231103,
        "strike": 140000,
        "right": "C"
    },
...
```

--------------------------------

### Historical Option EOD Greeks Response Examples

Source: https://http-docs.thetadata.us/operations/get-hist-option-eod_greeks.html

Example JSON responses showing tick data and contract details for call and put options.

```json
{   "ticks": [     [       43614362,       79.9,       79.97,       79.9,       79.97,       2,       2,       50,       7,       80.85,       50,       50,       60,       82,       50,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0,       0.0192,       43614362,       186.4,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 105000,     "right": "C"   } }
```

```json
{   "ticks": [     [       56967501,       0.01,       0.01,       0.01,       0.01,       73,       8,       100,       7,       0.01,       50,       98,       7,       0.02,       50,       -0.0014,       -0.0075,       0.1215,       -0.0053,       0.0051,       -28.0651,       0.0002,       -0.0153,       0.3489,       1.1833,       0.008,       0,       0,       0,       -0.0008,       7.4596,       2.9796,       2.8584,       0.875,       -0.0417,       56967501,       186.4,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 131000,     "right": "P"   } }
```

--------------------------------

### Check Java Version

Source: https://http-docs.thetadata.us/Articles/Getting-Started/Getting-Started.html

Verify the installed Java version in the command prompt or terminal.

```shell
java -version
```

--------------------------------

### Historical Option Trade and Quote Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_hist-option-trade_quote.html

Examples of the JSON response structure containing tick data and contract information for option trades.

```json
{   "ticks": [     [       56167951,       299720858,       255,       255,       255,       255,       18,       1,       42,       86.15,       0,       7,       0,       0,       56167951,       12,       47,       86,       50,       1,       47,       86.2,       50,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 100000,     "right": "C"   } }
```

```json
{   "ticks": [     [       41064023,       -745524183,       255,       255,       255,       255,       125,       1,       43,       79.9,       0,       7,       0,       0,       41051889,       14,       47,       79.75,       50,       3,       31,       80,       50,       20231110     ],     [       43614362,       -561477748,       255,       255,       255,       255,       125,       1,       9,       79.97,       0,       3,       0,       0,       43614362,       13,       7,       79.85,       50,       13,       7,       80.1,       50,       20231110     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231117,     "strike": 105000,     "right": "C"   } }
```

--------------------------------

### Bulk Quote Snapshot Sample URL

Source: https://http-docs.thetadata.us/operations/get-v2-bulk_snapshot-stock-quote.html

A direct URL example to test the endpoint in a browser while the Theta Terminal is active.

```text
http://127.0.0.1:25510/v2/bulk_snapshot/stock/quote?root=0
```

--------------------------------

### Stream Trades with Python

Source: https://http-docs.thetadata.us/Streaming/US-Options/Full-Trade-Stream.html

Example implementation using the websockets library to connect and receive trade data.

```python
import asyncio
import websockets

# This code has only been tested on Python 3.11. Other versions might require adjustments.
async def stream_trades():
    async with websockets.connect('ws://127.0.0.1:25520/v1/events') as websocket:
        req = {}
        req['msg_type'] = 'STREAM_BULK'
        req['sec_type'] = 'OPTION'
        req['req_type'] = 'TRADE'
        req['add'] = True
        req['id'] = 0
        await websocket.send(req.__str__())
        while True:
            response = await websocket.recv()
            print(response)


asyncio.get_event_loop().run_until_complete(stream_trades())
```

--------------------------------

### Bulk Historical Option OHLC Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_hist-option-ohlc.html

Example JSON responses containing tick data and contract details for call and put options.

```json
{   "ticks": [     [       34200000,       14.3,       14.8,       13.5,       14.3,       50,       18,       20231103     ],     [       35100000,       15.5,       15.61,       15.38,       15.51,       26,       10,       20231103     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231103,     "strike": 160000,     "right": "C"   } }
```

```json
{   "ticks": [     [       34200000,       0.01,       0.15,       0.01,       0.01,       718,       113,       20231103     ],     [       35100000,       0.01,       0.01,       0.01,       0.01,       232,       30,       20231103     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20231103,     "strike": 160000,     "right": "P"   } }
```

--------------------------------

### Launch Research Environment with ThetaData

Source: https://http-docs.thetadata.us/Articles/Getting-Started/QuantConnect.html

Open the local Research Environment configured to use ThetaData as the historical data provider.

```shell
lean research [projectName] --data-provider-historical ThetaData --thetadata-subscription-plan [plan]
```

```shell
$ lean research "My Project" --data-provider-historical ThetaData --thetadata-subscription-plan Standard
```

--------------------------------

### Bulk Historical Option EOD Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_hist-option-eod.html

Example JSON responses representing historical option EOD data for call and put contracts.

```json
{   "ticks": [     [       62573163,       55073367,       126.35,       127.6,       126.2,       127.6,       14,       10,       6,       47,       126.6,       50,       1,       7,       129.65,       50,       20231102     ],     [       63174002,       55073367,       126.35,       127.6,       126.2,       127.6,       14,       10,       6,       47,       126.6,       50,       1,       7,       129.65,       50,       20231102     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20240119,     "strike": 50000,     "right": "C"   } }
```

```json
{   "ticks": [     [       62573163,       0,       0,       0,       0,       0,       0,       0,       0,       22,       0,       50,       1,       7,       0.01,       50,       20231102     ],     [       63174002,       0,       0,       0,       0,       0,       0,       0,       0,       22,       0,       50,       1,       7,       0.01,       50,       20231102     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20240119,     "strike": 50000,     "right": "P"   } }
```

--------------------------------

### Configure Memory Allocation

Source: https://http-docs.thetadata.us/Articles/Performance-And-Tuning/Launch-Arguments.html

Set initial and maximum heap memory using standard JVM flags -Xms and -Xmx.

```bash
java -Xms4G -Xmx8G -jar ThetaTerminal.jar username password
```

--------------------------------

### Streaming List Dates with Python

Source: https://http-docs.thetadata.us/operations/get-v2-list-dates.html

Demonstrates how to stream data from the endpoint using httpx and parse CSV output line-by-line.

```python
import httpx  # install via pip install httpx
import csv
import io

BASE_URL = "http://127.0.0.1:25510/v2"  # all endpoints use this URL base

# set params
params = {
  'root': 'AAPL',
  'use_csv': True,
}

#
# This is the streaming version, and will read line-by-line
#
url = BASE_URL + '/list/dates/stock/trade'

while url is not None:
    with httpx.stream("GET", url, params=params, timeout=60) as response:
        response.raise_for_status()  # make sure the request worked
        for line in response.iter_lines():
            for row in csv.reader(io.StringIO(line)):
                print(row)  # Now you get a parsed list of fields

    # check the Next-Page header to see if we have more data
    if 'Next-Page' in response.headers and response.headers['Next-Page'] != "null":
        url = response.headers['Next-Page']
        params = None
    else:
        url = None
```

--------------------------------

### Bulk OHLC Snapshot Python Example

Source: https://http-docs.thetadata.us/operations/get-v2-bulk_snapshot-stock-ohlc.html

Python implementation using httpx to stream bulk OHLC snapshot data, including a weekend check and pagination handling.

```python
import httpx  # install via pip install httpx
import csv
import sys
import io
from datetime import datetime

BASE_URL = "http://127.0.0.1:25510/v2"  # all endpoints use this URL base

# set params
params = {
  'root': 'AAPL',
  'use_csv': True,
}

# Weekend Check (Sat/Sun)
now = datetime.now()

if now.weekday() >= 5: # 5=Sat, 6=Sun
    print("Market is Closed snapshots may not work")
    sys.exit(0)

#
# This is the streaming version, and will read line-by-line
#
url = BASE_URL + '/bulk_snapshot/stock/ohlc'

while url is not None:
    with httpx.stream("GET", url, params=params, timeout=60) as response:
        response.raise_for_status()  # make sure the request worked
        for line in response.iter_lines():
            for row in csv.reader(io.StringIO(line)):
                print(row)  # Now you get a parsed list of fields

    # check the Next-Page header to see if we have more data
    if 'Next-Page' in response.headers and response.headers['Next-Page'] != "null":
        url = response.headers['Next-Page']
        params = None
    else:
        url = None
```

--------------------------------

### Bulk Historical Option Greeks Response Examples

Source: https://http-docs.thetadata.us/operations/get-bulk_hist-option-greeks.html

Example JSON response objects containing tick data and contract information for historical option greeks.

```json
{   "ticks": [     [       34290000,       114.95,       115.05,       0.9988,       -0.0393,       0.0708,       0.7094,       -1.9697,       1.5629,       3.3828,       0,       34289992,       179.94,       20230911     ],     [       34380000,       115.05,       115.2,       0.9988,       -0.0392,       0.0705,       0.7094,       -1.971,       1.5623,       3.3828,       0,       34379988,       180.06,       20230911     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20230915,     "strike": 65000,     "right": "C"   } }
```

```json
{   "ticks": [     [       34290000,       109.95,       110.05,       0.9989,       -0.0361,       0.0671,       0.7643,       -1.9698,       1.634,       3.1015,       0,       34289992,       179.94,       20230911     ],     [       34380000,       110.05,       110.15,       1,       0,       0,       0,       0,       0,       0,       0,       34379988,       180.06,       20230911     ]   ],   "contract": {     "root": "AAPL",     "expiration": 20230915,     "strike": 70000,     "right": "C"   } }
```
Tokens:
Raw