latestOpenAPI 3.1.02026-08-145096557.0 KB

1c983de099e2

us-equity-opt-ref-market-structure-compliance

OCC Listed Options Daily

The OCC Listed Options Daily dataset is derived from the official Options Clearing Corporation (OCC) Directory of Listed Products and provides comprehensive daily coverage of all equity, index, and currency options listed on U.S. public exchanges. The dataset includes core reference attributes such as the OCC-designated option symbol, underlying symbol, option name, underlying security type, and applicable position limits. It serves as an authoritative daily snapshot of the U.S. listed options universe, enabling users to accurately track option availability, reference identifiers, and listing characteristics over time. Data is available on a daily basis starting July 2023, and is designed to support historical research, universe construction, compliance monitoring, and institutional-grade options reference workflows.

For more details, please refer to the dataset documentation: OCC Listed Options Daily Guide.

<details> <summary>**Advanced Filtering**</summary>

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 <a href="https://algoseek.com/docs/rest-api/tutorial/advanced-filtering">Advanced Filtering Guide</a> for the extensive reference.

</details>
get/v1/data/us-equity-opt-ref/occ-list-opt-daily

Query parameters

periodstring nullable

A string representing the time period for which to retrieve data. The format and accepted values depend on the dataset. If not provided, data for all available periods will be returned.

A string representing the time period for which to retrieve data. The format and accepted values depend on the dataset. If not provided, data for all available periods will be returned.

sortstring nullable

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.

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.

columnsstring nullable

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.

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.

offsetinteger

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

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

limitinteger

Maximum number of records to return. Default and maximum values depend on the response format; see format_limits in the schema for details.

Maximum number of records to return. Default and maximum values depend on the response format; see format_limits in the schema for details.

response_format'json' | 'csv' | 'csv_gzip'

Note the lowercase which is used for the consistency with other projects and tools

The type of the data to return

Response

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

Example response

{
  "data": [
    {
      "TradeDate": "2023-07-12",
      "OptionTicker": "A",
      "UnderTicker": "A",
      "UnderType": "S",
      "Name": "AGILENT TECHNOLOGIES, INC.",
      "Exchange": "AM;BO;CB;ME;EX;IG;IS;IM;MI;AR;NA;MP;NB;C2;NP;BA",
      "PositionLimit": 25000000
    }
  ],
  "pagination": {
    "limit": 1000,
    "next_offset": 2000,
    "offset": 1000
  }
}