IIFL Markets 数据 API：持仓、订单与资金

IIFL Securities · 银行

IIFL : Stocks, Demat & IPOs（客户端内品牌名为 IIFL Markets）是 IIFL Securities 的 Android 交易应用；IIFL Securities 是印度上市的全服务券商，现以 IIFL Capital 名义运营。散户投资者和活跃交易者先开通“存管加交易”一体化账户，随后即可查看 NSE、BSE 与 MCX 的行情，下达普通单、GTT 单和 SMO 单，跟踪持仓与 F&O 头寸，浏览共同基金、正在发行的 IPO 和 smallcase 组合，通过 UPI 和网银充值或提取卢比，并可质押持仓或开启 MTF / BNPL 以获得额外购买力。TradingView 图表、期权链、CDSL eDIS、被提名人登记与交易板块开通等流程都围绕这块下单面板展开。该应用仅面向印度——这是一家受 SEBI 监管的券商，与 Groww、Zerodha Kite、Upstox、Angel One 以及 5paisa（由 IIFL 分拆而出的券商）争夺同一批现货股票与衍生品交易用户。

保证金快照里躺着质押持仓的折算值 collateralValue，而每条 ISIN 持仓记录都带有 T+1 可售份额 t1Quantity，同一行还有 authorizedQuantity、dpQuantity 和 avgPrice。交易现金被拆成 TotalBalance、avlbMgn、sPAN 与 EligiblePayoutAmount。GTT 单的两条腿携带 triggerPrice 和 entryPrice；订单流水则返回 brokerOrderId、filledQuantity 和 orderStatus。

持仓对账工具把 demat 持仓与托管行文件逐条对齐，RMS 监控盯着 SPAN 与可提取现金，出金运营把 TokenNO 写进银行对账。openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

密码加 PIN 登录

POST /v1/brokerage/session/login openbanking

用客户的 LoginId、密码和 2PIN 换取 ClientName、DPID、POAStatus 和 SecKey——SecKey 是后续交易调用使用的会话键。

认证方式：无需鉴权。会话建立之前，由请求码、应用名、应用版本、操作系统名和 LoginId 识别客户端；请求体携带密码和 2PIN。

LoginId
Password
My2PIN
ClientName
EmailId
DPID
POAStatus
BulkOrderAllowed
OTPCredentialID
SecKey
ServerDt
LastLogin

POST /v1/brokerage/session/login HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "login.request",
    "key": "",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "Password": "********",
    "LocalIP": "10.0.0.12",
    "PublicIP": "203.0.113.25",
    "HDSerailNumber": "a1b2c3",
    "MACAddress": "02:00:00:00:00:00",
    "MachineID": "android-device-id",
    "VersionNo": "9.0",
    "RequestNo": 1,
    "My2PIN": "1234",
    "ConnectionType": "WIFI"
  }
}

{
  "head": {
    "responseCode": "login.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "Success": 1,
    "ServerDt": "2026-10-20T11:05:12+05:30",
    "LastLogin": "2026-10-19T16:42:01+05:30",
    "ClientType": 1,
    "Msg": "Login successful",
    "ClientName": "PRIYA SHARMA",
    "EmailId": "[email protected]",
    "BulkOrderAllowed": 1,
    "RunningAuthorization": 1,
    "OTPCredentialID": "otp-cred-0001",
    "DPID": "IN300000",
    "POAStatus": "Y",
    "BankName": "HDFC BANK",
    "SecKey": "<session-key>",
    "VersionChanged": 0
  }
}

demat 持仓快照

POST /v1/portfolio/holdings openfinance

返回 demat 持仓批次，含 ISIN、NSE/BSE 代码、平均成本、DP 数量、T+1 数量和授权数量，供持仓页面使用。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId；会话 Cookie 在各调用间保持。

clientCode
exch
symbol
avgPrice
quantity
LTP
isin
dpQuantity
t1Quantity
authorizedQuantity
nseCode
bseCode
product

POST /v1/portfolio/holdings HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "holdings.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "ClientCode": "A123456"
  }
}

{
  "head": {
    "responseCode": "holdings.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "HoldingDetails": [
      {
        "clientCode": "A123456",
        "exch": "N",
        "exchType": "C",
        "symbol": "RELIANCE",
        "exchShortName": "NSE",
        "avgPrice": 1384.5,
        "quantity": 50,
        "LTP": 1412.2,
        "nseCode": 2885,
        "bseCode": 500325,
        "previousPrice": 1408.0,
        "sortPosition": 1,
        "product": "CNC",
        "isin": "INE002A01018",
        "dpQuantity": 40,
        "t1Quantity": 10,
        "authorizedQuantity": 50
      }
    ],
    "Msg": "Success",
    "status": 0
  }
}

资金与保证金快照

POST /v1/funds/margin openbanking

读取现金、可用保证金、SPAN、抵押品以及 receipts/payments，驱动资金与限额栏。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId。

Clientcode
TotalBalance
avlbMgn
collateralValue
receipts
payments
sPAN
adhoc
marginOnCash
nriCashReceipts
status
msg

POST /v1/funds/margin HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "margin.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "Clientcode": "A123456"
  }
}

{
  "head": {
    "responseCode": "margin.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "TotalBalance": 185000.0,
    "avlbMgn": 142300.5,
    "collateralValue": 62000.0,
    "receipts": 25000.0,
    "payments": 5000.0,
    "sPAN": 18400.0,
    "adhoc": 0.0,
    "marginOnCash": 118500.0,
    "nriCashReceipts": 0.0,
    "nriFOReceipts": 0.0,
    "physcripsNetworth": 0.0,
    "msg": "Success",
    "status": 0
  }
}

可出金额度

POST /v1/funds/payout/eligible openbanking

在下达出金请求之前，返回可提取的卢比金额。

认证方式：请求体中的 Bearer 式 JWT（JWTtoken）来自登录会话，另附 head 中的应用名、版本、操作系统和请求码。

JWTtoken
EligiblePayoutAmount
Msg
status
appName
appVer
requestCode

POST /v1/funds/payout/eligible HTTP/1.1
Content-Type: application/json

{
  "head": {
    "appName": "IIFLMarkets",
    "appVer": "9.0",
    "key": "<session-key>",
    "osName": "Android",
    "requestCode": "eligible-payout.request"
  },
  "body": {
    "JWTtoken": "<jwt-token>"
  }
}

{
  "head": {
    "responseCode": "eligible-payout.response",
    "status": 0,
    "statusDescription": "Success"
  },
  "body": {
    "EligiblePayoutAmount": 118500.0,
    "Msg": "Success",
    "status": 0
  }
}

出金历史

POST /v1/funds/payout/history openbanking

分页返回提现请求，含银行账号、金额、状态和令牌号，供资金历史页面使用。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId。

AccountNo
Bank
ChequeNo
PayoutAmount
PayoutDate
PayoutStatus
Product
RequestAmount
RequestDate
TokenNO

POST /v1/funds/payout/history HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "payout-history.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "ClientCode": "A123456"
  }
}

{
  "head": {
    "responseCode": "payout-history.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "HistoryData": [
      {
        "AccountNo": "50100000000000",
        "Bank": "HDFC BANK",
        "ChequeNo": "",
        "PayoutAmount": 25000,
        "PayoutDate": "2026-10-18",
        "PayoutStatus": "PROCESSED",
        "Product": "EQUITY",
        "RequestAmount": 25000,
        "RequestDate": "2026-10-18",
        "TokenNO": "PO0000000001"
      }
    ],
    "Msg": "Success",
    "status": 0
  }
}

资金转账的已绑定银行账户

POST /v1/funds/banks openbanking

列出已绑定的股票银行账户以及充值/出金页面使用的 UPI 服务商。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId。

EquityBanks
BankName
BankCode
BankAccountNo
NetbankingAllow
IsEquityClient
ALBEquity
ClientCode
UPIVendor

POST /v1/funds/banks HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "fund-banks.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "ClientCode": "A123456"
  }
}

{
  "head": {
    "responseCode": "fund-banks.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "EquityBanks": [
      {
        "BankName": "HDFC BANK",
        "BankCode": "HDFC",
        "BankAccountNo": "50100000000000",
        "NetbankingAllow": "Y"
      }
    ],
    "IsEquityClient": true,
    "ALBEquity": 1,
    "ClientCode": "A123456",
    "Msg": "Success",
    "status": 0,
    "UPIVendor": "<upi-vendor>"
  }
}

下达 GTT 订单

POST /v1/orders/gtt openfinance

下达 good-till-triggered 订单，含买/卖方向、产品、数量以及触发/委托两条腿。

认证方式：请求体中的 Bearer 式 JWT（jWTToken）加上登录的 head 会话。

jWTToken
exchange
gTTBuySell
gTTProduct
scripCode
qty
triggerType
entryPrice
triggerPrice
nestOrderID
appSource
deviceID

POST /v1/orders/gtt HTTP/1.1
Content-Type: application/json

{
  "body": {
    "appSource": "ANDROID",
    "deviceID": "android-device-id",
    "exchange": "NSE",
    "gTTBuySell": "B",
    "gTTProduct": "CNC",
    "jWTToken": "<jwt-token>",
    "publicIP": "203.0.113.25",
    "qty": 10,
    "requestType": "PLACE",
    "scripCode": "2885",
    "triggerType": "SL",
    "nestOrderID": "",
    "leg1": {
      "entryPrice": "1410.00",
      "triggerPrice": "1395.00"
    },
    "leg2": {
      "entryPrice": "0",
      "triggerPrice": "0"
    }
  }
}

{
  "head": {
    "responseCode": "gtt-order.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "status": 0,
    "Msg": "GTT placed",
    "nestOrderID": "250000000001"
  }
}

F&O 与股票头寸

POST /v1/portfolio/positions openfinance

返回未平仓的股票和大宗商品头寸，含买/卖数量、平均价、净数量、已实现盈亏和最新价。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId。

BuySell
DelvIntra
Exch
ExchType
ScripCode
ScripName
Qty
Rate
BuyQty
SellQty
NetQty
BuyAvgRate
BookedPL
LTP
Multiplier

POST /v1/portfolio/positions HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "positions.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "ClientCode": "A123456"
  }
}

{
  "head": {
    "responseCode": "positions.response",
    "status": "0",
    "statusDescription": "Success"
  },
  "body": {
    "TradeData": [
      {
        "BuySell": "B",
        "DelvIntra": "I",
        "Exch": "N",
        "ExchType": "D",
        "Multiplier": 50.0,
        "Qty": 100,
        "Rate": 24850.0,
        "ScripCode": 35000,
        "ScripName": "NIFTY 27OCT26 FUT",
        "BuyQty": 100,
        "SellQty": 0,
        "NetQty": 100,
        "BuyAvgRate": 24850.0,
        "SellAvgRate": 0.0,
        "BuyValue": 124250000.0,
        "SellValue": 0.0,
        "BookedPL": 0,
        "LTP": 24910.5
      }
    ],
    "Message": "Success",
    "Status": 0,
    "TimeStamp": "2026-10-20T11:12:44+05:30"
  }
}

订单历史

POST /v1/orders/book openfinance

返回当日委托簿，含券商/交易所订单号、成交量、状态和拒单原因。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId。

brokerOrderId
exchangeOrderId
orderStatus
tradingSymbol
instrumentId
transactionType
product
orderType
quantity
filledQuantity
pendingQuantity
price
averageTradedPrice
validity
rejectionReason

POST /v1/orders/book HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "order-book.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "ClientCode": "A123456"
  }
}

{
  "status": "0",
  "message": "Success",
  "result": [
    {
      "clientId": "A123456",
      "placedBy": "A123456",
      "brokerOrderId": "250000000001",
      "exchangeOrderId": "110000000001",
      "orderStatus": "COMPLETE",
      "formattedInstrumentName": "RELIANCE",
      "tradingSymbol": "RELIANCE",
      "instrumentId": "2885",
      "exchange": "NSE",
      "transactionType": "BUY",
      "product": "CNC",
      "orderType": "LIMIT",
      "orderComplexity": "REGULAR",
      "quantity": 10,
      "filledQuantity": 10,
      "pendingQuantity": 0,
      "cancelledQuantity": 0,
      "price": 1410.0,
      "averageTradedPrice": 1409.85,
      "orderTime": "2026-10-20T10:14:02+05:30",
      "validity": "DAY",
      "rejectionReason": ""
    }
  ]
}

下达 SMO / 普通订单

POST /v1/brokerage/orders/place openfinance

下达普通或 SMO（smart multi-leg）订单，含标的、方向、产品、数量和限价。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId；请求体中的 clientCode 标识交易账户。

instrumentId
exchange
transactionType
quantity
orderComplexity
product
orderType
price
validity
clientCode
uniqueOrderID
brokerOrderId
orderStatus

POST /v1/brokerage/orders/place HTTP/1.1
Content-Type: application/json

{
  "instrumentId": "2885",
  "exchange": "NSE",
  "transactionType": "BUY",
  "quantity": 10,
  "orderComplexity": "REGULAR",
  "product": "CNC",
  "orderType": "LIMIT",
  "price": 1410.0,
  "validity": "DAY",
  "disclosedQuantity": 0,
  "clientCode": "A123456",
  "deviceId": "android-device-id",
  "uniqueOrderID": "<client-order-id>",
  "apiOrderSource": "ANDROID"
}

{
  "status": "0",
  "message": "Order placed",
  "result": {
    "brokerOrderId": "250000000002",
    "orderStatus": "OPEN",
    "instrumentId": "2885",
    "transactionType": "BUY",
    "quantity": 10,
    "price": 1410.0
  }
}

涨跌幅榜单快照

POST /v1/markets/movers opendata

返回缓存的 NSE/BSE 上涨与下跌榜单行，含最新价、涨跌幅、标的代码和成交量，供行情快照使用。

认证方式：使用登录调用签发的会话键（head.key）和 LoginId；行情面板的调用也接受访客会话。

CacheTime
Gainer
Looser
exch
exchType
fullName
lTP
perChange
scripCode
symbol
volume

POST /v1/markets/movers HTTP/1.1
Content-Type: application/json

{
  "head": {
    "requestCode": "movers.request",
    "key": "<session-key>",
    "appVer": "9.0",
    "appName": "IIFLMarkets",
    "osName": "Android",
    "LoginId": "A123456"
  },
  "body": {
    "exch": "N",
    "exchType": "C"
  }
}

{
  "body": {
    "CacheTime": 15,
    "Gainer": [
      {
        "exch": "N",
        "exchType": "C",
        "fullName": "Reliance Industries Ltd",
        "lTP": 1412.2,
        "perChange": 2.35,
        "scripCode": 2885,
        "symbol": "RELIANCE",
        "volume": 8423110.0
      }
    ],
    "Looser": [
      {
        "exch": "N",
        "exchType": "C",
        "fullName": "Tata Steel Ltd",
        "lTP": 152.4,
        "perChange": -1.82,
        "scripCode": 3499,
        "symbol": "TATASTEEL",
        "volume": 12004500.0
      }
    ],
    "Msg": "Success",
    "status": 0
  }
}

数据类别

余额
持仓
订单
头寸
出金
行情

数据使用场景与案例

夜间 demat 持仓对账
家族办公室的账簿逐只标的拉取 authorizedQuantity、dpQuantity、t1Quantity 和 isin，与托管行文件逐条核对，赶在下一个现货交易时段开始前完成。
RMS 现金与 SPAN 监控
风控台轮询 TotalBalance、avlbMgn、sPAN 和 EligiblePayoutAmount，在已占用的 SPAN 侵蚀可提取的卢比余额之前触发追加保证金通知。
出金运营台账
财务运营把 PayoutAmount、PayoutStatus、TokenNO 和 BankAccountNo 直接写入银行对账文件，无需再从资金页面手工转录提现记录。
订单成交明细带
执行台账存储 brokerOrderId、exchangeOrderId、filledQuantity 和 averageTradedPrice，再叠加持仓快照中的 NetQty / BookedPL。

常见问题

IIFL Markets 数据 API 返回哪些持仓字段？

每条 demat 持仓记录包含 isin、symbol、nseCode、bseCode、avgPrice、quantity、LTP、dpQuantity、t1Quantity、authorizedQuantity 和 product（例如 CNC）——与持仓页面渲染的列一致。

现金、保证金与出金是如何暴露的？

保证金快照返回 TotalBalance、avlbMgn、collateralValue、sPAN 以及 receipts/payments。EligiblePayoutAmount 即可提取的卢比金额；出金历史随后列出 AccountNo、Bank、PayoutAmount、PayoutStatus 和 TokenNO。

接口面除了余额，还覆盖订单和 GTT 吗？

覆盖。下单调用发送 instrumentId、transactionType、quantity、product 和 price，订单流水返回 brokerOrderId、exchangeOrderId、filledQuantity 和 orderStatus。GTT 下单额外携带 triggerType 以及 triggerPrice / entryPrice 两条腿。

会话是如何鉴权的？

登录调用会连同密码和 2PIN 一起发送请求码、appName、appVer、osName 和 LoginId。后续调用复用返回的会话键和 LoginId；在出金和 GTT 场景下，还会携带为该客户签发的 JWT 令牌。

与 IIFL : Stocks, Demat & IPOs 相似的应用

Groww — Groww Invest Tech 是在 SEBI 注册的印度券商和 CDSL 存管参与人，应用覆盖股票、ETF、IPO、期货期权、大宗商品、债券和直销共同基金。
Zerodha Kite — Zerodha 是班加罗尔的 SEBI 注册券商，其 Kite 平台用于投资股票、IPO、衍生品、ETF 和债券，直销共同基金则走 Coin。
Upstox Stocks IPO Mutual Funds — Upstox Securities（RKSV Securities 子公司）是印度线上券商，应用覆盖 NSE、BSE 和 MCX 上的股票、期货期权、大宗商品、外汇、共同基金和 IPO。
Angel One: Stocks, Mutual Fund — Angel One 是 SEBI 注册的印度券商，应用覆盖股票、共同基金、IPO、期货期权、大宗商品和外汇，并有 MCX 商品衍生品会员资格。
5paisa: Demat, Stocks & IPO — 5paisa Capital 是印度折扣券商，平台把证券账户与股票、IPO、共同基金、ETF、大宗商品和期货期权放在一起。
INDmoney: US Stocks, F&O, IPO — INDmoney 是 SEBI 注册的印度券商，应用可交易印度股票、期货期权和 IPO，并覆盖美股与共同基金。
Paytm Money — Paytm Money 是 SEBI 注册的印度券商，财富应用覆盖股票、期货期权、共同基金、ETF、IPO 和国家养老金计划 NPS。
Dhan — Dhan 是 Raise Securities 运营的 SEBI 监管印度交易平台，应用覆盖股票、期货期权、大宗商品、ETF、共同基金和 IPO。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

IIFL Markets 数据 API：持仓、订单与资金

应用截图

API 端点一览

密码加 PIN 登录

demat 持仓快照

资金与保证金快照

可出金额度

出金历史

资金转账的已绑定银行账户

下达 GTT 订单

F&O 与股票头寸

订单历史

下达 SMO / 普通订单

涨跌幅榜单快照

数据类别

数据使用场景与案例

夜间 demat 持仓对账

RMS 现金与 SPAN 监控

出金运营台账

订单成交明细带

常见问题

与 IIFL : Stocks, Demat & IPOs 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

需要集成这个 App 的数据 API？

IIFL Markets 数据 API：持仓、订单与资金

应用截图

API 端点一览

密码加 PIN 登录

demat 持仓快照

资金与保证金快照

可出金额度

出金历史

资金转账的已绑定银行账户

下达 GTT 订单

F&O 与股票头寸

订单历史

下达 SMO / 普通订单

涨跌幅榜单快照

数据类别

数据使用场景与案例

夜间 demat 持仓对账

RMS 现金与 SPAN 监控

出金运营台账

订单成交明细带

常见问题

相关应用

与 IIFL : Stocks, Demat & IPOs 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

需要集成这个 App 的数据 API？