Get Order Trades

API to retrieve the list of all trades executed for a specific order.To access the trade information, you need to pass order_id.

Request

curl --location 'https://api.upstox.com/v2/order/trades?order_id=240108010445100' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your_access_token}'

For additional samples in various languages, please refer to the Sample code section on this page.

Query Parameters

Name	Required	Type	Description
order_id	true	string	The order ID for which the order to get order trades. For the regex pattern applicable to this field, see the Field Pattern Appendix.

Responses

• 200
• 4XX

---

Response Body

{
  "status": "success",
  "data": [
    {
      "exchange": "NSE",
      "product": "D",
      "trading_symbol": "GMRINFRA-EQ",
      "tradingsymbol": "GMRINFRA-EQ",
      "instrument_token": "151064324",
      "order_type": "MARKET",
      "transaction_type": "BUY",
      "quantity": 1,
      "exchange_order_id": "221013001021540",
      "order_id": "221013001021539",
      "exchange_timestamp": "03-Aug-2017 15:03:42",
      "average_price": 299.4,
      "trade_id": "50091502",
      "order_ref_id": "udapi-aqwsed14356",
      "order_timestamp": "23-Apr-2021 14:22:06"
    }
  ]
}

Name	Type	Description
status	string	A string indicating the outcome of the request. Typically success for successful operations.
data	object[]	Response data for trades
data[].exchange	string	Exchange to which the order is associated. Valid exchanges can be found in the Exchange Appendix
data[].product	string	Signifies if the order was either Intraday, Delivery or CO. Possible values: I, D, CO, MTF.
data[].trading_symbol	string	Shows the trading symbol which could be a combination of symbol name, instrument, expiry date etc
data[].instrument_token	string	Key of the instrument. For the regex pattern applicable to this field, see the Field Pattern Appendix.
data[].order_type	string	Type of order. It can be one of the following MARKET refers to market order LIMIT refers to Limit Order SL refers to Stop Loss Limit SL-M refers to Stop Loss Market. Possible values: MARKET, LIMIT, SL, SL-M.
data[].transaction_type	string	Indicates whether its a buy or sell order. Possible values: BUY, SELL.
data[].quantity	int32	The total quantity traded from this particular order
data[].exchange_order_id	string	Unique order ID assigned by the exchange for the order placed
data[].order_id	string	Unique order ID assigned internally for the order placed
data[].exchange_timestamp	string	User readable time at when the trade occurred
data[].average_price	float	Price at which the traded quantity is traded
data[].trade_id	string	Trade ID generated from exchange towards traded transaction
data[].order_ref_id	string	Uniquely identifies an order for internal usage.
data[].order_timestamp	string	User readable timestamp at which the order was placed

Error codes

Error code	Description
UDAPI1023	Order id is required - Please ensure you provide an order id.
UDAPI1010	Order id accepts only alphanumeric characters and '-'. - The order id you've provided isn't accepted.

Sample Code

A comprehensive set of examples is provided to illustrate various use cases and implementation scenarios for this API.

Code Examples

Python

import requests

url = 'https://api.upstox.com/v2/order/trades?order_id=240108010445100'
headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}'
}

response = requests.get(url, headers=headers)
print(response.text)

Node.js

const axios = require('axios');

const url = 'https://api.upstox.com/v2/order/trades?order_id=240108010445100';
const headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {your_access_token}',
};

axios.get(url, { headers })
  .then(response => console.log(response.data))
  .catch(error => console.error(error.response.data));

Java

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://api.upstox.com/v2/order/trades?order_id=240108010445100";
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();

        // Set request headers
        con.setRequestMethod("GET");
        con.setRequestProperty("Content-Type", "application/json");
        con.setRequestProperty("Accept", "application/json");
        con.setRequestProperty("Authorization", "Bearer {your_access_token}");

        int responseCode = con.getResponseCode();
        BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
        String inputLine;
        StringBuilder response = new StringBuilder();

        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();

        System.out.println(response.toString());
    }
}

PHP

<?php
$url = 'https://api.upstox.com/v2/order/trades?order_id=240108010445100';
$headers = [
    'Content-Type: application/json',
    'Accept: application/json',
    'Authorization: Bearer {your_access_token}',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python SDK

import upstox_client
from upstox_client.rest import ApiException

configuration = upstox_client.Configuration()
configuration.access_token = '{your_access_token}'

api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
order_id = '{your_order_id}'
api_version = '2.0'

try:
    # Get trades for order
    api_response = api_instance.get_trades_by_order(order_id, api_version)
    print(api_response)
except ApiException as e:
    print("Exception when calling OrderApi->get_trades_by_order: %s\n" % e)

Node.js SDK

let UpstoxClient = require('upstox-js-sdk');
let defaultClient = UpstoxClient.ApiClient.instance;
var OAUTH2 = defaultClient.authentications['OAUTH2'];
OAUTH2.accessToken = "{your_access}";

let apiInstance = new UpstoxClient.OrderApi();

let orderId = "240111010861817";
let apiVersion = "2.0";

apiInstance.getTradesByOrder(orderId, apiVersion, (error, data, response) => {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + JSON.stringify(data));
  }
});

Java SDK

import com.upstox.ApiClient;
import com.upstox.ApiException;
import com.upstox.Configuration;
import com.upstox.api.GetTradeResponse;
import com.upstox.auth.*;
import io.swagger.client.api.OrderApi;

public class Main {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();

        OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
        OAUTH2.setAccessToken("{your_access_token}");

        OrderApi apiInstance = new OrderApi();
        String apiVersion = "2.0";
        String orderId = "240125010587640";
        try {
            GetTradeResponse result = apiInstance.getTradesByOrder(orderId, apiVersion);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling OrderApi#getTradesByOrder");
            e.printStackTrace();
        }
    }
}

Loading...