Skip to main content
GET
Get Top ETF Options by Volume

Response

Success returns 200 OK with a JSON array of option contract details. Each item includes: symbol, underlyingSymbol, logoUrl, type, strike, expiry, volume, openInterest, lastPrice, change, changePercent, bid, ask, impliedVolatility. The type field uses the API response codes: c for Call and P for Put.

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

FlowAuthorization Code
Authorization URL
https://app.aries.com/oauth2/authorize
Token URL
https://api.aries.com/v1/oauth2/token
Refresh URL
https://api.aries.com/v1/oauth2/token
FlowClient Credentials
Token URL
https://api.aries.com/v1/oauth2/token
Refresh URL
https://api.aries.com/v1/oauth2/token
Scopes1
options:information
Access options chains and expiration data

Query Parameters

size
integer
default:10

Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)

Required range: 1 <= x <= 99

Response

Array of option contract details (symbol, underlyingSymbol, type, strike, expiry, volume, openInterest, lastPrice, change, changePercent, bid, ask, impliedVolatility, logoUrl).

ask
number

Lowest current seller price for the option. Use it as the reference price when buying.

bid
number

Highest current buyer price for the option. Use it as the reference price when selling.

change
number

Price change from previous close

changePercent
number

Percentage change from previous close

expiry
string

Option expiration date. Use it to group contracts by expiry and show time remaining.

impliedVolatility
number

Market-implied volatility for the option. Use it to compare how expensive option premium is across contracts.

lastPrice
number

Most recent traded option price. Use bid and ask when estimating immediate execution cost.

logoUrl
string

URL to the underlying company or ETF logo

openInterest
integer<int64>

Number of outstanding contracts. Use it to estimate option liquidity beyond today's trading volume.

strike
number

Option strike price. Use it to explain the price level where the option can be exercised.

symbol
string

Option contract symbol. Use this exact value when requesting option quotes, snapshots, or trades.

type
enum<string>

Option type returned by the API. c = Call; P = Put.

Available options:
c,
P
underlyingSymbol
string

Underlying stock or ETF symbol

volume
integer<int64>

Contracts traded during the current session. Use it to identify active option contracts.