Option Chain with Greeks

Overview

The Option Chain with Greeks API allows traders and developers to fetch nearby option strikes (calls and puts) for a given underlying index or stock, along with their associated Greeks (Delta, Gamma, Theta, Vega, Rho) and implied volatility (IV). You specify the symbol, exchange, expiry, and the central strikePrice, along with the number of strikes you want above and below that price. Alternatively, pass count=ALL to retrieve the complete option chain without specifying a strike price.

Key benefits:

• Granular Option Data: Access multiple strikes around a central price to see calls and puts.
• Greeks Included: Each option includes Delta, Gamma, Theta, Vega, Rho, and IV.
• Full Chain Support: Use count=ALL to retrieve the entire option chain in one call.
• Customization: Choose how many strikes (count) you want on either side of the strike price.
• Integration: Use returned tradingSymbol values to place orders or fetch quotes for each option contract.

Note: Maximum value allowed for count is 30. Use count=ALL to fetch the complete chain (strikePrice is not
required in this case).

Endpoint & Method

URL:

https://connect-go.thefirstock.tech/V1/optionChainGreeks

Headers:

Request Body:

Request:

With specific count and strike price:

{
"userId": "{{userId}}",
"jKey": "{{jKey}}",
"exchange": "NFO",
"symbol": "NIFTY",
"expiry": "24JUL25",
"count": "10",
"strikePrice": "25500"
}

With count=ALL (no strikePrice needed):

{
"userId": "{{userId}}",
"jKey": "{{jKey}}",
"exchange": "NFO",
"symbol": "NIFTY",
"expiry": "24JUL25",
"count": "ALL"
}

Example Usage

curl --location 'https://api.firstock.in/V1/optionChainGreeks' \
--header 'Content-Type: application/json' \
--data '{
    "userId": "NP2997",
    "jKey": "4c3acc86bfc1a66788eed5bf2787d8ff6036879b1cff37b7918a8c6d7382a815",
    "exchange": "NFO",
    "symbol": "NIFTY",
    "expiry": "24MAR26",
    "count": "ALL",
    "strikePrice": "25500"
}'

from firstock import firstock

result = firstock.optionChainGreeks(
exchange="NFO",
symbol="NIFTY",
expiry="17MAR26",
count="10",
strikePrice="25500",
userId='YOUR_USER_ID'
)

print(result)

import (
    "github.com/the-firstock/firstock-developer-sdk-golang/Firstock"
)
optionChainGreeksRequest := Firstock.OptionChainGreeksRequest{
    UserId:      "{{userId}}",
    Exchange:    "NFO",
    Symbol:      "RELIANCE",
    Expiry:      "30MAR26",
    Count:       "1",
    StrikePrice: "1420",
}
optionChainGreeks, err := Firstock.OptionChainGreeks(optionChainGreeksRequest)
fmt.Println("Error:", err)
fmt.Println("Result:", optionChainGreeks)

import (
    "github.com/the-firstock/firstock-developer-sdk-golang/Firstock"
)
optionChainGreeksRequest := Firstock.OptionChainGreeksRequest{
    UserId:      "{{userId}}",
    Exchange:    "NFO",
    Symbol:      "RELIANCE",
    Expiry:      "30MAR26",
    Count:       "1",
    StrikePrice: "1420",
}
optionChainGreeks, err := Firstock.OptionChainGreeks(optionChainGreeksRequest)
fmt.Println("Error:", err)
fmt.Println("Result:", optionChainGreeks)

Response Structure

Success Response (200 OK):

A valid request returns a 200 OK status and a JSON object containing:

• status: "success".
• message: "Option chain with Greeks retrieved successfully"
• data: An array of option contract objects with Greeks.

Key Fields within data:

Response

{
"status": "success",
"message": "Option chain with Greeks retrieved successfully",
"data": [
{
"exchange": "NFO",
"token": "79424",
"tradingSymbol": "NIFTY24APR25C22950",

"optionType": "CE",
"pricePrecision": "2",
"lotSize": "75",
"tickSize": "0.05",
"strikePrice": "22950.00",
"lastTradedPrice": "130.00",
"parentToken": "26000",
"delta": "0.45",
"gamma": "0.002",
"theta": "-12.5",
"vega": "8.3",
"rho": "0.15",
"iv": "14.25",
"oi": "125400"
}
]
}

{
"status": "failed",
"code": "400",
"name": "BAD_REQUEST",
"error": {
"field": "symbol",
"message": "Symbol is required"
}
}

Common Error Scenarios:

Usage & Best Practices

• Building Option Chains
  • Perfect for constructing an option chain UI that shows multiple strikes above and below a given price with Greeks.
• Full Chain Retrieval
  • Use count=ALL when you need the complete option chain. strikePrice is not
    required in this case.
• Session Maintenance
  • Ensure your jKey is still valid. If you see an invalid session error, prompt for
    re-login.
• Strike / Expiry Selection
  • Make sure strikePrice and expiry align with actual market contracts based on the symbol's available expiries.
• Lot Sizes
  • The API returns lotSize; use it to place orders or calculate margin if needed.
• Greeks Usage
  • Use Delta and IV to assess option sensitivity and pricing. Theta helps understand time decay impact day over day.
• Integration with Quotes
  • Once you have the tradingSymbol for a call or put, use it to fetch real-time
    quotes or place trades for that contract.

Conclusion

The Option Chain with Greeks API is essential for quickly assembling a list of nearby call and put contracts around a chosen strike price, complete with Greeks and implied volatility. This data helps traders analyze potential option strategies such as spreads, straddles, and strangles. Always confirm your session (jKey) is
valid, handle errors for missing fields, and integrate the returned tradingSymbol into further API calls for quotes or order placement. Use count=ALL for complete chain analysis when a specific strike is not required.