from finance_dev import FinanceDev, models
import os
with FinanceDev(
security=models.Security(
client_id=os.getenv("FINANCE_DEV_CLIENT_ID", ""),
client_secret=os.getenv("FINANCE_DEV_CLIENT_SECRET", ""),
),
) as fd_client:
res = fd_client.analytics.get_options_stocks_top_volume(size=10)
assert res.options_screener_items is not None
# Handle response
print(res.options_screener_items)curl --request GET \
--url https://api.aries.com/v1/options/stocks/top-volume \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/options/stocks/top-volume', 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-volume",
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-volume"
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-volume")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/options/stocks/top-volume")
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 Volume Options for Stocks
Retrieve stock options contracts with the highest trading volume. Identify the most actively traded equity options contracts.
Use Case: Build an options volume scanner to find liquid contracts and track activity.
from finance_dev import FinanceDev, models
import os
with FinanceDev(
security=models.Security(
client_id=os.getenv("FINANCE_DEV_CLIENT_ID", ""),
client_secret=os.getenv("FINANCE_DEV_CLIENT_SECRET", ""),
),
) as fd_client:
res = fd_client.analytics.get_options_stocks_top_volume(size=10)
assert res.options_screener_items is not None
# Handle response
print(res.options_screener_items)curl --request GET \
--url https://api.aries.com/v1/options/stocks/top-volume \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/options/stocks/top-volume', 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-volume",
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-volume"
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-volume")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/options/stocks/top-volume")
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.
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?