Saved searches

Use saved searches to filter your results more quickly

Cancel Create saved search

Sign up Reseting focus

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

README.md

Latest commit

History

231 lines (184 loc) · 7.96 KB

README.md

File metadata and controls

231 lines (184 loc) · 7.96 KB

SHARECONNECT-PYTHON

Sharekhan-Python is a Python library that provides a set of tools and functionalities for interacting with the Sharekhan trading platform. With Sharekhan-Python, users can access a variety of trading-related information such as stock prices, market trends, historical data, stream live market data (WebSockets), and more.It also provides the ability to execute trades and orders in real time. 

Installation

Use the package manager pip to install shareconnectpython

pip install shareconnect pip install websocket

Usage

# package import statement from SharekhanApi.sharekhanConnect import SharekhanConnect # Make a object call api_key = "Your API-KEY" login = SharekhanConnect(api_key) vendor_key = "Vendor key" """Pass the vendor key for vendor login otherwise keep it blank""" version_id = "Version Id" """Only null/1005/1006 version id is allowed to be passed""" state=12345 url = login.login_url(vendor_key=vendor_key, version_id=version_id) """This will provide you the redirect login url which can be used to login in the sharekhan account""" print(url) """After Successfully Login You will receive the request token value then you have to decrypt the token value by using secret key and then swap the request token which is a combination of RequestId and CustomerId.Then after that decrypt the request token value.""" request_token = "Valid Request Token Value" secret_key = "Your Secret Key value" """Use generate session method when you are passing version id """ session=login.generate_session(request_token,secret_key) # Generating access token for version id and pass parameters as it is passed below access_token=login.get_access_token(api_key,session,state,versionId=version_id) """Use generate session without version id method when you are not passing version id """ sessionwithoutvesionId=login.generate_session_without_versionId(request_token,secret_key) # Generating access token for without version id access_token=login.get_access_token(api_key,sessionwithoutvesionId,state) print(access_token) # Make a object for SharekhanConnect class """Here we are passing the api-key, access-token and vendor-key(when needed) as a request header parameters""" access_token = "Your access token value" sharekhan = SharekhanConnect(api_key,access_token) print(sharekhan.requestHeaders()) # for printing request headers # Place order history orderparams=< "customerId": "XXXXXXX", "scripCode": 2475, "tradingSymbol": "ONGC", "exchange": "NC", "transactionType": "B", --> (B, S, BM, SM, SAM) "quantity": 1, "disclosedQty": 0, "price": "149.5", "triggerPrice": "0", "rmsCode": "ANY", "afterHour": "N", "orderType": "NORMAL", "channelUser": "XXXXXXX", (Use LoginId as ChannelUser) "validity": "GFD", "requestType": "NEW", "productType": "INVESTMENT" --> (INVESTMENT or (INV), BIGTRADE or (BT), BIGTRADEPLUS or (BT+)) #Below parameters need to be added for FNO trading "instrumentType": "FUTCUR"; --> (Future Stocks(FS)/ Future Index(FI)/ Option Index(OI)/ Option Stocks(OS)/ Future Currency(FUTCUR)/ Option Currency(OPTCUR)) "strikePrice": "-1"; "optionType": "XX"; --> (XX/PE/CE) "expiry": "31/03/2023"; > order=sharekhan.placeOrder(orderparams) print("PlaceOrder: <>".format(order)) # modify order orderparams=< "orderId":"XXXXXXXXXXX", "customerId": "XXXXXXX", "scripCode": 2475, "tradingSymbol": "ONGC", "exchange": "NC", "transactionType": "B", --> (B, S, BM, SM, SAM) "quantity": 1, "disclosedQty": 0, "price": "149.5", "triggerPrice": "0", "rmsCode": "ANY", "afterHour": "N", "orderType": "NORMAL", "channelUser": "XXXXXXX", (Use LoginId as ChannelUser) "validity": "GFD", "requestType": "MODIFY", "productType": "INVESTMENT" --> (INVESTMENT or (INV), BIGTRADE or (BT), BIGTRADEPLUS or (BT+)) #Below parameters need to be added for FNO trading "instrumentType": "FUTCUR"; --> (Future Stocks(FS)/ Future Index(FI)/ Option Index(OI)/ Option Stocks(OS)/ Future Currency(FUTCUR)/ Option Currency(OPTCUR)) "strikePrice": "-1"; "optionType": "XX"; --> (XX/PE/CE) "expiry": "31/03/2023"; > order=sharekhan.modifyOrder(orderparams) print("ModifyOrder: <>".format(order)) # cancel order orderparams=< "orderId":"XXXXXXX", "customerId": "XXXXXXX", "scripCode": 2475, "tradingSymbol": "ONGC", "exchange": "NC", "transactionType": "B", --> (B, S, BM, SM, SAM) "quantity": 1, "disclosedQty": 0, "price": "149.5", "triggerPrice": "0", "rmsCode": "ANY", "afterHour": "N", "orderType": "NORMAL", "channelUser": "XXXXXXX", (Use LoginId as ChannelUser) "validity": "GFD", "requestType": "CANCEL", "productType": "INVESTMENT" --> (INVESTMENT or (INV), BIGTRADE or (BT), BIGTRADEPLUS or (BT+)) #Below parameters need to be added for FNO trading "instrumentType": "FUTCUR"; --> (Future Stocks(FS)/ Future Index(FI)/ Option Index(OI)/ Option Stocks(OS)/ Future Currency(FUTCUR)/ Option Currency(OPTCUR)) "strikePrice": "-1"; "optionType": "XX"; --> (XX/PE/CE) "expiry": "31/03/2023"; > order=sharekhan.cancelOrder(orderparams) print("CancelOrder: <>".format(order)) # Retrieves all positions customerId="customerId < int data type>" order=sharekhan.trades(customerId) print("Postion Reports: <>".format(order)) # Retrieve history of an given order exchange="exchange value " customerId="customerId " orderId="orderId " order=sharekhan.exchange(exchange, customerId, orderId) print("Order Details: <>".format(order)) # Retrieves the trade generated by an order exchange="exchange value " customerId="customerId " orderId="orderId " order=sharekhan.exchangetrades(exchange, customerId, orderId) print("Trade Generated By an Order : <>".format(order)) # services Holdings customerId="customerId " order=sharekhan.holdings(customerId) print("Holdings : <>".format(order)) # Script Master exchange="exchange value " order=sharekhan.master(exchange) print("Script Master : <>".format(order)) # Historical Data exchange="exchange value " scripcode="Unique scripcode provided by the broker " interval="Available Intervals " order=sharekhan.historicaldata(exchange, scripcode, interval) print("Holdings Data: <>".format(order))

websocket Programming Testing

from SharekhanApi.sharekhanWebsocket import SharekhanWebSocket params = < "access_token": access_token > action = 1 mode = 1 token_list = "action": "subscribe", "key": ["feed"], "value": [""]> feed = "action": "feed", "key": ["depth"], "value": ["MX250715"]> unsubscribefeed = "action":"unsubscribe","key":["feed"],"value":["NC22,NF37833,NF37834,MX253461,RN7719"]> sws = SharekhanWebSocket(access_token) def on_data(wsapp, message): print("Ticks: <>".format(message)) def on_open(wsapp): print("on open") sws.subscribe(token_list) # sws.fetchData(feed) # sws.unsubscribe(unsubscribefeed) # sws.close_connection() def on_error(wsapp, error): print(error) def on_close(wsapp): print("Close") # Assign the callbacks. sws.on_open = on_open sws.on_data = on_data sws.on_error = on_error sws.on_close = on_close sws.connect()