Upstox 数据 API：持仓与保证金

Upstox · 银行

Upstox Stocks IPO Mutual Funds 是印度折扣券商 Upstox（RKSV Securities India Private Limited）的安卓交易客户端。散户与短线交易者开立证券账户加交易账户后，盯 NSE/BSE/MCX 合约、下普通/篮子/GTT 类委托、查看持仓与期货期权头寸、做股票定投、浏览共同基金与在售 IPO，用 UPI、Google Pay 与网银出入金，并把持股质押换保证金。K 线、期权链、融资融券（MTF）、CDSL eDIS、UpLearn 课程和资金钱包都围着同一下单板。应用只服务印度——SEBI 监管券商，与 Groww、Zerodha Kite、Angel One、5paisa 争夺同一批现金股票与衍生品用户。

SEC 与 COM 现金桶把 availableToTrade.total 钉在资金卡上的 spanExposure、cashMargin 与 availableToWithdraw 旁边。证券账户行再盖上 instrumentKey、netAvgPrice、cncUsedQty 与 collateralQty，并带质押单据要读的 haircut。

净值行把 internalValue 与 externalInvestedValue 拆开；共同基金手数补上 xirr、currNav 与 units；在售 IPO 卡带着 ipoRefId、isin 与 totalSubscription；UPI 入金落成 txnid / customerRefId / status，NEFT 出金保留 withdrawalId 与 paymentMode。后台对账、资本利得表与 IPO 申购监控消费这些字段——openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

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

资金与交易限额

POST /v1/account/funds/snapshot openbanking

读取资金页按 SEC（证券）与 COM（商品）分桶的快照：可交易现金、SPAN/现金/MTF 已用保证金、含入金/出金的开盘现金，以及可提现卢比。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

SEC
COM
cash
collateral
availableToWithdraw
availableToTrade
openingCash
marginUsed
spanExposure
cashMargin
premiumPresent
fnoSettlement
mtf
openingBalance
payinAmount
payoutAmount
deliveryCredit
unpaidCharges
totalCash
unavailableToWithdraw
isSuccess
isCache

POST /v1/account/funds/snapshot HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{}

{
  "data": {
    "SEC": {
      "cash": {
        "total": 125000.0,
        "availableToTrade": {
          "total": 118500.0,
          "openingCash": {
            "total": 125000.0,
            "openingBalance": 110000.0,
            "payinAmount": 20000.0,
            "payoutAmount": 5000.0,
            "deliveryCredit": 0.0,
            "unpaidCharges": 0.0
          },
          "marginUsed": {
            "total": 24600.5,
            "spanExposure": 18400.0,
            "cashMargin": 6200.5,
            "premiumPresent": 0.0,
            "fnoSettlement": 0.0,
            "mtf": 0.0
          }
        }
      },
      "availableToWithdraw": {
        "total": 118500.0,
        "totalCash": 125000.0,
        "unavailableToWithdraw": 6500.0
      }
    },
    "COM": {
      "cash": {
        "total": 0.0,
        "availableToTrade": { "total": 0.0 }
      }
    }
  },
  "isSuccess": true,
  "isCache": false
}

证券账户持仓

GET /v1/account/positions/demat openfinance

列出持仓卡上的在用与停用证券账户手数：instrumentKey、买卖数量与金额、净均价、CNC 占用数量、已质押抵押数量与折扣。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

active
inactive
hasInactiveHoldings
instrumentKey
usedQty
status
exchange
token
symbol
buyQty
buyValue
sellQty
sellValue
netAvgPrice
netAmt
cncUsedQty
collateralQty
haircut

GET /v1/account/positions/demat?metadata=true HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": {
    "active": [
      {
        "instrumentKey": "NSE_EQ|INE002A01018",
        "usedQty": 50,
        "status": "ACTIVE",
        "instruments": [
          {
            "exchange": "NSE",
            "token": "2885",
            "symbol": "RELIANCE",
            "instrumentKey": "NSE_EQ|INE002A01018"
          }
        ],
        "netInfo": {
          "buyQty": 50,
          "buyValue": 123012.5,
          "sellQty": 0,
          "sellValue": 0.0,
          "netAvgPrice": 2460.25,
          "netAmt": 123012.5
        },
        "additionalInfo": {
          "cncUsedQty": 50,
          "collateralQty": 10,
          "haircut": 12.5
        }
      }
    ],
    "inactive": [],
    "hasInactiveHoldings": false
  },
  "isSuccess": true
}

组合净值

GET /v1/account/wealth/overview openfinance

返回总净值，拆成应用内（internal）与已关联外部持仓，并带昨日市值供首页日涨跌使用。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

assets
netWorth
internalValue
internalValue1DayAgo
internalInvestedValue
externalValue
externalValue1DayAgo
externalInvestedValue

GET /v1/account/wealth/overview HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": {
    "assets": {},
    "netWorth": {
      "internalValue": 268910.5,
      "internalValue1DayAgo": 265200.0,
      "internalInvestedValue": 251240.0,
      "externalValue": 42000.0,
      "externalValue1DayAgo": 41250.0,
      "externalInvestedValue": 40000.0
    }
  },
  "isSuccess": true
}

共同基金组合汇总
GET /v1/funds/portfolio/overview openfinance
汇总共同基金账本：投入与当前市值、总盈亏与当日盈亏、最近更新时间，以及首笔订单是否仍在途。
认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。
- invested
- currentValue
- pnl
- totalPL
- todayReturns
- lastUpdatedAt
- breakdown
- isFirstOrderInProgress
- amount
- percentage
```
GET /v1/funds/portfolio/overview HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "data": {
    "invested": 80000.0,
    "currentValue": 86420.5,
    "pnl": 6420.5,
    "totalPL": 6420.5,
    "todayReturns": { "amount": 210.0, "percentage": 0.24 },
    "lastUpdatedAt": "2026-10-20T15:30:00+05:30",
    "isFirstOrderInProgress": false
  },
  "isSuccess": true
}
```

共同基金持仓

GET /v1/funds/portfolio/schemes openfinance

按基金列出持仓：份额、当前/平均净值、XIRR、内部/外部标记，以及当日与累计收益。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

investedValue
currentValue
xirr
currNav
avgInvestedNav
units
hasInternal
hasExternal
todayReturns
totalReturns
folios
holdingBreakdowns
transactionHistory

GET /v1/funds/portfolio/schemes HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": [
    {
      "investedValue": 25000.0,
      "currentValue": 27120.0,
      "xirr": "12.4",
      "currNav": 54.24,
      "avgInvestedNav": 50.0,
      "units": 500.0,
      "hasInternal": true,
      "hasExternal": false,
      "todayReturns": { "amount": 80.0, "percentage": 0.3 },
      "totalReturns": { "amount": 2120.0, "percentage": 8.48 },
      "folios": [],
      "holdingBreakdowns": []
    }
  ],
  "isSuccess": true
}

在售 IPO 列表

GET /v1/offerings/open openfinance

列出在售与即将开售的 IPO：ISIN、行业、每日申购窗口、时间线与当前认购倍数。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

ipoRefId
isin
name
industry
dailyStartTime
dailyEndTime
timeline
preApplyStartDate
applicationStartDate
applicationEndDate
applications
totalSubscription

GET /v1/offerings/open HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": [
    {
      "ipoRefId": "IPO20261020REL",
      "isin": "INE002A01018",
      "name": "Sample Industries Ltd",
      "industry": "Energy",
      "dailyStartTime": "10:00",
      "dailyEndTime": "17:00",
      "timeline": {
        "preApplyStartDate": "2026-10-18",
        "applicationStartDate": "2026-10-20",
        "applicationEndDate": "2026-10-22"
      },
      "applications": [],
      "totalSubscription": 2.4
    }
  ],
  "isSuccess": true
}

客户档案

GET /v1/account/client openbanking

返回已登录客户的 UCC、PAN、已开通交易所/产品、DDPI 开关以及关联银行账户（账号、IFSC、主交易账户标记）。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

exchangesEnabled
productsEnabled
userBankEntityList
userInfoEntity
userSegments
userVpaInfoList
associatedAccounts
firstName
lastName
email
mobile
panNumber
ucc
boId
customerStatus
isDDPIEnabled
accountNumber
bankName
isPrimaryTrading
ifscCode

GET /v1/account/client HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": {
    "exchangesEnabled": ["NSE", "BSE", "NFO", "MCX"],
    "productsEnabled": ["CNC", "MIS", "NRML", "MTF"],
    "userInfoEntity": {
      "firstName": "Priya",
      "lastName": "Sharma",
      "email": "[email protected]",
      "mobile": "9876543210",
      "panNumber": "ABCDE1234F",
      "ucc": "UP123456",
      "boId": "1208160000000001",
      "customerStatus": "ACTIVE",
      "isDDPIEnabled": true,
      "isPriorityPackEnabled": false,
      "type": "INDIVIDUAL",
      "subAccountType": ""
    },
    "userBankEntityList": [
      {
        "accountNumber": "XXXX4521",
        "bankName": "HDFC Bank",
        "isPrimaryTrading": true,
        "bankCode": "HDFC",
        "ifscCode": "HDFC0000123"
      }
    ],
    "userSegments": [],
    "userVpaInfoList": [],
    "associatedAccounts": []
  },
  "isSuccess": true
}

委托簿

GET /v1/trading/orders openfinance

返回委托页的在途与已完成单据：合约、委托/产品类型、AMO 标记、有效期，以及嵌套的止损与目标子单。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

category
amo
instrumentKey
orderType
productType
cta
validity
expiry
rules
additionalInfo
details
stopLossOrders
targetOrders

GET /v1/trading/orders?includePending=true HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": [
    {
      "category": "REGULAR",
      "amo": false,
      "instrumentKey": "NSE_EQ|INE002A01018",
      "orderType": "LIMIT",
      "productType": "D",
      "cta": [],
      "validity": "DAY",
      "expiry": 0,
      "rules": [],
      "stopLossOrders": [],
      "targetOrders": []
    }
  ],
  "isSuccess": true
}

下单

POST /v1/trading/orders/submit openfinance

从下单板提交新委托，返回 responseId 以及委托簿使用的券商 orderNumber。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

responseId
orderNumber
instrumentKey

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

{
  "instrumentKey": "NSE_EQ|INE002A01018"
}

{
  "data": {
    "responseId": "resp-9f3a12",
    "orderNumber": "240200012345"
  },
  "isSuccess": true
}

UPI 入金状态
GET /v1/transfers/deposit-status openbanking
轮询一笔入金（UPI / Google Pay / 网银）到账：txnid、customerRefId、状态与失败原因，供资金历史页使用。
认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。
- customerRefId
- reason
- status
- txnid
```
GET /v1/transfers/deposit-status?txnid=UPI2402000999 HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "data": {
    "customerRefId": "CR-778812",
    "reason": "",
    "status": "SUCCESS",
    "txnid": "UPI2402000999"
  },
  "isSuccess": true
}
```

出金

POST /v1/transfers/withdrawal-requests openbanking

发起卢比出金（默认 paymentMode 为 NEFT），返回 withdrawalId、状态、时间戳、完成日与手续费。

认证方式： OTP 加 PIN 登录后签发的 Bearer 访问令牌。

amount
value
withdrawalId
status
paymentMode
message
createdAt
updatedAt
dateOfCompletion
transactionFee

POST /v1/transfers/withdrawal-requests HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "amount": { "value": 25000.0 },
  "paymentMode": "NEFT"
}

{
  "data": {
    "amount": { "value": 25000.0 },
    "withdrawalId": "WD-24020077",
    "status": "SUBMITTED",
    "paymentMode": "NEFT",
    "message": "Withdrawal requested",
    "createdAt": "2026-10-20T16:02:11+05:30",
    "updatedAt": "2026-10-20T16:02:11+05:30",
    "dateOfCompletion": null,
    "transactionFee": "0"
  },
  "isSuccess": true
}

数据类别

SEC/COM 资金与保证金
证券账户持仓
组合净值
共同基金手数
在售 IPO
客户档案与银行
委托簿
UPI 入金
NEFT 出金

数据使用场景与案例

夜间 SEC 与 COM 对账
后台机器人拉取 SEC 与 COM 的 cash.availableToTrade.total、spanExposure、cashMargin 与 availableToWithdraw.total，并与当日 payinAmount / payoutAmount 核对，以便当晚把多余卢比提出。
持仓质押工作表
保证金台把 instrumentKey 手数上的 netAvgPrice、cncUsedQty、collateralQty 与 haircut 对齐，确保现金市场开盘前已质押数量跟上证券账户头寸。
共同基金与股票净值叠加
财富视图把 internalValue / externalInvestedValue 叠到共同基金的 investedValue、currentValue 与 xirr 上，避免应用内股票与已关联外部份额重复计算。
IPO 窗口监控
申购机器人列出带 applicationStartDate、applicationEndDate 与 totalSubscription 的 ipoRefId 行，确保每只在售新股在 dailyEndTime 前完成申购。

常见问题

Upstox 应用暴露哪些券商数据？

OTP 加 PIN 登录后，应用处理 SEC/COM 资金（availableToTrade、spanExposure、availableToWithdraw）、带 instrumentKey 与 haircut 的证券持仓、组合净值、共同基金手数（xirr、currNav、units）、在售 IPO、委托簿、UPI 入金状态与 NEFT 出金。

Upstox 的接口如何鉴权？

客户端先后完成 OTP 与 PIN 两步登录，后续资金、持仓与出金调用携带 Bearer 访问令牌。用户保持登录期间，会话令牌在后台续期。

资金快照是否拆分证券与商品？

是。资金载荷分别返回 SEC 与 COM 两个分桶，各自含 cash、collateral 与 availableToWithdraw，证券侧还带 SPAN/现金/MTF 已用保证金。

本页的接口路径是 Upstox 自己的吗？

不是。页面上的路径是对安卓客户端登录后所处理数据的示意性、泛化描述，并非 Upstox 对外发布的开发者接口。字段、鉴权方式与请求结构展示了这批数据对应的 openData Studio 可调用集成大致是什么样子。

与 Upstox Stocks IPO Mutual Funds 相似的应用

Groww — Groww 是在 SEBI 注册的印度券商兼共同基金代销机构，用户开立无纸化证券与交易账户后，可买卖 NSE/BSE 股票、ETF 与 IPO，用 SIP 买直销基金，并交易期货期权与商品。
Zerodha Kite — Zerodha 是印度折扣券商，其 Kite 平台用于投资股票、IPO、衍生品、共同基金、ETF 和债券，直销共同基金则走 Coin。
Angel One: Stocks, Mutual Fund — Angel One Limited 是孟买上市的印度券商和 CDSL 存管参与人，应用内可交易 NSE/BSE/MCX 股票、期货期权与商品，申购 IPO 并投资共同基金。
5paisa: Demat, Stocks & IPO — 5paisa Capital 是在 SEBI 注册的印度折扣券商，应用可开立证券账户，提供 NSE/BSE 股票、融资融券、IPO 申购和直销共同基金。
INDmoney: US Stocks, F&O, IPO — INDmoney 是在 SEBI 注册的印度券商（INDstocks），同一应用里覆盖印度现金与期货期权、IPO 申购、共同基金定投以及美股。
IIFL : Stocks, Demat & IPOs — IIFL Capital（India Infoline）是印度综合券商，其 Markets 应用把证券账户与交易账户合一，覆盖 NSE/BSE 股票、期货期权、共同基金和 IPO 申购。

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

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

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

获取报价

Upstox 数据 API：持仓与保证金

应用截图

API 端点一览

资金与交易限额

证券账户持仓

组合净值

共同基金组合汇总

共同基金持仓

在售 IPO 列表

客户档案

委托簿

下单

UPI 入金状态

出金

数据类别

数据使用场景与案例

夜间 SEC 与 COM 对账

持仓质押工作表

共同基金与股票净值叠加

IPO 窗口监控

常见问题

与 Upstox Stocks IPO Mutual Funds 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

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

Upstox 数据 API：持仓与保证金

应用截图

API 端点一览

资金与交易限额

证券账户持仓

组合净值

共同基金组合汇总

共同基金持仓

在售 IPO 列表

客户档案

委托簿

下单

UPI 入金状态

出金

数据类别

数据使用场景与案例

夜间 SEC 与 COM 对账

持仓质押工作表

共同基金与股票净值叠加

IPO 窗口监控

常见问题

相关应用

与 Upstox Stocks IPO Mutual Funds 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

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