Data Types

BSE Equity

NSE Equity

NSE Futures & Options

BSE Futures & Options

Cash & Carry

Positions are taken for delivery
(not squared off intraday).

Intraday

Positions must be squared off
within the same trading day.

Market (sometimes used)

Depending on context, can refer to “Market”
product type in certain integrations.

Market Order

Executes immediately at the best available market price.

Limit Order

Executes at or better than a specific limit price
set by the user.

Stop Loss Limit Order

Triggers a limit order once a specified stop
price is reached.

Stop Loss Market Order

Triggers a market order once a specified stop price
is reached.

string

Indicates whether the request succeeded or
failed. Possible values: "success" or "failed".

"success"

string

Describes the outcome of the request.

"Login successful"

string or integer

Error or status code, often provided
on failure.

"400", "401"

string

Error name or identifier.

"MISSING_FIELD",
"BAD_REQUEST"

object

Contains error details when status is "failed".

"{"field": "...",
"message": "..."}"

object or array

Primary response payload, can be an
object or array of objects.

Varies by endpoint

string

Unique identifier for the user.

"AB1234"

string

Hashed password for authentication.

"be5628d7f2d0..."

string

Time-based One-Time Password (MFA code).

"1997"

string

Vendor or partner code used
for authorizing API usage.

"AB1234_API"

string

API key used to authenticate requests.

"2b9d6c37476be0..."

string

Session token or key required
for subsequent requests.

"1478b9b71707..."

string

Alternate session token returned on login.

"abc123"

string

Account ID, often same as
userId in some responses.

"AB1234"

string

Full name of the user.

"PERESANDRA
SUBRAMANYAM KUMAR"

string

Email address associated with the user account.

"nitishkumarpsXXX
@gmail.com"

array

List of enabled exchanges for the user.

["NFO", "NSE",
"BSE"]

array

List of supported order types.

"["MKT", "LMT",
"SL-LMT", "SL-MKT"]"

string

User privilege level.

"INVESTOR"

string

Timestamp of server
processing the request.

"10:40:21 23-04-2025"

string

Exchange code (e.g.,"NSE" , "BSE",
"NFO").

"NFO"

string

Symbol or instrument identifier.

"NIFTY06MAR25C22500"

string

Display name or descriptive label
for the symbol.

"Nifty 50"

string or number

Most recent traded price.

"2417780"

string

Opening price for the trading day.

"2418540"

string

Highest price of the day.

"2420165"

string

Lowest price of the day.

"2407200"

string

Previous day's closing price.

"2412555"

string

Instrument segment: e.g., "EQT",
"Options" ,"Indices" .

"Indices"

string or number

Numeric identifier for the instrument.

26000

string or number

Size of one lot (for derivatives).

"1"

string

Minimum price increment for the
instrument.

"0.05"

string

Open interest for F&O instruments.

"0.00"

string

Top buy price/quantity at level X.
For example, bestBuyPrice1 or
bestBuyQuantity1.

"0.00","0"

string

Top sell price/quantity at level X.

"0.00","0"

string

Search term or partial symbol
for the instrument lookup.

"ITC"

string

Display-friendly name for
the scrip.

"ITC APR 425 CE"

string

Category or type of instrument
(e.g., Equity, Options).

"Equity"

array of objects

Contains multiple quote objects,
each with standard quote fields.

[ ...... ]

string

Start timestamp (e.g., DD-MM-YYYY HH:MM:SS)
for historical data.

"09:15:00
23-04-2025"

string

End timestamp for historical data.

"15:29:00
23-04-2025"

string

Candle interval ("1d", "2mi",
"1mi", etc.).

"1d"

string

Candle start time in ISO-like format.

"2025-02-11
T00:00:00"

number

Unix epoch timestamp (seconds
since 1970-01-01).

1739212200

number

Candle prices during the specified
interval.

23071.8

number

Trading volume and open interest
(for F&O) over the interval.

0

string or number

Unique identifier for the order.

"25042100011119"

string

Exchange code ("NSE", "BSE",
"NFO", etc.).

"NSE"

string

"B" for Buy, "S" for Sell.

"B"

string

Order duration (e.g., "DAY", "IOC").

"DAY"

number

Customer type (e.g., "C").

"C"

number

Product type (e.g., "C",
"M","I").

MKT

string

Pricing model ("MKT", "LMT", etc.).

0

number

Limit price, or 0 if market order.

780,0

number

Stop-Loss trigger price.

0

number

Number of shares or lots.

1

number

Optional note or reference for the order.

"Test"

number (optional)

Market protection buffer for
certain order types.

0.5

string or number

Margin required for the new order.

"798.2978

string or number

Remaining margin after placing the order.

5068.297799985

string

Additional info (e.g., "Insufficient Balance").

"Insufficient
Balance"

string or number

Total cash in the trading account.

7906.99999

string

Timestamp of margin calculation.

"17:54:23
21-04-2025"

string or number

Total shares (or lots) filled.

"0", "1"

string or number

Average fill price.

"0.00", "2837"

string

Reason for order rejection.

"ORA: order generation
source info missing"

string

Time the order was placed.

"09:30:02
21-04-2025"

string

Order status (e.g., "REJECTED",
"Open", Filled"").

"REJECTED"

string

Unique identifier for a fill
(trade execution).

"401070025"

number

Price at which the trade
was executed.

2837

string or number

Quantity filled at this execution.

"1"

string

Timestamp of the trade update
from the exchange.

"21-04-2025
09:30:02"

string

Exchange’s order ID reference.

"1200000006968574"

string

Broker collateral amount.

"0.00"

string

Current cash balance in the account.

"51.68"

string

Value of pledged collateral.

"0.00"

string

Exposure margin used.

"0.00"

string

Margin currently utilized by
open positions.

"28.39"

string

Funds paid into the account but
not yet cleared.

"0.00"

string

Peak margin utilized during the day.

"0.00"

string

Premium credit/debit for options trades.

"0.00"

string

SPAN margin (for F&O).

"0.00"

string

Realized profit or loss.

"0.00"

string

Average price for intraday buy.

"2837.00"

string

Quantity bought during the day.

"1.00"

string

Average price for intraday sell.

"0.00"

string

Quantity sold during the day.

"0.00"

string

et position (buy - sell).

"1.00"

string

Weighted average price for the
net position.

"2837.00"

string

Mark-to-market P/L for open positions.

"0.00"

string

Exchange where the holding is listed
("NSE", "BSE").

"NSE"

string

Symbol representing the holding.

"VIKASECO-EQ"

number

Total brokerage for the transaction.

2000

number

Exchange transaction charges.

0

number

Goods and Services Tax.

0

number

SEBI turnover fee, if applicable.

0

number

Stamp duty, if applicable.

0

number

Additional comments or warnings.

"\r"

array of numbers

Margin details for multiple
orders in the basket.

[126075.6,
126783.0242, 2]

number

Additional margin required for the
new basket items.

126783.0242

number

Margin before the new basket was added.

0

number

Updated total margin in use after
adding the basket.

126783.0242

string

Any relevant comments or warnings.

""

string

Instrument type/category.

"UNDIND"

string

Market segment ("EQT", "FNO", etc.).

"EQT"

string

System-recognized symbol name.

"NIFTY"

string

Display-oriented symbol name.

"Nifty 50"