Returns classified dealer positioning data for the specified symbol. Each active strike is analyzed to determine whether the open interest was likely bought or sold by customers, providing a directional conviction score and per-strike gamma contribution breakdown.
Parameters
Path Parameters
Name
Type
Required
Description
symbol
string
Required
Underlying symbol. One of: SPX, SPY, QQQ, IWM, NDX, RUT.
Response
The response data object contains:
positionsobject[]Array of position objects, one per active strike with significant open interest
net_dealer_gexnumberNet dealer gamma exposure computed from the classified positioning (in dollars)
directional_convictionnumberScore from -1.0 (strong bearish conviction) to +1.0 (strong bullish conviction) based on the aggregate positioning profile
num_strikesintegerNumber of active strikes included in the analysis
Position Object Fields
positions[].strikenumberThe strike price
positions[].oiintegerCurrent open interest at this strike
positions[].oi_changeintegerChange in open interest since the previous session
positions[].classificationstringPositioning classification: "customer_bought", "customer_sold", or "mixed"
positions[].gamma_contributionnumberThis strike's contribution to total dealer GEX (in dollars)
Note
The classification algorithm uses a 3rd-generation taker-flow model that considers trade-level aggressor data, volume-OI relationships, and implied volatility changes to determine whether customers initiated or closed positions at each strike.
curl -X GET "https://api.gexengine.com/v1/positioning/SPX" \
-H "X-API-Key: YOUR_API_KEY"