Options

Option expiration dates, option chain data, individual option quotes, unusual flow detection, put/call ratios, IV rank, max pain, volume analysis, Greeks visualization, and earnings straddle pricing.

Base URLhttps://api.apps.myallies.com/v1
GET/options/{code}/expirationsGet option expiration datesexpand_less

Get option expiration dates

API Key (X-Api-Key)

Retrieve all available option expiration dates for a given contract, including days until expiration for each date.

Parameters

NameTypeDescription
code *
path
string
Contract code in SYMBOL_EXCHANGE format. Use GET /market/exchanges/{symbol} to find available exchanges.

Responses

200Available expiration dates
404Symbol not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/expirations" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "expirations": [
      {
        "expirationDate": "2026-03-21",
        "daysToExpiration": 4
      },
      {
        "expirationDate": "2026-03-28",
        "daysToExpiration": 11
      },
      {
        "expirationDate": "2026-04-17",
        "daysToExpiration": 31
      },
      {
        "expirationDate": "2026-06-19",
        "daysToExpiration": 94
      }
    ]
  },
  "error": null,
  "meta": {
    "requestId": "req_b1c2d3",
    "timestamp": "2026-03-17T10:08:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/options/{code}/chainGet option chainexpand_less

Get option chain

API Key (X-Api-Key)

Retrieve option chain data for a contract at a specific expiration date. Filter by option type (Call or Put). Returns strike prices, last price, bid/ask, change, and in-the-money status.

Parameters

NameTypeDescription
code *
path
string
Contract code in SYMBOL_EXCHANGE format. Use GET /market/exchanges/{symbol} to find available exchanges.
expiry
query
string
Expiration date in yyMMdd format (e.g., 260320)
right
query
string
Option type: C (Call) or P (Put)
CP
Default: C

Responses

200Option chain data
400Invalid expiry format or option type
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/chain?expiry=260320" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "expiry": "260320",
    "right": "C",
    "items": [
      {
        "strike": 170,
        "last": 9.2,
        "bid": 9.1,
        "ask": 9.3,
        "change": 0.45,
        "changePercent": 5.14,
        "inTheMoney": true
      },
      {
        "strike": 175,
        "last": 5.4,
        "bid": 5.3,
        "ask": 5.5,
        "change": 0.3,
        "changePercent": 5.88,
        "inTheMoney": true
      },
      {
        "strike": 180,
        "last": 2.1,
        "bid": 2,
        "ask": 2.2,
        "change": -0.15,
        "changePercent": -6.67,
        "inTheMoney": false
      },
      {
        "strike": 185,
        "last": 0.65,
        "bid": 0.6,
        "ask": 0.7,
        "change": -0.1,
        "changePercent": -13.33,
        "inTheMoney": false
      }
    ]
  },
  "error": null,
  "meta": {
    "requestId": "req_e4f5g6",
    "timestamp": "2026-03-17T10:09:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/options/{code}/quoteGet option contract quoteexpand_less

Get option contract quote

API Key (X-Api-Key)

Retrieve a real-time quote for a specific option contract. Includes bid/ask, mark price, strike distance, return on risk, in-the-money status, and break-even price.

Parameters

NameTypeDescription
code *
path
string
Contract code in SYMBOL_EXCHANGE format. Use GET /market/exchanges/{symbol} to find available exchanges.
expiry *
query
string
Expiration date (yyyy-MM-dd format)
strike *
query
number
Strike price
right
query
string
Option type: C (Call) or P (Put)
CP
Default: P

Responses

200Option contract quote
400Invalid parameters (expiry format, strike, or right)
404Option contract not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/quote?expiry=2026-04-17&strike=170" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "expiration": "2026-04-17",
    "strike": 170,
    "right": "Put",
    "lastPrice": 2.35,
    "bid": 2.3,
    "ask": 2.4,
    "midPrice": 2.35,
    "markPrice": 2.34,
    "change": -0.15,
    "changePercent": -6,
    "strikeAwayPercent": 4.78,
    "returnPercent": 1.38,
    "inTheMoney": false,
    "breakEven": 167.65,
    "underlyingPrice": 178.5
  },
  "error": null,
  "meta": {
    "requestId": "req_oq1t2",
    "timestamp": "2026-03-23T15:30:01Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/options/{code}/flowDetect unusual options activityexpand_less

Detect unusual options activity

API Key (X-Api-Key)

Analyzes volume changes, IV/HV divergence, and put/call skew to flag unusual options activity. Returns signals when significant flow is detected.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Options flow analysis with unusual activity signals
404Contract or options data not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/flow" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/put-call-ratioGet put/call ratioexpand_less

Get put/call ratio

API Key (X-Api-Key)

Put/call ratio and related volume data including open interest and volume change.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Put/call ratio, open interest, and volume data
404Contract or options data not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/put-call-ratio" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/iv-rankGet IV rank / percentileexpand_less

Get IV rank / percentile

API Key (X-Api-Key)

Compares current implied volatility against historical volatility to determine IV rank.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200IV rank data with implied vs historical volatility
404Contract or options data not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/iv-rank" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/max-painCalculate max painexpand_less

Calculate max pain

API Key (X-Api-Key)

Calculate the max pain strike price for a given expiration -- the strike where option writers have minimum loss.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)
expiry *
query
string
Expiration date (yyyy-MM-dd)

Responses

200Max pain strike with pain values at each strike
400Invalid expiry format
404Contract or option chain not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/max-pain?expiry=2026-04-17" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/volumeGet options volume analysisexpand_less

Get options volume analysis

API Key (X-Api-Key)

Options volume, open interest, and comparison to underlying stock volume.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Options volume analysis with underlying comparison
404Contract or options data not found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/volume" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/greeksGet options Greeks dataexpand_less

Get options Greeks data

API Key (X-Api-Key)

Strike-by-strike premium analysis with Greeks visualization. Includes put-sell scoring for premium sellers.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)
expiry *
query
string
Expiration date (yyyy-MM-dd)
right
query
string
Option type: C (Call) or P (Put)
Default: P

Responses

200Strike-by-strike Greeks data with put-sell scoring
400Invalid expiry or right parameter
404No option chain data found
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/greeks?expiry=2026-04-17" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/earnings-straddleGet earnings straddle pricingexpand_less

Get earnings straddle pricing

API Key (X-Api-Key)

Expected move around an upcoming earnings event. Calculates ATM straddle cost, expected move percentage, and includes supply-chain-based earnings prediction when available.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Earnings straddle pricing with expected move and supply chain signal
404Contract not found or no upcoming earnings
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/earnings-straddle" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/expected-moveGet expected move across expirationsexpand_less

Get expected move across expirations

API Key (X-Api-Key)

Derives 1-sigma and 2-sigma expected price ranges from implied volatility and ATM straddle pricing across the nearest 4 expirations. Each point includes DTE, one-sigma dollar/percent move, two-sigma move, straddle price, and upper/lower price bounds.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Expected move data points for upcoming expirations
404No pricing or no option expirations available
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/expected-move" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/earnings-move-historyGet historical earnings moveexpand_less

Get historical earnings move

API Key (X-Api-Key)

Historical actual stock price change around past earnings events (up to 12 quarters). Returns average/median absolute move, EPS beat rate, and per-event EPS actual vs estimate with direction and price before/after.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Historical earnings moves with statistics
404No historical earnings data available
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/earnings-move-history" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/oi-distributionGet open interest distributionexpand_less

Get open interest distribution

API Key (X-Api-Key)

Open interest distribution by strike for a given expiration. Flags strikes with significant OI concentration (>2x average) and returns total call/put OI plus put/call OI ratio.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)
expiry *
query
string
Expiration date (yyyy-MM-dd)

Responses

200Open interest by strike with significance flags
400Invalid expiry format
404No pricing or option chain data
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/oi-distribution?expiry=2026-04-17" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
GET/options/{code}/premium-scannerScan premium-selling candidatesexpand_less

Scan premium-selling candidates

API Key (X-Api-Key)

Scans the option chain of a single underlying for the best short-put (or short-call) premium-selling candidates. Filters OTM contracts by delta and DTE range, ranks by annualized return, and returns up to 20 candidates with delta, premium, DTE, strike-away percent, and put-sell score.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)
strategy
query
string
Strategy: short-put (default) or short-call
Default: short-put
minDte
query
integer
Minimum days to expiration (1-365)
Default: 20
maxDte
query
integer
Maximum days to expiration (1-365)
Default: 60
maxDelta
query
number
Maximum absolute delta (0.05-0.50)
Default: 0.30

Responses

200Ranked premium-selling candidates for the underlying
404No pricing or no option expirations available
curl -X GET "https://api.apps.myallies.com/v1/options/AAPL_NASDAQ/premium-scanner" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

terminal Try It

expand_more
POST/options/calculatorBlack-Scholes option pricing calculatorexpand_less

Black-Scholes option pricing calculator

API Key (X-Api-Key)

Compute theoretical option price and all Greeks for given inputs. No market data lookup required — purely mathematical. Useful for what-if analysis, strategy planning, and educational purposes.

Responses

200Theoretical price and Greeks
400Invalid input parameters
curl -X POST "https://api.apps.myallies.com/v1/options/calculator" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "underlyingPrice": 150,
  "strike": 145,
  "daysToExpiration": 30,
  "impliedVolatility": 35,
  "right": "P"
}'
Response Example
{
  "success": true,
  "data": {
    "theoreticalPrice": 2.1543,
    "delta": -0.2874,
    "gamma": 0.0312,
    "theta": -0.0892,
    "vega": 0.1534,
    "right": "Put",
    "underlyingPrice": 150,
    "strike": 145,
    "daysToExpiration": 30,
    "impliedVolatility": 35,
    "riskFreeRate": 5,
    "expectedMove": 15.03,
    "intrinsic": 0,
    "extrinsic": 2.1543
  },
  "error": null,
  "meta": {
    "requestId": "req_oc1a1",
    "timestamp": "2026-04-14T10:00:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
POST/options/implied-volatilityCalculate implied volatilityexpand_less

Calculate implied volatility

API Key (X-Api-Key)

Solve for implied volatility from a market option price using Newton-Raphson with bisection fallback. Returns the IV that produces the given price under Black-Scholes assumptions.

Responses

200Calculated implied volatility
400Invalid parameters or no solution found
curl -X POST "https://api.apps.myallies.com/v1/options/implied-volatility" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "marketPrice": 5.25,
  "underlyingPrice": 150,
  "strike": 145,
  "daysToExpiration": 30,
  "right": "C"
}'
Response Example
{
  "success": true,
  "data": {
    "impliedVolatility": 32.45,
    "right": "Call",
    "marketPrice": 5.25,
    "theoreticalPrice": 5.2501,
    "underlyingPrice": 150,
    "strike": 145,
    "daysToExpiration": 30,
    "riskFreeRate": 5
  },
  "error": null,
  "meta": {
    "requestId": "req_iv1b2",
    "timestamp": "2026-04-14T10:00:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more