upstox_client.OrderApi

All URIs are relative to https://api-v2.upstox.com

Method	HTTP request	Description
cancel_order	DELETE /order/cancel	Cancel order
get_order_book	GET /order/retrieve-all	Get order book
get_order_details	GET /order/history	Get order details
get_trade_history	GET /order/trades/get-trades-for-day	Get trades
get_trades_by_order	GET /order/trades	Get trades for order
modify_order	PUT /order/modify	Modify order
place_order	POST /order/place	Place order

cancel_order

CancelOrderResponse cancel_order(order_id, api_version)

Cancel order

Cancel order API can be used for two purposes: Cancelling an open order which could be an AMO or a normal order It is also used to EXIT a CO or OCO(bracket order)

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
order_id = 'order_id_example' # str | The order ID for which the order must be cancelled
api_version = 'api_version_example' # str | API Version Header

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

Parameters

Name	Type	Description	Notes
order_id	str	The order ID for which the order must be cancelled
api_version	str	API Version Header

Return type

CancelOrderResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: Not defined
Accept: application/json, /

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_order_book

GetOrderBookResponse get_order_book(api_version)

Get order book

This API provides the list of orders placed by the user. The orders placed by the user is transient for a day and is cleared by the end of the trading session. This API returns all states of the orders, namely, open, pending, and filled ones.

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
api_version = 'api_version_example' # str | API Version Header

try:
    # Get order book
    api_response = api_instance.get_order_book(api_version)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling OrderApi->get_order_book: %s\n" % e)

Parameters

Name	Type	Description	Notes
api_version	str	API Version Header

Return type

GetOrderBookResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: Not defined
Accept: /, application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_order_details

GetOrderResponse get_order_details(api_version, order_id=order_id, tag=tag)

Get order details

This API provides the details of the particular order the user has placed. The orders placed by the user is transient for a day and are cleared by the end of the trading session. This API returns all states of the orders, namely, open, pending, and filled ones. The order history can be requested either using order_id or tag. If both the options are passed, the history of the order which precisely matches both the order_id and tag will be returned in the response. If only the tag is passed, the history of all the associated orders which matches the tag will be shared in the response.

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
api_version = 'api_version_example' # str | API Version Header
order_id = 'order_id_example' # str | The order reference ID for which the order history is required (optional)
tag = 'tag_example' # str | The unique tag of the order for which the order history is being requested (optional)

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

Parameters

Name	Type	Description	Notes
api_version	str	API Version Header
order_id	str	The order reference ID for which the order history is required	[optional]
tag	str	The unique tag of the order for which the order history is being requested	[optional]

Return type

GetOrderResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: Not defined
Accept: application/json, /

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_trade_history

GetTradeResponse get_trade_history(api_version)

Get trades

Retrieve the trades executed for the day

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
api_version = 'api_version_example' # str | API Version Header

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

Parameters

Name	Type	Description	Notes
api_version	str	API Version Header

Return type

GetTradeResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: Not defined
Accept: /, application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_trades_by_order

GetTradeResponse get_trades_by_order(order_id, api_version)

Get trades for order

Retrieve the trades executed for an order

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
order_id = 'order_id_example' # str | The order ID for which the order to get order trades
api_version = 'api_version_example' # str | API Version Header

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

Parameters

Name	Type	Description	Notes
order_id	str	The order ID for which the order to get order trades
api_version	str	API Version Header

Return type

GetTradeResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: Not defined
Accept: application/json, /

[Back to top] [Back to API list] [Back to Model list] [Back to README]

modify_order

ModifyOrderResponse modify_order(body, api_version)

Modify order

This API allows you to modify an order. For modification orderId is mandatory. With orderId you need to send the optional parameter which needs to be modified. In case the optional parameters aren't sent, the default will be considered from the original order

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
body = upstox_client.ModifyOrderRequest() # ModifyOrderRequest | 
api_version = 'api_version_example' # str | API Version Header

try:
    # Modify order
    api_response = api_instance.modify_order(body, api_version)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling OrderApi->modify_order: %s\n" % e)

Parameters

Name	Type	Description	Notes
body	ModifyOrderRequest
api_version	str	API Version Header

Return type

ModifyOrderResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: application/json
Accept: application/json, /

[Back to top] [Back to API list] [Back to Model list] [Back to README]

place_order

PlaceOrderResponse place_order(body, api_version)

Place order

This API allows you to place an order to the exchange via Upstox.

Example

from __future__ import print_function
import time
import upstox_client
from upstox_client.rest import ApiException
from pprint import pprint

# Configure OAuth2 access token for authorization: OAUTH2
configuration = upstox_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'

# create an instance of the API class
api_instance = upstox_client.OrderApi(upstox_client.ApiClient(configuration))
body = upstox_client.PlaceOrderRequest() # PlaceOrderRequest | 
api_version = 'api_version_example' # str | API Version Header

try:
    # Place order
    api_response = api_instance.place_order(body, api_version)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling OrderApi->place_order: %s\n" % e)

Parameters

Name	Type	Description	Notes
body	PlaceOrderRequest
api_version	str	API Version Header

Return type

PlaceOrderResponse

Authorization

OAUTH2

HTTP request headers

Content-Type: application/json
Accept: /, application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

Files

OrderApi.md

Latest commit

History

OrderApi.md

File metadata and controls

upstox_client.OrderApi

cancel_order

Example

Parameters

Return type

Authorization

HTTP request headers

get_order_book

Example

Parameters

Return type

Authorization

HTTP request headers

get_order_details

Example

Parameters

Return type

Authorization

HTTP request headers

get_trade_history

Example

Parameters

Return type

Authorization

HTTP request headers

get_trades_by_order

Example

Parameters

Return type

Authorization

HTTP request headers

modify_order

Example

Parameters

Return type

Authorization

HTTP request headers

place_order

Example

Parameters

Return type

Authorization

HTTP request headers