For the complete documentation index, see llms.txt. This page is also available as Markdown.

SyntheticFuture

Calculate the synthetic futures price using ATM options (Put-Call Parity).

Endpoint URL

Local Host   :  POST http://127.0.0.1:5000/api/v1/syntheticfuture
Ngrok Domain :  POST https://<your-ngrok-domain>.ngrok-free.app/api/v1/syntheticfuture
Custom Domain:  POST https://<your-custom-domain>/api/v1/syntheticfuture

Sample API Request

{
  "apikey": "<your_app_apikey>",
  "underlying": "NIFTY",
  "exchange": "NSE_INDEX",
  "expiry_date": "25NOV25"
}

Sample cURL Request

curl -X POST http://127.0.0.1:5000/api/v1/syntheticfuture \
  -H 'Content-Type: application/json' \
  -d '{
  "apikey": "<your_app_apikey>",
  "underlying": "NIFTY",
  "exchange": "NSE_INDEX",
  "expiry_date": "25NOV25"
}'

Sample API Response

Request Body

Parameter
Description
Mandatory/Optional
Default Value

apikey

Your OpenAlgo API key

Mandatory

-

underlying

Underlying symbol (NIFTY, BANKNIFTY, SENSEX)

Mandatory

-

exchange

Exchange: NSE_INDEX, BSE_INDEX

Mandatory

-

expiry_date

Expiry date in DDMMMYY format

Mandatory

-

Response Fields

Field
Type
Description

status

string

"success" or "error"

underlying

string

Underlying symbol

underlying_ltp

number

Current spot price

expiry

string

Expiry date

atm_strike

number

ATM strike used for calculation

synthetic_future_price

number

Calculated synthetic futures price

Formula

Where:

  • Strike Price = ATM strike

  • Call Premium = LTP of ATM Call

  • Put Premium = LTP of ATM Put

Understanding Synthetic Futures

What is Basis?

Basis
Interpretation

Positive

Cost of carry (normal market)

Large positive

High demand for futures/options

Negative

Backwardation (rare)

Example Calculation

Notes

  • Synthetic futures provide a fair value reference for actual futures

  • Useful for arbitrage detection between futures and options

  • The basis indicates the cost of carry

  • Near expiry, synthetic future converges to spot price

Use Cases

  • Arbitrage strategies: Compare with actual futures price

  • Fair value calculation: Determine if futures are overpriced/underpriced

  • Options pricing: Use as underlying for options Greeks calculation


Back to: API Documentation

Last updated