---
title: "OCC Equities Special Settlements"
method: GET
path: "/v1/data/us-equity-opt-ref/occ-eq-spec-settl"
tags: ["us-equity-opt-ref-market-structure-compliance"]
---

# OCC Equities Special Settlements

`GET /v1/data/us-equity-opt-ref/occ-eq-spec-settl`

The OCC Equities Special Settlements dataset is derived from official Options Clearing Corporation records and provides authoritative coverage of non-standard (adjusted) U.S. equity option contracts resulting from corporate actions such as mergers, splits, spin-offs, or special dividends.The dataset includes key identifiers such as the adjusted option symbol and underlying equity symbol, along with detailed settlement mechanics describing how exercise and assignment obligations were resolved. This includes information on delivery components, enabling users to accurately interpret post-adjustment contract terms and cash-and-carry outcomes. Data is available on a daily basis starting November 1, 2017, and is designed to support historical research, back-testing, compliance validation, and institutional-grade options analytics involving complex or non-standard contracts.

 For more details, please refer to the dataset documentation: [OCC Equities Special Settlements Guide](https://us-options-reference-docs.s3.us-east-1.amazonaws.com/algoseek.OCC.Equity.Special.Settlements.pdf).

<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>

## Query parameters

- `sort` string, 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.
- `columns` string, 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.
- `offset` integer — Number of records to skip before returning results. To be used with the `limit` parameter for pagination. If not provided, defaults to 0.
- `limit` integer — 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

## Response `200`

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

- OCCEquitiesSpecialSettlementsDataOut
  - `data` OCCEquitiesSpecialSettlementsDataDetailsOut[], required
    - `ProcessDate` string, date, nullable — The date on which the record was created by OCC
    - `SettlementDate` string, date, nullable — The date on which delivery of and payment for product is due to
    - `OptionTicker` string, nullable — Symbol name
    - `UnderTicker` string, nullable — Underlying symbol name
    - `UnderType` string, nullable — Type of underlying security
    - `StrikeCurrency` string, nullable — The currency of the strike price
    - `TotalDelivComponents` integer, nullable — The total number of components of delivery associated with the settlement of the traded option symbol
    - `DeliveryComponents` integer, nullable — The number of a specific component of delivery that is represented by the record
    - `SettlementMethod` string, nullable — The manner in which exercise and assignment activity will be settled
    - `StrikePercent` integer, nullable — Percentage of the strike price allocated for settlement
    - `DeliverableUnits` integer, nullable — The per-contract number of deliverable units of cash, stocks, bonds, or currencies to be delivered or received upon settlement
    - `CashAmount` number, nullable — Per-contract cash amount to be allocated upon settlement
  - `pagination` PaginationDetailsOut, required
    - `offset` integer — The number of records skipped to fetch the current page
    - `limit` integer, required — The maximum number of records in the current page
    - `next_offset` integer, nullable — The number of records to skip to fetch the next page

## Other responses

- `403` — Forbidden
- `422` — Validation Error
- `429` — Request rejected because the identity or team exceeded a configured monthly or per-minute usage quota. When available, the response includes rate-limit headers describing the current quota.

---

[API](https://skmtc.net/algoseek/apis/datasets-api.md) · [All operations](https://skmtc.net/algoseek/apis/datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/algoseek/datasets-api/revisions/1c983de099e2/schema)