Skip to main content
GET
/
v1
/
options
/
stocks
/
top-gainers
Get Top Stock Options by Gains
curl --request GET \
  --url https://api.aries.com/v1/options/stocks/top-gainers \
  --header 'Authorization: Bearer <token>'
[ { "symbol": "AAPL240119C00190000", "underlyingSymbol": "AAPL", "logoUrl": "https://cdn.example.com/logos/AAPL.png", "type": "c", "strike": 190, "expiry": "2024-01-19", "volume": 12500, "openInterest": 45000, "lastPrice": 3.45, "change": 0.22, "changePercent": 6.81, "bid": 3.4, "ask": 3.5, "impliedVolatility": 0.28 } ]

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

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

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

​
symbol
string

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

​
underlyingSymbol
string

Underlying stock or ETF symbol

​
logoUrl
string

URL to the underlying company or ETF logo

​
type
enum<string>

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

Available options:
c,
P
​
strike
number

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

​
expiry
string

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

​
volume
integer<int64>

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

​
openInterest
integer<int64>

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

​
lastPrice
number

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

​
change
number

Price change from previous close

​
changePercent
number

Percentage change from previous close

​
bid
number

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

​
ask
number

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

​
impliedVolatility
number

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