AlgoSeek

US Options Security Master

The U.S. Options Security Master dataset provides a root-level reference catalog of all listed and delisted U.S. options disseminated via OPRA, covering options on equities, ETFs, ETNs, indexes, and currencies from 2012 to the present. Each record represents an option root security and includes summary attributes such as option type, settlement type, underlying symbol, and underlying security type. This dataset is designed to define the structural identity of an option root, rather than individu

GET 
https://api.devalgoseek.com/api/v1/data/us-equity-opt-ref/opt-sec-master#

The U.S. Options Security Master dataset provides a root-level reference catalog of all listed and delisted U.S. options disseminated via OPRA, covering options on equities, ETFs, ETNs, indexes, and currencies from 2012 to the present. Each record represents an option root security and includes summary attributes such as option type, settlement type, underlying symbol, and underlying security type. This dataset is designed to define the structural identity of an option root, rather than individual expirations or strikes. The security master is organized using algoseek’s persistent algoseek Security Identifier (ASID). The ASID remains stable throughout the lifecycle of an option root, even as individual contracts (strikes and expirations) are listed and expire. This enables consistent root-level mapping and simplifies integration across downstream options datasets. The dataset is delivered as a single, consolidated file and is updated daily. Companion lookup files are available to map ASID to option root symbols and underlying symbols, supporting efficient identifier resolution and cross-dataset joins.

For more details, please refer to the dataset documentation: US Options Security Master Guide.

Advanced Filtering

You can provide one or multiple filter expressions based on the dataset's columns to narrow down the results. For example, StartDate.gt=2023-01-01&StartDate.lt=2023-12-31, Ticker=AAPL.

Please refer to the Advanced Filtering Guide for the extensive reference.

Request#

Query Parameters#

    sort Sort

    Sorting criteria for the results. Provide a column name with optional prefix '+' for ascending order, or prefix with '-' for descending order. Multiple sorting fields may be supported depending on the dataset. If sort prefix is not provided, the ascending order is applied.

    columns Columns

    A comma-separated list of columns to include in the response. Use this parameter to select only specific fields from the dataset. If not provided, all available columns will be returned.

    offset Offset

    Possible values: >= 0

    Number of records to skip before returning results. To be used with the limit parameter for pagination. If not provided, defaults to 0.

    Default value: 0
    Example: 100
    limit Limit

    Possible values: >= 0 and <= 100000

    Maximum number of records to return. Used to control response size and pagination. If not provided, a default limit is applied by the server.

    Default value: 10000
    Example: 100
    response_format ResponseFormat

    Possible values: [json, csv, csv_gzip]

    The type of the data to return

    Default value: json
    Examples:

    JSON format (default)

    Example: json

Responses#

JSON, CSV file, or gzip-compressed CSV file, depending on the value of response_format query parameter

Schema
    data object[]required
  • Array [
    • ASIDinteger

    algoseek unique option security identifier

    Example: 1110000000001000
    OptionTickerstring

    Option root ticker

    Example: A
    UnderTickerstring

    Ticker name for the underlying security

    Example: A
    UnderTypestring

    Indicate underlying type: option on a stock, option on an index, etc

    Example: S
    OptionTypestring

    Indicate option type: vanilla options, binary options, etc

    Example: VA
    OptionStylestring

    Option style. A = American. E = European

    Example: A
    IsWeeklystring

    Indicate if the root option ticker covers only weekly options. Y = Yes, N = No

    Example: N
    MarketClosestring

    Market close time for this root symbol

    Example: 16:00
    SettlTypestring

    Settlement type of option

    Example: PM
    SettlTickerstring

    Ticker that provides price value for calculating the exercise-settlement amount

    Example:
    OptionTradeDatesstring[]

    Start and end dates for the option ASID. Enddate = 29991231 when the ticker is still being used

    Example: ["20120103:29991231"]
    OptionListStatusstring

    Current option root ticker list status. D = Delisted. L = Listed

    Example: L
    UnderSecIdinteger

    algoseek unique equity security identifier for the underlying security

    Example: 32952
    UnderTradeDatesstring[]

    Start and end dates for the underlying SecId. End date = 29991231 when the ticker is still being used

    Example: ["20070103:29991231"]
    GreeksCoveragestring

    Indicate if algoseek provides analytics for a specific option ticker. Y = Yes, N = No

    Example: Y
  • ]
    • pagination objectrequired
    offsetinteger

    The number of records skipped to fetch the current page

    Default value: 0
    limitintegerrequired

    The maximum number of records in the current page

    next_offsetinteger

    The number of records to skip to fetch the next page

Authorization: X-API-KEY#

name: X-API-KEYtype: apiKeyin: header
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.devalgoseek.com/api/v1/data/us-equity-opt-ref/opt-sec-master");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("X-API-KEY", "<X-API-KEY>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request
Base URL
https://api.devalgoseek.com
Auth
Parameters
— query
— query
— query
— query
— query
Column Filters
Accept
Response

Click the Send API Request button above and see the response here!

← Previous
US Equities Trade and Quote Minute Bar
Next →
Equity Options Daily