Upstox

Upstox Order API

The Order API from Upstox — 18 operation(s) for order.

GitHub OpenAPI

Operations 18

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PUT /v3/order/modify Modify an open order (v3) · Modify order #
Ask an LLM
“How do I change the price of a pending order using the v3 order API?”
“Can I switch an open v3 order from limit to market?”
Tell an agent
Using v3, modify order {order_id} to {order_type} at {price}, trigger {trigger_price}, validity {validity}.
Via v3 change the quantity of order {order_id} to {quantity}, keeping {order_type} at {price}, trigger {trigger_price}, {validity}.
PUT /v3/order/gtt/modify Modify a GTT order · Modify GTT order #
Ask an LLM
“How do I change the trigger rules on my good-till-triggered order?”
“Can I update the quantity of an existing GTT?”
Tell an agent
Update GTT {gtt_order_id} to {type} with quantity {quantity} and rules {rules}.
Change the trigger rules of GTT order {gtt_order_id} to {rules}, type {type}, qty {quantity}.
PUT /v2/order/modify Modify an open order (older v2) · Modify order #
Ask an LLM
“How do I modify a pending order on the older v2 endpoint?”
“Which fields keep their original values if I leave them out of a v2 modify?”
Tell an agent
Through the v2 endpoint, modify order {order_id} to {order_type} at {price}, trigger {trigger_price}, validity {validity}.
With the legacy v2 modify, set disclosed quantity of {order_id} to {disclosed_quantity}, {order_type} at {price}, trigger {trigger_price}, {validity}.
POST /v3/order/place Place an order (v3, with auto-slicing) · Place order #
Ask an LLM
“How do I place a buy order with the v3 order API?”
“Can the v3 place endpoint slice a large order automatically?”
Tell an agent
Using v3, {transaction_type} {quantity} of {instrument_token} as a {order_type} order at {price}, product {product}.
Via v3, {transaction_type} {quantity} {instrument_token} with auto-slicing set to {slice}.
POST /v3/order/gtt/place Place a GTT order · Place GTT order #
Ask an LLM
“How do I set a good-till-triggered order that fires when a price is hit?”
“Can I create a multi-leg GTT with a target and stop loss?”
Tell an agent
Place a {type} GTT to {transaction_type} {quantity} of {instrument_token} as {product} with rules {rules}.
Set a good-till-triggered {transaction_type} on {instrument_token}, qty {quantity}, {product}, type {type}, triggers {rules}.
POST /v2/order/positions/exit Exit all open positions · Exit all positions #
Ask an LLM
“How do I square off all my open positions at once?”
“Can I exit only the positions in one segment or with a certain tag?”
Tell an agent destructive · confirm first
Exit all my open positions.
Square off every position in segment {segment}.
POST /v2/order/place Place an order (older v2) · Place order #
Ask an LLM
“How do I place an order on the older v2 place endpoint?”
“Can I tag an order placed through v2 so I can find it later?”
Tell an agent
Via the older v2 endpoint, {transaction_type} {quantity} of {instrument_token} as {order_type} at {price}, product {product}.
Place a legacy v2 {transaction_type} of {quantity} {instrument_token} tagged {tag}.
POST /v2/order/multi/place Place several orders in one request · Place multi order #
Ask an LLM
“Can I send a basket of orders to the exchange in a single call?”
“How do I place multiple orders together instead of one at a time?”
Tell an agent
Place this basket of orders in one request.
Submit all of these orders together as a multi-order.
GET /v3/order/gtt Get GTT order details · Get GTT order details #
Ask an LLM
“What GTT orders do I have set up and what are their triggers?”
“Has my good-till-triggered order fired yet?”
Tell an agent
Show all my GTT orders.
Get the details of GTT order {gtt_order_id}.
GET /v2/order/trades List trades executed for an order · Get trades for order #
Ask an LLM
“How many fills did one of my orders get and at what prices?”
“Was my order executed in parts?”
Tell an agent
List the trades executed for order {order_id}.
Show fill prices and quantities for order {order_id}.
GET /v2/order/trades/get-trades-for-day List today's executed trades · Get trades #
Ask an LLM
“What trades have I executed today?”
“Which of today's orders actually got filled?”
Tell an agent
List all trades executed today.
Show my tradebook for the day.
GET /v2/order/retrieve-all List today's orders · Get order book #
Ask an LLM
“What orders have I placed today, including open and filled ones?”
“Where can I see my full order book for the current session?”
Tell an agent
Show my order book for today.
List every order I placed this session with its state.
GET /v2/order/history Get the status history of an order · Get order history #
Ask an LLM
“What status changes has one of my orders gone through today?”
“Can I trace an order's history using the tag I gave it?”
Tell an agent
Get the order history of {order_id}.
Show the lifecycle of the order tagged {tag}.
GET /v2/order/details Get the latest details of an order · Get order details #
Ask an LLM
“What is the current status of a specific order?”
“Is my order still open or has it been filled?”
Tell an agent
Get the latest details of order {order_id}.
Check whether order {order_id} is open, rejected or complete.
DELETE /v3/order/gtt/cancel Cancel a GTT order · Cancel GTT order #
Ask an LLM
“How do I delete a good-till-triggered order I no longer need?”
“Can I cancel a GTT before it triggers?”
Tell an agent destructive · confirm first
Cancel GTT order {gtt_order_id}.
Remove my good-till-triggered order {gtt_order_id}.
DELETE /v3/order/cancel Cancel an order (v3) · Cancel order #
Ask an LLM
“How do I cancel a pending order using the v3 order API?”
“What does the v3 cancel endpoint need to cancel an order?”
Tell an agent destructive · confirm first
Using v3, cancel order {order_id}.
Cancel pending order {order_id} through the v3 endpoint.
DELETE /v2/order/multi/cancel Cancel all open orders · Cancel multi order #
Ask an LLM
“Can I cancel every open and pending order in one go?”
“Is there a way to cancel only the open orders in one segment?”
Tell an agent destructive · confirm first
Cancel all my open and pending orders.
Cancel every open order in segment {segment}.
DELETE /v2/order/cancel Cancel or exit an order (older v2) · Cancel order #
Ask an LLM
“How do I exit a cover order or OCO bracket order?”
“Can the older v2 cancel endpoint cancel an after-market order?”
Tell an agent destructive · confirm first
Via the v2 endpoint, cancel order {order_id}.
Exit my cover or bracket order {order_id}.

Documentation

📖
Documentation
https://upstox.com/developer/api-documentation/open-api
📖
APIReference
https://upstox.com/developer/api-documentation/api-overview
📖
GettingStarted
https://upstox.com/developer/api-documentation/installing-sdk
📖
Authentication
https://upstox.com/developer/api-documentation/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/upstox/refs/heads/main/openapi/upstox-order-api-openapi.yml

Other Resources

🔗
Postman
https://gist.github.com/Rahulzz/a0da2ad28a7dcc81e887f24cfdbc80a8
🔗
Webhooks
https://upstox.com/developer/api-documentation/webhook

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/upstox:upstox-order-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

upstox-order-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAPI definition Order API
  version: v0
servers:
- url: https://api-v2.upstox.com
tags:


# --- truncated at 32 KB (76 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/upstox/refs/heads/main/openapi/upstox-order-api-openapi.yml