Future Chain

GET /future/futureChain

This API is used to search futureChain for equity, derivatives, and commodity scripts based on the user-provided search symbol and exchange name.

Parameters

Name	Type	Required	Description
exchange	string	false	Name of the exchange. Valid exchanges values (NFO/BFO/CDS/MCX/MFO). If the user does not provide an exchange name, by default considered as NFO. For trading with CDS, BFO, MCX, and MFO, exchange is mandatory.
searchSymbolName	string	true	Trading Symbol of the scrip to be searched.
expiryDate	string	false	expiryDate in yyyy-MM-dd.

Sample Request Body

cURL

curl -X GET 'https://tradeapi.samco.in/future/futureChain?searchSymbolName=SENSEX&expiryDate=2024-09-27&exchange=BFO' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-session-token: <SESSION_TOKEN>'

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Sample {
  public static void main(String[] args) throws Exception {
    HttpClient client = HttpClient.newHttpClient();

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://tradeapi.samco.in/future/futureChain?searchSymbolName=SENSEX&expiryDate=2024-09-27&exchange=BFO"))
        .header("Content-Type", "application/json")
        .header("Accept", "application/json")
        .header("x-session-token", "<SESSION_TOKEN>")
        .GET()
        .build();

    HttpResponse<String> response =
        client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

NodeJs

(async () => {
  const headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-session-token': '<SESSION_TOKEN>',
  };

  const response = await fetch('https://tradeapi.samco.in/future/futureChain?searchSymbolName=SENSEX&expiryDate=2024-09-27&exchange=BFO', {
    method: 'GET',
    headers,
  });

  const data = await response.json();
  console.log(data);
})();

Python

import requests
import json

headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'x-session-token': '<SESSION_TOKEN>',
}

r = requests.get('https://tradeapi.samco.in/future/futureChain?searchSymbolName=SENSEX&expiryDate=2024-09-27&exchange=BFO',
  headers=headers)

print(r.json())

Sample Responses

200

{
    "serverTime": "25/09/24 12:34:22",
    "msgId": "d0154c21-8bbd-43ff-a64b-2f9bcdae7b9c",
    "status": "Success",
    "statusMessage": "Future chain details retrived successfully. ",
    "futureChainDetails": [
        {
            "tradingSymbol": "SENSEX24SEPFUT",
            "exchange": "BFO",
            "symbol": "859754_BFO",
            "expiryDate": "2024-09-27",
            "instrument": "IF",
            "underLyingSymbol": "SENSEX",
            "spotPrice": 84805.89,
            "lastTradedPrice": "84819.00",
            "openInterest": 13730,
            "openInterestInLot": 1373,
            "openInterestChange": 360,
            "openInterestChangeInLot": 36,
            "oichangePer": "2.69",
            "volume": 2860,
            "impliedVolatility": "0",
            "delta": "0",
            "gamma": "0",
            "theta": "0",
            "vega": "0",
            "bestBids": [
                {
                    "number": 1,
                    "quantity": "50",
                    "price": "84815.45"
                },
                {
                    "number": 2,
                    "quantity": "50",
                    "price": "84815.00"
                },
                {
                    "number": 3,
                    "quantity": "10",
                    "price": "84814.80"
                },
                {
                    "number": 4,
                    "quantity": "50",
                    "price": "84814.50"
                },
                {
                    "number": 5,
                    "quantity": "80",
                    "price": "84814.45"
                }
            ],
            "bestAsks": [
                {
                    "number": 1,
                    "quantity": "10",
                    "price": "84825.00"
                },
                {
                    "number": 2,
                    "quantity": "50",
                    "price": "84833.30"
                },
                {
                    "number": 3,
                    "quantity": "30",
                    "price": "84833.35"
                },
                {
                    "number": 4,
                    "quantity": "100",
                    "price": "84833.40"
                },
                {
                    "number": 5,
                    "quantity": "80",
                    "price": "84833.45"
                }
            ]
        }
    ]
}

Response Schema

Status Code 200

Name	Type	Description
serverTime	string	Time at Server.
msgId	string	This is a unique identifier for every request into the system. Please quote this identifier to the support team if you face issues with the API request.
status	string	The status of the API response. It can be either 'Success' or 'Failure'.
statusMessage	string	A message describing the result of the API call.
futureChainDetails	[object]	Scrips Details available for the provided search text.
tradingSymbol	string	Trading Symbol of the scrip.
exchange	string	Exchange information indicates which exchange each trading symbol comes from.
symbol	string	Symbol Code of the trading Symbol.
expiryDate	string	Shows expiry date of a trading symbol.
instrument	string	Instrument Name.
underLyingSymbol	string	Root symbol of TradingSymbol.
spotPrice	string	Spot price. Applicable in case of Futures and Options.
lastTradedPrice	string	Price at which last transaction / trade is done.
openInterest	string	Open interest is the Number of existing contracts held by buyers or sellers for any market for any given day.
openInterestChange	string	It shows Open interest change in Number of contracts held for market.
oichangePer	string	It will show the change % based on Open Interest.
volume	string	Limit amount of a security traded on the specific day.
impliedVolatility	string	The market's expectation of future volatility of the underlying asset
delta	string	Measures the sensitivity of the F&O’s price to changes in the price of the underlying asset.
gamma	string	Measures the rate of change of delta with respect to changes in the underlying asset's price.
theta	string	Measures the rate at which the F&O’s price decreases as it approaches expiration.
vega	string	Measures the sensitivity of the F&O’s price to changes in the volatility of the underlying asset.
bestBids	[object]	Most frequent trading bids for BUY.
number	string	Sequence number for Bid/Ask.
quantity	string	Quantity asked for trading.
price	string	Price asked for trading.
bestAsks	[object]	Most frequent trading asked for SELL.
number	string	Sequence number for Bid/Ask.
quantity	string	Quantity asked for trading.
price	string	Price asked for trading.