Get Option Chain

Set Admin Credentials...
Get Option Chain

GET

Get Option Chain

Get option chain for an optionable Symbol

Resource URL

https://api.tdameritrade.com/v1 /marketdata/chains

Query Parameters

Name Values Description
apikey

Pass your OAuth User ID to make an unauthenticated request for delayed data.
symbol

Enter one symbol
contractType

Type of contracts to return in the chain. Can be CALL, PUT, or ALL. Default is ALL.
strikeCount

The number of strikes to return above and below the at-the-money price.
includeQuotes

Include quotes for options in the option chain. Can be TRUE or FALSE. Default is FALSE.
strategy

Passing a value returns a Strategy Chain. Possible values are SINGLE, ANALYTICAL (allows use of the volatility, underlyingPrice, interestRate, and daysToExpiration params to calculate theoretical values), COVERED, VERTICAL, CALENDAR, STRANGLE, STRADDLE, BUTTERFLY, CONDOR, DIAGONAL, COLLAR, or ROLL. Default is SINGLE.
interval

Strike interval for spread strategy chains (see strategy param).
strike

Provide a strike price to return options only at that strike price.
range

Returns options for the given range. Possible values are:

ITM: In-the-money
NTM: Near-the-money
OTM: Out-of-the-money
SAK: Strikes Above Market
SBK: Strikes Below Market
SNK: Strikes Near Market
ALL: All Strikes

Default is ALL.
fromDate

'Only return expirations after this date. For strategies, expiration refers to the nearest term expiration in the strategy. Valid ISO-8601 formats are: yyyy-MM-dd and yyyy-MM-dd'T'HH:mm:ssz.'
toDate

'Only return expirations before this date. For strategies, expiration refers to the nearest term expiration in the strategy. Valid ISO-8601 formats are: yyyy-MM-dd and yyyy-MM-dd'T'HH:mm:ssz.'
volatility

Volatility to use in calculations. Applies only to ANALYTICAL strategy chains (see strategy param).
underlyingPrice

Underlying price to use in calculations. Applies only to ANALYTICAL strategy chains (see strategy param).
interestRate

Interest rate to use in calculations. Applies only to ANALYTICAL strategy chains (see strategy param).
daysToExpiration

Days to expiration to use in calculations. Applies only to ANALYTICAL strategy chains (see strategy param).
expMonth

'Return only options expiring in the specified month. Month is given in the three character format.
Example: JAN
Default is ALL.''
optionType

'Type of contracts to return. Possible values are:

S: Standard contracts
NS: Non-standard contracts
ALL: All contracts

Default is ALL.''

Header Parameters

Name Values Description
Authorization

Supply an access token to make an authenticated request. The format is Bearer <access token>.

Try it out !!

HTTP Basic

Set...

OAuth 2.0

Set...

API Key

Set...
RESET
Request Response cURL

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Resource Summary

Security

Content Type

application/json

Response Summary

Resource Error Codes

HTTP Code

Description

400

An error message indicating the caller must pass a non null value in the parameter.

401

Unauthorized

403

Forbidden

404

An error message indicating optionchain for the symbol was not found.

500

An error message indicating internal error in the service.

Working...