ICICI Direct 数据 API：持仓与订单

ICICI Securities Limited · 银行

ICICI Direct-Stocks F&O MF IPO 是 ICICI Securities Limited 的 Android 版 iDirect Super 客户端；ICICI Securities 是 ICICI 集团旗下的 NSE/BSE/MCX 券商（CIN L67120MH1995PLC086241）。散户投资者与活跃交易者通过应用内流程（PAN、Aadhaar、Digilocker、NSDL e-sign）开立三合一交易加 demat 账户，之后可在自定义自选列表中查看 NSE/BSE 证券，下达普通单、篮子单、Flash Trade 与 Cloud Order 委托，跟踪现货持仓与 F&O 头寸，运行股票 SIP、Smart SIP 与 Freedom SIP，浏览共同基金、NFO、在售 IPO 与 OFS，充值或提取卢比，并把持仓质押为 Share-as-Margin。围绕这块下单面板的还有 Easy Options、MultiPie、一键组合、全球投资、NPS、REITs/InvITs、SGBs、定期存款、保险，以及 Breeze、smallcase、Streak 等关联应用。产品仅在印度运营——这是一家受 SEBI 监管的全方位服务券商，与 Groww、Zerodha Kite、Angel One、Upstox 和 Kotak Neo 争夺同一批现货与衍生品用户。

Nifty 50 在自选列表记录中对应 stockCode 26000 与 exchange N，并带有 ltp、changePercent 和 volume；行情记录还提供 open、high、low、close、bidPrice 与 askPrice。Demat 持仓把 quantity、averagePrice 与已质押的 collateralQty、投入金额和当前市值放在一起。F&O 头寸记录补充 expiryDate、netQty、product 和 unrealisedMtm；订单与成交簿则区分 orderId 和 exchangeOrderId，并记录 CNC、MIS、NRML 委托的 filledQty、pendingQty 与 orderStatus。

RMS 资金记录分别列出 cashBalance、availableMargin、utilizedMargin 和 withdrawableAmount。Share-as-Margin 记录以 freeQty、pledgedQty、haircutPercent、collateralValue 与 ddpiEnabled 补充这些余额。SIP 条目通过 folioNumber 和 schemeName 关联 sipAmount、units、status 及 nextSipDate；IPO 发行记录提供 minPrice、maxPrice、lotSize、openDate、closeDate 与 upiMandateSupported。净资产快照汇总股票、F&O 盯市损益、共同基金、ETF、NPS 和现金，并以 netWorth、asOf 标明总额与时点。

家族办公室与 PMS 对账工具可将持仓及 RMS 余额与托管文件核对；交易执行台可用订单号和交易所订单号匹配自身成交。财富管理工具可监控 SIP 计划和 IPO 发行窗口，衍生品看板则可结合可用保证金跟踪质押担保品。openData Studio 将这些持仓、订单、投资计划与担保品记录转为可调用的开放数据，供上述系统集成使用。

应用截图

API 端点一览

请求/响应示例为依据应用界面重构的示意示例，并非实时抓包。

验证登录 OTP 与 PIN

POST /v1/session/otp-verify openbanking

完成 iDirect 登录（密码 + OTP + 交易 PIN），返回 clientCode、sessionToken、当日允许的交易所以及 CNC/MIS/NRML 产品。

认证方式：无。登录 ID、密码、短信 OTP 与交易 PIN 共同换取会话令牌，后续调用均需携带。

loginId
otp
tradingPin
deviceId
appVersion
clientCode
displayName
sessionToken
tokenExpiry
exchanges
products
dematAccount
pinRegistered

POST /v1/session/otp-verify HTTP/1.1
Content-Type: application/json

{
  "loginId": "ICICI1234",
  "password": "********",
  "otp": "482913",
  "tradingPin": "2580",
  "deviceId": "android-a1b2c3",
  "appVersion": "1.3.138"
}

{
  "status": "OK",
  "data": {
    "clientCode": "12345678",
    "loginId": "ICICI1234",
    "displayName": "PRIYA SHARMA",
    "sessionToken": "eyJhbGciOiJIUzI1NiJ9...",
    "tokenExpiry": "2026-10-26T15:30:00+05:30",
    "exchanges": ["NSE", "BSE", "NFO", "MCX", "CDS"],
    "products": ["CNC", "MIS", "NRML"],
    "dematAccount": "IN301549-12345678",
    "pinRegistered": true
  }
}

资金与 RMS 额度

GET /v1/funds/statement openbanking

读取资金报表 / 保证金明细卡：现金与抵押品对比、已用 SPAN 与 exposure、可提取卢比以及 Share-as-Margin 价值。

认证方式：来自 OTP + PIN 验证的会话令牌。

clientCode
cashBalance
collateralValue
availableMargin
utilizedMargin
spanMargin
exposureMargin
withdrawableAmount
adhocMargin
shareAsMarginValue
ledgerBalance

GET /v1/funds/statement HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "clientCode": "12345678",
    "cashBalance": 125000.0,
    "collateralValue": 48000.5,
    "availableMargin": 152410.25,
    "utilizedMargin": 24600.5,
    "spanMargin": 18400.0,
    "exposureMargin": 6200.5,
    "withdrawableAmount": 118500.0,
    "adhocMargin": 0.0,
    "shareAsMarginValue": 32000.0,
    "ledgerBalance": 125000.0
  }
}

demat 持仓

GET /v1/portfolio/holdings openfinance

列出持仓页中的现货 demat 持仓：stockCode、quantity 与已质押的 collateralQty、averagePrice、LTP 以及投入价值与当前价值对比。

认证方式：来自 OTP + PIN 验证的会话令牌。

stockCode
stockName
exchange
isin
quantity
availableQty
collateralQty
averagePrice
ltp
investedValue
currentValue
unrealisedPnl
totalInvestedValue
totalCurrentValue

GET /v1/portfolio/holdings?segment=EQ HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "holdings": [
      {
        "stockCode": 2885,
        "stockName": "RELIANCE",
        "exchange": "N",
        "isin": "INE002A01018",
        "quantity": 50,
        "availableQty": 40,
        "collateralQty": 10,
        "averagePrice": 2460.25,
        "ltp": 2512.4,
        "investedValue": 123012.5,
        "currentValue": 125620.0,
        "unrealisedPnl": 2607.5
      }
    ],
    "totalInvestedValue": 123012.5,
    "totalCurrentValue": 125620.0
  }
}

F&O 未平仓头寸

GET /v1/portfolio/positions openfinance

列出 F&O（期货与期权）未平仓头寸：netQty、averagePrice、MTM 与 product（MIS/NRML），包含股票期货是否可转为交割的资格。

认证方式：来自 OTP + PIN 验证的会话令牌。

stockCode
stockName
exchange
instrumentType
expiryDate
strikePrice
optionType
buyQty
sellQty
netQty
averagePrice
ltp
unrealisedMtm
product
convertToDeliveryEligible

GET /v1/portfolio/positions?segment=FO HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "positions": [
      {
        "stockCode": 26009,
        "stockName": "Nifty Bank",
        "exchange": "N",
        "instrumentType": "FUTIDX",
        "expiryDate": "2026-10-29",
        "strikePrice": 0,
        "optionType": "",
        "buyQty": 15,
        "sellQty": 0,
        "netQty": 15,
        "averagePrice": 51240.5,
        "ltp": 51410.0,
        "unrealisedMtm": 2542.5,
        "product": "NRML",
        "convertToDeliveryEligible": false
      }
    ]
  }
}

订单簿与成交簿

GET /v1/orders openfinance

分页返回当日订单簿与成交簿：orderId 与 exchangeOrderId、成交与未成交数量、LIMIT/MARKET 类型，以及 COMPLETE/OPEN/CANCELLED 状态。

认证方式：来自 OTP + PIN 验证的会话令牌。

orderId
exchangeOrderId
stockCode
stockName
exchange
product
orderType
transactionType
quantity
filledQty
pendingQty
price
averagePrice
orderStatus
orderTime

GET /v1/orders?book=order&status=ALL HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "orders": [
      {
        "orderId": "240102000123456",
        "exchangeOrderId": "1100000000123456",
        "stockCode": 2885,
        "stockName": "RELIANCE",
        "exchange": "N",
        "product": "CNC",
        "orderType": "LIMIT",
        "transactionType": "BUY",
        "quantity": 10,
        "filledQty": 10,
        "pendingQty": 0,
        "price": 2510.0,
        "averagePrice": 2508.35,
        "orderStatus": "COMPLETE",
        "orderTime": "2026-10-26T09:21:14+05:30"
      }
    ]
  }
}

下达现货或 F&O 委托

POST /v1/orders openfinance

提交普通单、Flash Trade、Cloud Order 或篮子委托，返回 orderId、exchangeOrderId 以及 RMS 冻结的保证金。

认证方式：来自 OTP + PIN 验证的会话令牌。

stockCode
exchange
transactionType
product
orderType
quantity
price
disclosedQty
validity
source
orderId
exchangeOrderId
orderStatus
requiredMargin

POST /v1/orders HTTP/1.1
Authorization: Bearer <sessionToken>
Content-Type: application/json

{
  "stockCode": 2885,
  "exchange": "N",
  "transactionType": "BUY",
  "product": "CNC",
  "orderType": "LIMIT",
  "quantity": 10,
  "price": 2510.0,
  "disclosedQty": 0,
  "validity": "DAY",
  "source": "FLASH_TRADE"
}

{
  "status": "OK",
  "data": {
    "orderId": "240102000123456",
    "exchangeOrderId": "1100000000123456",
    "orderStatus": "OPEN",
    "message": "Order placed",
    "requiredMargin": 25100.0
  }
}

自选列表证券

GET /v1/watchlists/{watchlistId} opendata

返回按 stockCode 为键的命名自选列表（交易所 N 上 Nifty 50 = 26000，Nifty Bank = 26009），含最新价、涨跌幅与成交量。

认证方式：来自 OTP + PIN 验证的会话令牌。

watchlistId
watchlistName
scrips
stockName
exchange
stockCode
ltp
changePercent
volume

GET /v1/watchlists/default HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "watchlistId": "default",
    "watchlistName": "My Watchlist",
    "scrips": [
      {
        "stockName": "Nifty 50",
        "exchange": "N",
        "stockCode": 26000,
        "ltp": 24810.35,
        "changePercent": 0.42,
        "volume": 184320110
      },
      {
        "stockName": "Nifty Bank",
        "exchange": "N",
        "stockCode": 26009,
        "ltp": 51240.1,
        "changePercent": -0.18,
        "volume": 98211045
      }
    ]
  }
}

按 stockCode 查询行情

GET /v1/quotes/{stockCode} opendata

读取某证券的 Get Quote 面板：OHLC、LTP、买卖报价与 52 周区间，均以 stockCode 为键。

认证方式：来自 OTP + PIN 验证的会话令牌。

stockCode
stockName
exchange
ltp
open
high
low
close
volume
bidPrice
askPrice
yearHigh
yearLow

GET /v1/quotes/2885?exchange=N HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "stockCode": 2885,
    "stockName": "RELIANCE",
    "exchange": "N",
    "ltp": 2512.4,
    "open": 2498.0,
    "high": 2524.7,
    "low": 2491.15,
    "close": 2501.8,
    "volume": 6845210,
    "bidPrice": 2512.2,
    "askPrice": 2512.45,
    "yearHigh": 2856.0,
    "yearLow": 2191.4
  }
}

共同基金 SIP 簿

GET /v1/mf/sip-book openfinance

列出生效中、已暂停和已取消的共同基金 SIP（含 Smart SIP / Freedom SIP），带 folioNumber、sipAmount、份额、净值与下次扣款日。

认证方式：来自 OTP + PIN 验证的会话令牌。

sipId
folioNumber
schemeName
schemeCode
sipAmount
sipDate
frequency
units
nav
currentValue
status
nextSipDate

GET /v1/mf/sip-book HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "sips": [
      {
        "sipId": "SIP900112",
        "folioNumber": "1234567890",
        "schemeName": "ICICI Prudential Bluechip Fund - Direct Growth",
        "schemeCode": "INF109K01Y64",
        "sipAmount": 5000.0,
        "sipDate": 5,
        "frequency": "MONTHLY",
        "units": 142.335,
        "nav": 98.12,
        "currentValue": 13965.9,
        "status": "ACTIVE",
        "nextSipDate": "2026-11-05"
      }
    ]
  }
}

在售 IPO 发行

GET /v1/ipo/issues openfinance

列出在售的主板与 SME IPO（及 OFS），含价格区间、每手数量、开放/截止日期，以及是否接受 UPI 授权申购。

认证方式：来自 OTP + PIN 验证的会话令牌。

issueId
issueName
symbol
minPrice
maxPrice
lotSize
issueSizeCr
openDate
closeDate
category
upiMandateSupported

GET /v1/ipo/issues?status=OPEN HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "issues": [
      {
        "issueId": "IPO20261001",
        "issueName": "Example Industries Ltd",
        "symbol": "EXIND",
        "minPrice": 220.0,
        "maxPrice": 232.0,
        "lotSize": 60,
        "issueSizeCr": 2400.0,
        "openDate": "2026-10-21",
        "closeDate": "2026-10-23",
        "category": "MAINBOARD",
        "upiMandateSupported": true
      }
    ]
  }
}

Share-as-Margin 质押资格

GET /v1/margin/pledge-eligibility openfinance

返回哪些持仓可质押为 Share-as-Margin：可用与已质押数量、折扣率、抵押价值，以及 DDPI 是否已启用。

认证方式：来自 OTP + PIN 验证的会话令牌。

stockCode
stockName
isin
freeQty
pledgedQty
haircutPercent
collateralValue
eligibleToPledge
totalCollateralValue
ddpiEnabled

GET /v1/margin/pledge-eligibility HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "scrips": [
      {
        "stockCode": 2885,
        "stockName": "RELIANCE",
        "isin": "INE002A01018",
        "freeQty": 40,
        "pledgedQty": 10,
        "haircutPercent": 12.5,
        "collateralValue": 21983.5,
        "eligibleToPledge": true
      }
    ],
    "totalCollateralValue": 32000.0,
    "ddpiEnabled": true
  }
}

净资产快照

GET /v1/portfolio/networth openfinance

把股票、F&O MTM、共同基金、ETF、NPS 与现金汇总为组合首页上的单一 My Networth 数值。

认证方式：来自 OTP + PIN 验证的会话令牌。

netWorth
equityValue
fnoMtm
mfValue
etfValue
npsValue
cashBalance
asOf

GET /v1/portfolio/networth HTTP/1.1
Authorization: Bearer <sessionToken>

{
  "status": "OK",
  "data": {
    "netWorth": 1854320.75,
    "equityValue": 125620.0,
    "fnoMtm": 2542.5,
    "mfValue": 412330.1,
    "etfValue": 22110.0,
    "npsValue": 88000.0,
    "cashBalance": 125000.0,
    "asOf": "2026-10-26T15:30:00+05:30"
  }
}

数据类别

会话令牌
RMS 资金与保证金
demat 持仓
F&O 头寸
订单与成交簿
自选列表
证券行情
共同基金 SIP 簿
IPO 发行
Share-as-Margin 质押
净资产

数据使用场景与案例

每晚持仓与 RMS 对账
家族办公室或 PMS 团队拉取 demat 持仓（stockCode、quantity、averagePrice、collateralQty）以及 cashBalance / availableMargin，并在下一个现货交易时段前与托管文件核对。
OMS 成交与 iDirect 订单簿比对
执行台把自家成交与 iDirect 订单簿和成交簿上的 orderId / exchangeOrderId / filledQty / orderStatus 对照，避免 CNC 与 MIS 委托隔夜出现偏差。
SIP 与 IPO 授权监控
财富管理系统监控 SIP 簿上的 folioNumber / nextSipDate / sipAmount，以及在售 IPO 的 lotSize / maxPrice 价格区间，避免错过 UPI 授权与 NFO 窗口。
F&O 质押余量
衍生品叠加策略在滚动 Bank Nifty / Nifty 期货前读取 pledgedQty、haircutPercent 和 availableMargin，让 Share-as-Margin 抵押品在 SPAN 之前补足。

常见问题

ICICI Direct 涵盖哪些数据，是否需要登录？

文档中的账户数据包括资金（cashBalance、availableMargin、withdrawableAmount）、demat 持仓（stockCode、quantity）、F&O 头寸（netQty、unrealisedMtm）以及订单与成交簿（orderId、filledQty、orderStatus），还涵盖自选列表、行情、SIP 计划、IPO 发行、质押资格和净资产。认证说明列出了登录 ID、密码、短信 OTP 与交易 PIN，后续调用使用会话令牌。

stockCode 和 exchange 如何标识证券？

自选列表示例中，Nifty 50 的 stockCode 为 26000，Nifty Bank 为 26009，两者的 exchange 均为 N。持仓、行情和订单记录也包含 stockCode 与 exchange，集成系统可据此匹配不同记录中的证券。

共同基金 SIP 和 IPO 具体有哪些字段？

SIP 簿包含共同基金计划的 folioNumber、schemeName、sipAmount、units、status 与 nextSipDate，涵盖 Smart SIP 和 Freedom SIP。IPO 发行记录为所列主板、SME 和 OFS 项目提供 minPrice、maxPrice、lotSize、openDate、closeDate 与 upiMandateSupported。这些 IPO 字段描述发行项目，并非客户已提交的申购或获配结果。

Share-as-Margin 数据如何支持担保品检查？

质押资格记录列出 isin、freeQty、pledgedQty、haircutPercent、collateralValue 和 eligibleToPledge，并包含 ddpiEnabled。集成系统可结合资金数据中的 availableMargin 与 utilizedMargin，监控已质押担保品和可用保证金额度。

与 ICICI Direct-Stocks F&O MF IPO 相似的应用

Groww — Groww 是印度线上投资平台（Groww Invest Tech，SEBI 注册号 INZ000301838），可无纸化开立证券账户，买卖 NSE/BSE 股票、ETF 与 IPO，并做期货期权和直销共同基金。
Zerodha Kite — Zerodha Broking（SEBI 注册号 INZ000031633）是印度折扣券商，其 Kite 平台覆盖股票、IPO、期货期权、ETF 和债券，直销共同基金则通过 Coin 购买。
Angel One: Stocks, Mutual Fund — Angel One 是印度券商应用与网页平台，可交易股票、共同基金定投、IPO、衍生品、大宗商品以及美股。
Upstox Stocks IPO Mutual Funds — Upstox 是印度线上券商，提供证券托管与交易账户，覆盖股票、共同基金、IPO、期货期权、大宗商品和外汇。
Kotak Neo: Stock Trading App — Kotak Neo 是 Kotak Securities 面向印度零售投资者的平台，覆盖股票、期货期权、共同基金、IPO、ETF 和大宗商品，并提供个人与 NRI 证券账户。
5paisa: Demat, Stocks & IPO — 5paisa 是在 SEBI 注册的印度折扣券商，应用可开立证券账户，买卖股票、IPO、ETF、共同基金、衍生品和大宗商品。
INDmoney: US Stocks, F&O, IPO — INDmoney 是印度交易与投资应用，在同一平台覆盖印度和美国股票、期货期权、IPO、共同基金、ETF 和大宗商品。

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

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

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

获取报价

ICICI Direct 数据 API：持仓与订单

应用截图

API 端点一览

验证登录 OTP 与 PIN

资金与 RMS 额度

demat 持仓

F&O 未平仓头寸

订单簿与成交簿

下达现货或 F&O 委托

自选列表证券

按 stockCode 查询行情

共同基金 SIP 簿

在售 IPO 发行

Share-as-Margin 质押资格

净资产快照

数据类别

数据使用场景与案例

每晚持仓与 RMS 对账

OMS 成交与 iDirect 订单簿比对

SIP 与 IPO 授权监控

F&O 质押余量

常见问题

与 ICICI Direct-Stocks F&O MF IPO 相似的应用

更多银行类应用

Ajaib: Stock, Crypto, US Stock

Albert: Budgeting and Banking

AndroMoney

Atlas - Rewards Credit Card

相关主题

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

ICICI Direct 数据 API：持仓与订单

应用截图

API 端点一览

验证登录 OTP 与 PIN

资金与 RMS 额度

demat 持仓

F&O 未平仓头寸

订单簿与成交簿

下达现货或 F&O 委托

自选列表证券

按 stockCode 查询行情

共同基金 SIP 簿

在售 IPO 发行

Share-as-Margin 质押资格

净资产快照

数据类别

数据使用场景与案例

每晚持仓与 RMS 对账

OMS 成交与 iDirect 订单簿比对

SIP 与 IPO 授权监控

F&O 质押余量

常见问题

相关应用

与 ICICI Direct-Stocks F&O MF IPO 相似的应用

更多银行类应用

Ajaib: Stock, Crypto, US Stock

Albert: Budgeting and Banking

AndroMoney

Atlas - Rewards Credit Card

相关主题

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