SPAN MARGIN INFO

This API retrieves the SPAN Margin information for a derivative contract, including initial margin, exposure margin, total margin requirements, and contract value details.

🔗 Path Parameters

Parameter	Type	Required	Description	Example
tenantid	string	Yes	Unique id provided for the tenant by SIPL	"tenant001"
exchangeSegment	integer	Yes	Exchange Segment ID	2
scripToken	integer	Yes	Scrip Token of the derivative contract	56838

🔍 Query Parameters

Parameter	Type	Required	Description	Example
userId	string	Yes	User ID (UCC)	"{{user_id}}"

🔑 Header Parameters

Header	Type	Description	Example
Content-Type	string	Request payload format	application/json
Authorization	string	Access token for authenticated requests	{{access_token}}
x-api-key	string	API key used to authorize request	{{x-api-key}}

🟢 Success Response - 200 OK

Content-Type: application/json

Field	Type	Description
status	boolean	Status of API call
result	object	SPAN margin details for the specified derivative contract

📦 Result Object Fields

Field	Type	Description	Example
Market Segment	string	Exchange market segment	"NSE_FO"
Symbol	string	Trading symbol	"NIFTY"
Instrument Type	string	Instrument type	"FUTIDX"
ExpiryDate	string	Contract expiry date	"27 Jun 2026"
Lot Size	integer	Market lot size	75
Initial Margin Long	integer	Initial margin required to buy 1 lot	150000
Initial Margin Short	integer	Initial margin required to sell 1 lot	155000
Initial Margin % Long	integer	Initial margin percentage to buy 1 lot	12
Initial Margin % Short	integer	Initial margin percentage to sell 1 lot	13
Exposure Margin	integer	Exposure margin prescribed by the exchange	50000
Exposure Margin %	integer	Exposure margin percentage	4
Total Margin % Long	integer	Total margin percentage required for buying 1 lot	16
Total Margin % Short	integer	Total margin percentage required for selling 1 lot	17
Total Margin Long	integer	Total margin required to buy 1 lot	200000
Total Margin Short	integer	Total margin required to sell 1 lot	205000
Total Future Value Long	integer	Total contract value for buying 1 lot	1250000
Total Future Value Short	integer	Total contract value for selling 1 lot	1250000
CVF	integer	Common Value Factor	1

📝 Notes

• SPAN Margin information is available only for derivative contracts.
• The API provides margin requirements for both:
  • Long (Buy) positions
  • Short (Sell) positions