---
title: "Trading Schedule By Symbol"
method: GET
path: "/trsrv/secdef/schedule"
tags: ["tradingContracts"]
---

# Trading Schedule By Symbol

`GET /trsrv/secdef/schedule`

Returns the trading schedule up to a month for the requested contract.

## Query parameters

- `assetClass` 'STK' | 'OPT' | 'FUT' | 'CFD' | 'WAR' | 'SWP' | 'FND' | 'BND' | 'ICS', required — Specify the security type of the given contract. Valid asset classes are: * `STK` - Stock * `OPT` - Option * `FUT` - Future * `CFD` - Contract for Difference * `WAR` - Warrant * `SWP` - Forex * `FND` - Mutual Fund * `BND` - Bond * `ICS` - Inter-Commodity Spread
- `symbol` string, required
- `exchange` string
- `exchangeFilter` string

## Response `200`

Returns the trading schedule up to a month for the requested contract.

- TradingScheduleItems[] — trading's schedules
  - `id` string — Exchange parameter id
  - `tradeVenueId` string — Reference on a trade venue of given exchange parameter
  - `exchange` string — short exchange name
  - `description` string — exchange description
  - `timezone` string — References the time zone corresponding to the listed dates and times.
  - `schedules` TradingScheduleItemsSchedulesItems[] — Always contains at least one 'tradingTime' and zero or more 'sessionTime' tags
    - `clearingCycleEndTime` string — End time of clearing cycle.
    - `tradingScheduleDate` string — Date of the clearing schedule. 20000101 stands for any Sat, 20000102 stands for any Sun, … 20000107 stands for any Fri. Any other date stands for itself.
    - `sessions` TradingScheduleItemsSchedulesItemsSessionsItems[] — Lists the avialble trading sessions. This displays the regular trading hours. If the LIQUID hours differs from the total trading day then a separate 'session' tag is returned.
      - `openingTime` string — Opening date time of the session.
      - `closingTime` string — Closing date time of the sesion.
      - `prop` string — If the whole trading day is considered LIQUID then the value 'LIQUID' is returned.
    - `tradingTimes` TradingScheduleItemsSchedulesItemsTradingTimesItems[] — Object containing trading times.
      - `openingTime` string — Opening time of the trading day.
      - `closingTime` string — Closing time of the trading day.
      - `prop` string
      - `cancelDayOrders` string — Cancel time for day orders.

## Other responses

- `400` — Missing, empty, non-numeric, or out-of-range parameter. The `error` field is always prefixed with `Bad Request:`.
- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)