curl --request GET \
--url https://api.aries.com/v1/options/stocks/top-gainers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v1/options/stocks/top-gainers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/options/stocks/top-gainers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/options/stocks/top-gainers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/options/stocks/top-gainers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/options/stocks/top-gainers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/options/stocks/top-gainers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"ask": 3.5,
"bid": 3.4,
"change": 0.22,
"changePercent": 6.81,
"expiry": "2024-01-19",
"impliedVolatility": 0.28,
"lastPrice": 3.45,
"logoUrl": "https://cdn.example.com/logos/AAPL.png",
"openInterest": 45000,
"strike": 190,
"symbol": "AAPL240119C00190000",
"type": "c",
"underlyingSymbol": "AAPL",
"volume": 12500
}
]Top Options Gainers for Stocks
Retrieve top-performing stock options contracts with significant price gains. Discover options moves for momentum trading opportunities.
Use Case: Alert options traders when contracts experience large price swings for potential momentum or reversal plays.
curl --request GET \
--url https://api.aries.com/v1/options/stocks/top-gainers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v1/options/stocks/top-gainers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/options/stocks/top-gainers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/options/stocks/top-gainers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/options/stocks/top-gainers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/options/stocks/top-gainers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/options/stocks/top-gainers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"ask": 3.5,
"bid": 3.4,
"change": 0.22,
"changePercent": 6.81,
"expiry": "2024-01-19",
"impliedVolatility": 0.28,
"lastPrice": 3.45,
"logoUrl": "https://cdn.example.com/logos/AAPL.png",
"openInterest": 45000,
"strike": 190,
"symbol": "AAPL240119C00190000",
"type": "c",
"underlyingSymbol": "AAPL",
"volume": 12500
}
]Response
Success returns200 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
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
- 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
- Token URL
- https://api.aries.com/v1/oauth2/token
- Refresh URL
- https://api.aries.com/v1/oauth2/token
Query Parameters
Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)
1 <= x <= 99Response
Array of option contract details (symbol, underlyingSymbol, type, strike, expiry, volume, openInterest, lastPrice, change, changePercent, bid, ask, impliedVolatility, logoUrl).
Lowest current seller price for the option. Use it as the reference price when buying.
Highest current buyer price for the option. Use it as the reference price when selling.
Price change from previous close
Percentage change from previous close
Option expiration date. Use it to group contracts by expiry and show time remaining.
Market-implied volatility for the option. Use it to compare how expensive option premium is across contracts.
Most recent traded option price. Use bid and ask when estimating immediate execution cost.
URL to the underlying company or ETF logo
Number of outstanding contracts. Use it to estimate option liquidity beyond today's trading volume.
Option strike price. Use it to explain the price level where the option can be exercised.
Option contract symbol. Use this exact value when requesting option quotes, snapshots, or trades.
Option type returned by the API. c = Call; P = Put.
c, P Underlying stock or ETF symbol
Contracts traded during the current session. Use it to identify active option contracts.
Was this page helpful?