Skip to main content
GET
Get contract recommendation

Query Parameters

symbol
string
required

Stock ticker symbol (e.g., 'AAPL')

Required string length: 1 - 10
direction
string
required

Trade direction: 'bullish' or 'bearish'

Pattern: ^(bullish|bearish)$
target_delta
number
default:0.3

Target absolute delta (0.10 - 0.90)

Required range: 0.1 <= x <= 0.9
dte_min
integer
default:7

Minimum days to expiration

Required range: 1 <= x <= 365
dte_max
integer
default:21

Maximum days to expiration

Required range: 1 <= x <= 365
max_spread_pct
number
default:0.1

Maximum bid-ask spread as decimal (0.10 = 10%)

Required range: 0.01 <= x <= 0.5
min_volume
integer
default:50

Minimum daily volume

Required range: x >= 0

Response

Contract recommendations

Response containing contract recommendations.

symbol
string
required
direction
string
required
criteria
Criteria · object
required
primary_recommendation
ContractRecommendation · object | null
required

Recommended options contract with full details.

alternatives
ContractRecommendation · object[]
no_suitable_contracts_reason
string | null