Kotak Neo 数据 API 与字段
Kotak Neo: Stock Trading App 是 Kotak Securities Limited 推出的 Android 交易客户端;这家券商隶属 Kotak Mahindra 集团,受印度证券交易委员会(SEBI)监管。散户投资者和活跃交易者可通过应用内的自助流程,借助 Digilocker 和 Aadhaar 电子签名开立证券托管与交易账户,随后关注 NSE、BSE 和 MCX 的交易品种,从报价页或图表提交普通订单及 Insta Trade 订单,查看证券持仓和期货与期权仓位,运行 SIP-it 股票定投组合,浏览共同基金和正在发行的 IPO,并通过 UPI 或网上银行转入、提取印度卢比。围绕下单界面,应用还提供 Nifty、Bank Nifty、Sensex、黄金、白银及原油的期权链、预设策略模板、支持短线交易模式的 Trade-from-Charts 图表下单功能、跳转 Nest Trader 网页端的入口,以及已发布的 Trade API。该应用仅服务印度市场,与 Groww、Zerodha Kite、Angel One 和 Upstox 争夺股票现货及衍生品交易用户。
Insta Trade 下单界面以 orderId、exchangeOrderId 和 orderStatus 标记订单,并通过 product 区分 CNC、MIS 和 NRML 产品;旁边的资金卡片则分别列出 cashAvailable、collateralValue、spanMargin 及 withdrawableAmount。证券持仓按 ltp 对 quantity 重新估值,同时保留 isin、freeQty、pledgedQty 与 haircut;期货与期权净仓位则由 netQuantity、mtm 和 strikePrice 描述。
Nifty 与 Bank Nifty 期权链在各行权价下补充 openInterest、impliedVolatility 和 delta;SIP-it 定投组合提供 sipAmount 与 mandateStatus;IPO 发行窗口列出 lotSize 和 cutoffPrice;卢比资金操作则使用 razorpayOrderId、upiId、payoutAmount 及 ifsc。这些字段可供投资组合对账、交易前资金检查、衍生品仓位叠加和资金运营使用,openData Studio 将其转化为可调用的开放数据。
应用截图
API 端点一览
请求/响应示例为依据应用界面重构的示意示例,并非实时抓包。
验证登录一次性验证码
POST
/v1/kotak-neo/session/otp-verifyopenbanking完成统一登录的一次性验证码验证步骤,返回 clientId、ucid、accessToken 和 sid,以及该会话允许交易的交易所和 CNC、MIS、NRML 产品。
认证方式: 无需预先认证。使用手机号码和一次性验证码生成后续请求携带的 accessToken 与 sid。
- mobileNumber
- otp
- deviceId
- appVersion
- clientId
- ucid
- displayName
- accessToken
- sid
- tokenExpiry
- exchanges
- products
POST /v1/kotak-neo/session/otp-verify HTTP/1.1 Content-Type: application/json { "mobileNumber": "9876543210", "otp": "482913", "deviceId": "android-a1b2c3", "appVersion": "2.2.86" }{ "status": "OK", "data": { "clientId": "N123456", "ucid": "UCID9001", "displayName": "PRIYA SHARMA", "accessToken": "eyJhbGciOiJIUzI1NiJ9...", "sid": "sid_9f3a", "tokenExpiry": "2026-10-23T18:15:00+05:30", "exchanges": ["NSE", "BSE", "NFO", "MCX"], "products": ["CNC", "MIS", "NRML"] } }资金与 RMS 限额
GET
/v1/kotak-neo/funds/limitsopenbanking读取资金卡片中的现金与抵押品价值、已占用的 SPAN 和敞口保证金、当日可提取的卢比金额,以及当天的入金和出金。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- clientId
- cashAvailable
- collateralValue
- availableMargin
- spanMargin
- exposureMargin
- utilizedMargin
- withdrawableAmount
- payinToday
- payoutToday
- adhocMargin
- mtfUsed
GET /v1/kotak-neo/funds/limits HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "clientId": "N123456", "cashAvailable": 125000.0, "collateralValue": 48000.5, "availableMargin": 152410.25, "spanMargin": 18400.0, "exposureMargin": 6200.5, "utilizedMargin": 24600.5, "withdrawableAmount": 118500.0, "payinToday": 20000.0, "payoutToday": 5000.0, "adhocMargin": 0.0, "mtfUsed": 0.0 } }证券托管账户持仓
GET
/v1/kotak-neo/portfolio/holdingsopenfinance列出持仓页中的证券托管账户持仓,包括 ISIN、可用与已质押数量、按最新成交价重新估值的结果,以及用于计算额外保证金的折扣比例。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- holdings
- tradingSymbol
- isin
- exchange
- nseCode
- quantity
- avgPrice
- ltp
- currentValue
- investedValue
- unrealisedPnl
- pledgedQty
- freeQty
- haircut
- product
- totalCurrentValue
- totalInvestedValue
GET /v1/kotak-neo/portfolio/holdings HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "holdings": [ { "tradingSymbol": "RELIANCE", "isin": "INE002A01018", "exchange": "NSE", "nseCode": "2885", "quantity": 50, "avgPrice": 2460.25, "ltp": 2512.4, "currentValue": 125620.0, "investedValue": 123012.5, "unrealisedPnl": 2607.5, "pledgedQty": 10, "freeQty": 40, "haircut": 12.5, "product": "CNC" } ], "totalCurrentValue": 125620.0, "totalInvestedValue": 123012.5 } }期货与期权仓位
GET
/v1/kotak-neo/portfolio/positionsopenfinance汇总未平仓的期货与期权及股票现货仓位,为仓位页提供买卖均价、盯市损益和已实现损益。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- positions
- tradingSymbol
- exchange
- product
- netQuantity
- buyAvg
- sellAvg
- ltp
- mtm
- realisedPnl
- multiplier
- expiryDate
- optionType
- strikePrice
GET /v1/kotak-neo/portfolio/positions?segment=NFO HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "positions": [ { "tradingSymbol": "NIFTY25OCT24500CE", "exchange": "NFO", "product": "NRML", "netQuantity": 75, "buyAvg": 142.5, "sellAvg": 0.0, "ltp": 156.2, "mtm": 1027.5, "realisedPnl": 0.0, "multiplier": 75, "expiryDate": "2025-10-30", "optionType": "CE", "strikePrice": 24500.0 } ] } }提交 Insta Trade 订单
POST
/v1/kotak-neo/orders/placeopenfinance从报价页或 Trade-from-Charts 短线交易面板提交普通订单或 Insta Trade 订单,并返回 orderId 与 exchangeOrderId。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- tradingSymbol
- exchange
- transactionType
- orderType
- product
- quantity
- price
- validity
- variety
- disclosedQuantity
- orderId
- exchangeOrderId
- orderStatus
- placedAt
POST /v1/kotak-neo/orders/place HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a Content-Type: application/json { "tradingSymbol": "RELIANCE", "exchange": "NSE", "transactionType": "BUY", "orderType": "LIMIT", "product": "CNC", "quantity": 10, "price": 2510.0, "validity": "DAY", "variety": "INSTA_TRADE", "disclosedQuantity": 0 }{ "status": "OK", "data": { "orderId": "2510230001842", "exchangeOrderId": "1100000012345678", "tradingSymbol": "RELIANCE", "exchange": "NSE", "transactionType": "BUY", "orderType": "LIMIT", "product": "CNC", "quantity": 10, "price": 2510.0, "orderStatus": "OPEN", "variety": "INSTA_TRADE", "placedAt": "2026-10-23T10:16:04+05:30" } }订单簿
GET
/v1/kotak-neo/ordersopenfinance为订单页分页列出待成交、已成交、部分成交及被拒绝的订单,包括 pendingQuantity 与 rejectionReason。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- orders
- orderId
- exchangeOrderId
- tradingSymbol
- exchange
- transactionType
- product
- quantity
- filledQuantity
- pendingQuantity
- price
- averagePrice
- orderStatus
- variety
- rejectionReason
GET /v1/kotak-neo/orders?status=OPEN HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "orders": [ { "orderId": "2510230001842", "exchangeOrderId": "1100000012345678", "tradingSymbol": "RELIANCE", "exchange": "NSE", "transactionType": "BUY", "product": "CNC", "quantity": 10, "filledQuantity": 0, "pendingQuantity": 10, "price": 2510.0, "averagePrice": 0.0, "orderStatus": "OPEN", "variety": "INSTA_TRADE", "rejectionReason": "" } ] } }期权链
GET
/v1/kotak-neo/quotes/option-chainopendata返回指定到期日的 CE、PE 看涨与看跌期权阶梯,包含行权价、最新成交价、未平仓合约量、隐含波动率及希腊值,供期权链面板与预设策略模板使用。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- underlying
- spotPrice
- expiryDate
- rows
- strikePrice
- tradingSymbol
- ltp
- openInterest
- impliedVolatility
- delta
- bidPrice
- askPrice
GET /v1/kotak-neo/quotes/option-chain?underlying=NIFTY&expiry=2025-10-30 HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "underlying": "NIFTY", "spotPrice": 24810.4, "expiryDate": "2025-10-30", "rows": [ { "strikePrice": 24500.0, "ce": { "tradingSymbol": "NIFTY25OCT24500CE", "ltp": 156.2, "openInterest": 1842000, "impliedVolatility": 12.4, "delta": 0.62, "bidPrice": 155.8, "askPrice": 156.6 }, "pe": { "tradingSymbol": "NIFTY25OCT24500PE", "ltp": 48.1, "openInterest": 992000, "impliedVolatility": 13.1, "delta": -0.38, "bidPrice": 47.8, "askPrice": 48.4 } } ] } }自选列表交易品种
GET
/v1/kotak-neo/watchlists/{watchlistId}opendata加载指定名称的自选列表,包含最新价格、涨跌幅及可选的价格提醒阈值,为首页报价栏提供数据。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- watchlistId
- name
- scrips
- tradingSymbol
- exchange
- nseCode
- ltp
- changePercent
- volume
- priceAlert
- enabled
- targetPrice
GET /v1/kotak-neo/watchlists/wl_default HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "watchlistId": "wl_default", "name": "My Watchlist", "scrips": [ { "tradingSymbol": "RELIANCE", "exchange": "NSE", "nseCode": "2885", "ltp": 2512.4, "changePercent": 1.12, "volume": 4821000, "priceAlert": { "enabled": true, "targetPrice": 2550.0 } } ] } }正在发行的 IPO
GET
/v1/kotak-neo/ipo/issuesopenfinance列出正在开放申购的 IPO,提供每手数量、申购价格区间和最终发行价,供 IPO 提示界面收集使用 UPI 虚拟支付地址的申购请求。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- issues
- symbol
- companyName
- isin
- lotSize
- minBidPrice
- maxBidPrice
- cutoffPrice
- category
- openDate
- closeDate
- upiVpaRequired
GET /v1/kotak-neo/ipo/issues?status=OPEN HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "issues": [ { "symbol": "NEOBANK", "companyName": "Neo Bank Limited", "isin": "INE0IPO01011", "lotSize": 40, "minBidPrice": 95.0, "maxBidPrice": 100.0, "cutoffPrice": 100.0, "category": "RETAIL", "openDate": "2026-10-20", "closeDate": "2026-10-24", "upiVpaRequired": true } ] } }SIP-it 投资组合
GET
/v1/kotak-neo/sipit/portfolioopenfinance返回 SIP-it 股票及 ETF 定投组合,包含 sipAmount、扣款授权状态及按市价计算的 currentValue,供 SIP-it 总览页使用。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- baskets
- basketId
- name
- sipAmount
- frequency
- nextSipDate
- investedValue
- currentValue
- units
- status
- mandateStatus
- totalCurrentValue
GET /v1/kotak-neo/sipit/portfolio HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a{ "status": "OK", "data": { "baskets": [ { "basketId": "sip_eq_core", "name": "Equity Core", "sipAmount": 5000.0, "frequency": "MONTHLY", "nextSipDate": "2026-11-05", "investedValue": 45000.0, "currentValue": 47210.5, "units": 182.4, "status": "ACTIVE", "mandateStatus": "ACTIVE" } ], "totalCurrentValue": 47210.5 } }UPI 即时入金
POST
/v1/kotak-neo/funds/payinopenbanking通过 UPI 发起卢比即时入金,使用 Razorpay 收银台及 Juspay HyperUPI,并在账簿入账后返回 razorpayOrderId。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- amountPaise
- currency
- paymentMethod
- upiId
- emailId
- phoneNo
- razorpayOrderId
- paymentId
- ledgerCreditStatus
- cashAvailableAfter
POST /v1/kotak-neo/funds/payin HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a Content-Type: application/json { "amountPaise": 2500000, "currency": "INR", "paymentMethod": "UPI", "upiId": "priya@okaxis", "emailId": "[email protected]", "phoneNo": "9876543210" }{ "status": "OK", "data": { "razorpayOrderId": "order_Dd3Wbag7QXDuuL", "amountPaise": 2500000, "currency": "INR", "paymentId": "pay_9f3a", "upiId": "priya@okaxis", "ledgerCreditStatus": "SUCCESS", "cashAvailableAfter": 150000.0 } }即时出金
POST
/v1/kotak-neo/funds/payoutopenbanking从即时出金面板申请将可提取的印度卢比即时转至已关联的银行账户。
认证方式: 使用一次性验证码验证后获得的 accessToken 作为 Bearer 令牌,并附上 sid。
- payoutAmount
- bankName
- accountNumber
- ifsc
- payoutId
- payoutStatus
- withdrawableAmountAfter
POST /v1/kotak-neo/funds/payout HTTP/1.1 Authorization: Bearer <accessToken> Sid: sid_9f3a Content-Type: application/json { "payoutAmount": 25000.0, "bankName": "HDFC BANK", "accountNumber": "50100012345678", "ifsc": "HDFC0000123" }{ "status": "OK", "data": { "payoutId": "po_25102388", "payoutAmount": 25000.0, "bankName": "HDFC BANK", "accountNumber": "50100012345678", "ifsc": "HDFC0000123", "payoutStatus": "REQUESTED", "withdrawableAmountAfter": 93500.0 } }
数据类别
- 会话令牌
- RMS 资金与保证金
- 证券托管账户持仓
- 期货与期权仓位
- Insta Trade 订单
- 期权链
- 自选列表
- IPO 发行项目
- SIP-it 定投组合
- UPI 入金
- 印度卢比出金
数据使用场景与案例
证券持仓与 RMS 资金夜间对账
家族办公室将持仓中的 isin、quantity、avgPrice 和 currentValue 与托管机构文件逐项匹配,再核对 availableMargin、spanMargin 及 withdrawableAmount,以便在股票现货市场开盘前发现 pledgedQty 对应的质押折扣变化。
Insta Trade 下单前资金检查
交易执行机器人读取 availableMargin 和 utilizedMargin,仅在 cashAvailable 足以覆盖所选 CNC、MIS 或 NRML 产品的 quantity 乘以 price 时,才提交类型为 INSTA_TRADE 的 LIMIT 限价订单。
Nifty 期权链与仓位叠加
衍生品交易团队读取 NIFTY、BANKNIFTY 各到期日的 strikePrice、openInterest、impliedVolatility 和 delta,再把仓位接口的 netQuantity 与 mtm 叠加到同一行权价阶梯中。
SIP-it 定投与卢比资金运营
运营团队按 basketId 列出 sipAmount 和 mandateStatus,依据入金记录的 razorpayOrderId 登记账簿入账,并在 withdrawableAmount 允许时,将 payoutAmount 转至已关联的 ifsc 和 accountNumber。
常见问题
Kotak Neo 如何验证交易请求的身份?
统一登录流程先验证手机一次性验证码,再返回 accessToken、sid、clientId 和 ucid,以及该会话允许交易的交易所和 CNC、MIS、NRML 产品。后续资金、持仓、Insta Trade 和出金请求使用 Bearer 方式携带 accessToken,并附上 sid 请求头。
哪些字段描述资金、证券持仓和交易仓位?
资金限额快照区分 cashAvailable、collateralValue、availableMargin、spanMargin、exposureMargin 和 withdrawableAmount。证券持仓返回 isin、quantity、avgPrice、ltp、freeQty、pledgedQty 与 haircut。期货与期权净仓位则包含 netQuantity、buyAvg、mtm、strikePrice 和 optionType。
能读取 Insta Trade 订单和 Nifty 期权链吗?
可以。下单接口针对 variety 为 INSTA_TRADE 的订单返回 orderId、exchangeOrderId 和 orderStatus;订单簿分页列出 pendingQuantity 与 rejectionReason。期权链接口返回 strikePrice、ltp、openInterest、impliedVolatility 和 delta,涵盖 NIFTY、BANKNIFTY、SENSEX、黄金及原油等标的。
SIP-it 组合、IPO 申购和卢比出金分别包含哪些信息?
SIP-it 列出 basketId、sipAmount、frequency 与 mandateStatus。正在发行的 IPO 提供 lotSize、minBidPrice、cutoffPrice 和 upiVpaRequired。即时入金返回与 upiId 对应的 razorpayOrderId;即时出金则将 payoutAmount 转至由 bankName、accountNumber 和 ifsc 指定的银行账户。
与 Kotak Neo: Stock Trading App 相似的应用
- Groww — Groww 是印度 SEBI 注册券商 Groww Invest Tech 的投资应用,投资者可线上开立无纸化证券托管与交易账户,买卖 NSE/BSE 股票、ETF 和 IPO,在终端做期货期权,并以一次性或定投方式购买直销共同基金。
- Zerodha Kite — Kite 是 Zerodha 面向印度市场的投资交易平台,覆盖股票、IPO、期货期权、商品和外汇,并配合 Coin 直销共同基金以及用于下单与行情的 Kite Connect HTTP 接口。
- Angel One: Stocks, Mutual Fund — Angel One Limited 是 SEBI 注册的印度零售券商(注册号 INZ000161534),也是 NSE、BSE、MSEI、MCX 和 NCDEX 会员,应用内可交易股票、共同基金与定投、期货期权、IPO 和商品。
- Upstox Stocks IPO Mutual Funds — Upstox 是印度线上券商(Upstox Securities,SEBI 注册号 INZ000315837,NSE/BSE/MCX 会员),提供证券托管与交易账户,用于股票、共同基金、IPO、期货、期权、商品和外汇。
- ICICI Direct-Stocks F&O MF IPO — ICICIdirect.com 是 ICICI Securities 的零售交易与投资平台,把证券托管或三合一账户与股票、日内交易、期货期权、IPO、共同基金、商品、ETF 和债券放在一起。
- 5paisa: Demat, Stocks & IPO — 5paisa Capital 是 SEBI 注册的印度折扣券商(注册号 INZ000010231),应用内可开立证券托管账户,投资股票、直销共同基金与定投、IPO、ETF,并交易期货期权、商品和融资融券。
- IIFL : Stocks, Demat & IPOs — IIFL Capital Services 是 SEBI 注册的印度券商(注册号 INZ000164132),其证券托管账户覆盖股票、共同基金、IPO、期货期权、商品、外汇和美股。
- INDmoney: US Stocks, F&O, IPO — INDmoney 是印度投资应用(INDstocks Private Limited,SEBI 注册券商及 NSE/BSE/MCX 会员),可在同一账户交易印度与美国股票、共同基金、期货期权、IPO、商品和 ETF。
相关主题
- Kotak Neo API
- Kotak Neo 证券持仓
- Kotak Neo Insta Trade
- spanMargin 与 availableMargin
- Nifty 期权链 openInterest
- SIP-it 定投 sipAmount
- Kotak Neo IPO lotSize
- razorpayOrderId 与 upiId
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业