US Stocks APIs
Effective Date: November 17, 2026
You can now trade US-listed stocks and ETFs through the Upstox API. Eleven new endpoints under /v2/us cover the full trading flow: placing orders in whole or fractional shares, tracking orders and holdings, checking your USD wallet, estimating charges, and planning around US market hours.
For the full endpoint reference and sample code, see the new US Stocks section, available under US Stocks in the sidebar.
Highlights
- Fractional shares: buy a fraction of a share (up to 9 decimal places) in any stock marked
fractionable: true. - Dollar-amount orders: invest a fixed USD amount, such as $25, instead of a share count.
- Automatic after-market orders: an order placed outside the regular session becomes an after-market order (AMO) on its own. There is no
is_amorequest field. - Upfront charges: preview brokerage, GST and US regulatory fees before you place an order.
- Same access token: the token you use for the Indian APIs works for the US APIs too.
What's new
Orders
Place and cancel market or limit orders, and track them through the day.
US orders can't be modified. To change an open order, cancel it and place a new order.
| API | Endpoint |
|---|---|
| Place Order | POST /v2/us/order/place |
| Cancel Order | DELETE /v2/us/order/cancel |
| Get Order Book | GET /v2/us/order/retrieve-all |
| Get Order Details | GET /v2/us/order/details |
Portfolio and funds
See the US stocks you hold, and your USD buying power and withdrawable cash.
| API | Endpoint |
|---|---|
| Get Holdings | GET /v2/us/portfolio/holdings |
| Get Funds | GET /v2/us/funds |
Charges
Estimate the charges for an order, or check whether your wallet covers a basket of up to 20 orders.
| API | Endpoint |
|---|---|
| Estimate Order Charges | POST /v2/us/order/estimate |
| Margin Calculator | POST /v2/us/charges/margin |
Market information
Check US market holidays, session times and live status.
| API | Endpoint |
|---|---|
| Market Holidays | GET /v2/us/market/holidays |
| Market Timings | GET /v2/us/market/timings/{date} |
| Market Status | GET /v2/us/market/status |
US instruments file
A new US instruments file lists every US stock and ETF available on Upstox, with its instrument_key (for example US_EQ|AAPL) and its tradable and fractionable flags. US instruments are not part of the Indian BOD files.
Before you start
- Activate US stocks on your Upstox account before you call these APIs. If it isn't active, order, funds, and holdings requests fail with HTTP
403and errorUDAPI1316. To activate it, follow how to start investing in US stocks with Upstox. - All prices, amounts and balances are in USD.
- US orders support only
MARKETandLIMITorder types withDAYvalidity. The order value must be between $1 and $40,000.
See the US Stocks overview for all the trading rules, and US Stocks Error Codes for the new UDAPI13xx errors.
What's coming next
Real-time US Stocks data
Order updates, market quotes and a live market data feed for US stocks, the same way you use them for the Indian market today.
Thank you
We appreciate your continued support. If you have questions or feedback, reach out through the developer community.