SPAN Margin Calculator

This API allows you to calculate the combined SPAN and exposure margin for futures and options, including margin benefits from hedges and individual instrument margin details.

USE CASE

Compare hedged and unhedged strategies and understand the margin required for the combined basket.

Note

A maximum of 20 symbols is allowed per request. Each entry in the data array counts towards this limit. Zero SPAN margin for bought options does not mean zero premium cost.

Details

Pass the instrument details inside a data array.
Margin fields are returned inside data. Individual instrument details are returned separately in individual_info.
The example buys OTM hedges before selling ATM options.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes

Attribute	Data Type	Description
`symbol`	string	Instrument symbol in FYERS symbology format.
`qty`	int	Quantity in units, not lots. Must be a multiple of the lot size for derivatives.
`side`	int	`1` = Buy; `-1` = Sell.
`type`	int	`1` = Limit; `2` = Market; `3` = Stop-market (SL-M); `4` = Stop-limit (SL-L).
`productType`	string	Product type for the instrument, such as `INTRADAY` or `MARGIN`.
`limitPrice`	float	Limit price, where applicable. Use `0.0` for market orders.
`stopLoss`	float	Stop-loss value, where applicable. Use `0.0` otherwise.

Response Attributes

Attribute	Data Type	Description
`s`	string	`ok` / `error`.
`code`	int	API response code.
`message`	string	Response or error message.
`data.span`	float	Combined SPAN risk margin for the basket.
`data.expo`	float	Combined exposure margin for the basket.
`data.total`	float	Combined margin requirement: SPAN plus exposure margin.
`data.benefit`	float	Margin saving from combining the legs. Already reflected in `total`; do not subtract it again.
`individual_info`	object	Individual margin details, keyed by FYERS instrument token.
`individual_info[token].ltp_info`	float	Instrument’s last traded price reported by the calculator.
`individual_info[token].span`	float	Individual SPAN margin.
`individual_info[token].expo`	float	Individual exposure margin.
`individual_info[token].total`	float	Individual total margin.

Python is not available for this example. Showing cURL instead.

RequestcURL

curl --location 'https://api.fyers.in/api/v2/span_margin' \
  --header 'Authorization: <APP_ID>:<ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
    "data": [
      {"symbol":"NSE:NIFTY26OCT22650CE","qty":65,"side":1,"type":2,"productType":"INTRADAY","limitPrice":0.0,"stopLoss":0.0},
      {"symbol":"NSE:NIFTY26OCT22350PE","qty":65,"side":1,"type":2,"productType":"INTRADAY","limitPrice":0.0,"stopLoss":0.0},
      {"symbol":"NSE:NIFTY26OCT22500CE","qty":65,"side":-1,"type":2,"productType":"INTRADAY","limitPrice":0.0,"stopLoss":0.0},
      {"symbol":"NSE:NIFTY26OCT22500PE","qty":65,"side":-1,"type":2,"productType":"INTRADAY","limitPrice":0.0,"stopLoss":0.0}
    ]
  }'

{
  "code": 200,
  "message": "",
  "data": {
    "span": 10609,
    "expo": 60195.59,
    "total": 70804.59,
    "benefit": 254358.13999999998
  },
  "s": "ok",
  "individual_info": {
    "101126102751325": {
      "ltp_info": 156.95,
      "span": 0,
      "expo": 0,
      "total": 0
    },
    "101126102751330": {
      "ltp_info": 332,
      "span": 139016.15,
      "expo": 30097.79,
      "total": 169113.94
    },
    "101126102751331": {
      "ltp_info": 205.15,
      "span": 125951,
      "expo": 30097.79,
      "total": 156048.79
    },
    "101126102751338": {
      "ltp_info": 245.1,
      "span": 0,
      "expo": 0,
      "total": 0
    }
  },
  "latency": ""
}