List Roots

FreeValueStandardPro

GET

http://127.0.0.1:25510/v2/list/roots/{sec}

REQUIRED

The Theta Terminal must be running to access data.

Behavior

A root can be defined as a unique identified for a stock / underlying asset.
Common terms also include: symbol, ticker, and underlying.
This endpoint returns all traded roots for a given security type (i.e. stock, index, or option).
This endpoint is updated overnight.
Sample data contains partial output of the request as the full response to the request is too large to display on this webpage.

Sample URL

Paste the URL below into your browser while the Theta Terminal is running.

List all roots for options

http://127.0.0.1:25510/v2/list/roots/option

List all roots for stocks

http://127.0.0.1:25510/v2/list/roots/stock

List all roots for indices

http://127.0.0.1:25510/v2/list/roots/index

Parameters

Path Parameters

secRequired  -

The security type

Type: string (Default: option)

Enumoption, stock, index

Query Parameters

use_csvRequired  -

Uses CSV if true, legacy JSON if false.

Type: boolean (Default: false)

Responses

OK

Content-Type

Use example

{

"header": {

"id": 0,

"latency_ms": 0,

"error_type": "string",

"error_msg": "string",

"format": [

"root"

]

},

"response": [

"AAPL"

]

}

Sample Code

Python