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 (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

​
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

Strike price

​
expiry
string

Expiration date

​
volume
integer<int64>

Trading volume

​
openInterest
integer<int64>

Open interest

​
lastPrice
number

Last trade price

​
change
number

Price change from previous close

​
changePercent
number

Percentage change from previous close

​
bid
number

Bid price

​
ask
number

Ask price

​
impliedVolatility
number

Implied volatility