---
title: "Search Futures By Symbol"
method: GET
path: "/trsrv/futures"
tags: ["tradingContracts"]
---

# Search Futures By Symbol

`GET /trsrv/futures`

Returns a list of non-expired future contracts for given symbol(s)

## Query parameters

- `symbols` string, required
- `exchange` string

## Response `200`

Successful response containing a contract's security definition.

- Features
  - `symbol` FeaturesSymbolItems[] — Displayed as the string of your symbol Contains a series of objects for each symbol that matches the requested.
    - `symbol` string — The requested symbol value.
    - `conid` integer — Contract identifier for the specific symbol
    - `underlyingConid` integer — Contract identifier for the future's underlying contract.
    - `expirationDate` integer — Expiration date of the specific future contract.
    - `ltd` integer — Last trade date of the future contract.
    - `shortFuturesCutOff` integer — Represents the final day for contract rollover for shorted futures.
    - `longFuturesCutOff` integer — Represents the final day for contract rollover for long futures.

## Other responses

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