Skip to main content

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_amo request 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.

APIEndpoint
Place OrderPOST /v2/us/order/place
Cancel OrderDELETE /v2/us/order/cancel
Get Order BookGET /v2/us/order/retrieve-all
Get Order DetailsGET /v2/us/order/details

Portfolio and funds​

See the US stocks you hold, and your USD buying power and withdrawable cash.

APIEndpoint
Get HoldingsGET /v2/us/portfolio/holdings
Get FundsGET /v2/us/funds

Charges​

Estimate the charges for an order, or check whether your wallet covers a basket of up to 20 orders.

APIEndpoint
Estimate Order ChargesPOST /v2/us/order/estimate
Margin CalculatorPOST /v2/us/charges/margin

Market information​

Check US market holidays, session times and live status.

APIEndpoint
Market HolidaysGET /v2/us/market/holidays
Market TimingsGET /v2/us/market/timings/{date}
Market StatusGET /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 403 and error UDAPI1316. 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 MARKET and LIMIT order types with DAY validity. 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.

On the roadmap

What's coming next

Coming Soon

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.

Order updates
Get US order status changes (placed, filled, cancelled or rejected) as they happen, without polling the order book.
Market data
Fetch LTP market quotes for US stocks over REST.
Live market data feed
Stream live US stock prices tick by tick over WebSocket, instead of polling for quotes.

Thank you​

We appreciate your continued support. If you have questions or feedback, reach out through the developer community.