Recently, automated trading has gained popularity among traders in the financial markets. In particular, Python has established itself as a suitable language for developing automated trading systems due to its concise syntax and various libraries. This article will cover the initial setup and login method for automated trading using Kiwoom Securities’ Open API.<\/p>\n
1. What is Kiwoom Securities Open API?<\/h2>\n
Kiwoom Securities Open API is an interface that allows users to programmatically execute trades utilizing various trading functions provided by the user. Developers can access a variety of financial products such as stocks, futures, and options through this API, and can receive trade orders and real-time data.<\/p>\n
1.1 Advantages of the API<\/h3>\n\n- Ease of developing automated trading systems<\/li>\n
- Real-time market data collection<\/li>\n
- Developer community support<\/li>\n
- Compatibility with various programming languages<\/li>\n<\/ul>\n
2. Prerequisites<\/h2>\n
To use Kiwoom Securities Open API, several prerequisites are necessary. You need a Kiwoom Securities account and an API key.<\/p>\n
2.1 Creating a Kiwoom Securities Account<\/h3>\n
Visit the Kiwoom Securities website to create an account. After creating the account, configure the necessary settings through the API-related menu.<\/p>\n
2.2 Issuing an API Key<\/h3>\n
After logging in, fill out the API application form to get your API key. This is essential for using the API.<\/p>\n
2.3 Setting Up the Python Environment<\/h3>\n
Prepare the Python development environment. Anaconda or Visual Studio Code is recommended. The necessary libraries are as follows:<\/p>\n
pip install pyqt5\npip install pandas\npip install numpy\n<\/code><\/pre>\n3. Logging into Kiwoom Securities Open API+<\/h2>\n
Before using the API, you must first log in. The code below demonstrates the process of logging into the API.<\/p>\n
3.1 Importing Kiwoom API Module<\/h3>\nimport win32com.client\nimport pythoncom\n<\/code><\/pre>\n3.2 Defining Login-related Functions<\/h3>\n
Define a callback function for logging in. This is necessary for event handling with the API.<\/p>\n
\nclass Kiwoom:\n def __init__(self):\n self.tr = win32com.client.Dispatch(\"KHOPENAPI.KHOpenAPICtrl.1\")\n self.login_event_slot()\n\n def login_event_slot(self):\n self.tr.OnEventConnect.connect(self.login_event)\n\n def login_event(self, err_code):\n if err_code == 0:\n print(\"Login Successful\")\n else:\n print(\"Login Failed\")\n<\/code><\/pre>\n3.3 Executing Login<\/h3>\nif __name__ == \"__main__\":\n app = QtWidgets.QApplication([])\n kiwoom = Kiwoom()\n kiwoom.tr.CommConnect()\n app.exec_()\n<\/code><\/pre>\nRunning the above code will display the Kiwoom Securities login window. After logging in, if the connection is successful, the message “Login Successful” will be printed.<\/p>\n
4. Obtaining Stock Codes<\/h2>\n
After logging in, add the following code to obtain the code for the desired stock.<\/p>\n
\ndef get_code_list(self):\n code_list = self.tr.GetCodeListByMarket(0) # 0: KOSPI\n return code_list.split(';')\n<\/code><\/pre>\nThis function retrieves the codes of stocks listed on the KOSPI.<\/p>\n
4.1 Printing Stock Codes<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n code_list = kiwoom.get_code_list()\n print(\"KOSPI Stock Code List:\", code_list)\n<\/code><\/pre>\n5. Placing Stock Orders<\/h2>\n
Next, we will write code to allow placing orders. Below is an example of placing a buy order.<\/p>\n
\ndef buy_stock(self, code, quantity):\n self.tr.SendOrder(\"Order Name\", \"130\", \"Stock Code\", quantity, 0, \"00\", \"0\", \"0\", \"\")\n<\/code><\/pre>\nThe above function shows an example of buying stocks at market price.<\/p>\n
5.1 Executing Buy Orders<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n kiwoom.buy_stock(\"005930\", 1) # Buy 1 share of Samsung Electronics\n<\/code><\/pre>\n6. Placing Sell Orders<\/h2>\n
Sell orders are processed similarly.<\/p>\n
\ndef sell_stock(self, code, quantity):\n self.tr.SendOrder(\"Sell Order\", \"130\", \"Stock Code\", -quantity, 0, \"00\", \"0\", \"0\", \"\")\n<\/code><\/pre>\nWhen placing an order, the quantity value is entered as a negative number to execute a sell.<\/p>\n
6.1 Executing Sell Orders<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n kiwoom.sell_stock(\"005930\", 1) # Sell 1 share of Samsung Electronics\n<\/code><\/pre>\n7. Receiving Real-time Data<\/h2>\n
One of the important aspects of trading is receiving real-time data. Below explains how to receive real-time data.<\/p>\n
\ndef setup_signal(self):\n self.tr.OnReceiveRealData.connect(self.receive_real_data)\n\ndef receive_real_data(self, code, real_type, real_data):\n print(f\"Stock: {code}, Real-time Data: {real_type}, Data: {real_data}\")\n<\/code><\/pre>\nThis function allows you to process real-time data.<\/p>\n
7.1 Executing Real-time Data Reception<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n kiwoom.setup_signal()\n kiwoom.tr.SetRealReg(\"0001\", \"005930\", \"20\", \"0\") # Register real-time data for Samsung Electronics\n<\/code><\/pre>\n8. Conclusion<\/h2>\n
In this article, we explored the initial setup and login method for automated trading using Kiwoom Securities Open API with Python. There are many more functionalities, so I encourage you to add the features you need and build your own automated trading system. Through continuous learning and experimentation, you can develop your own trading strategies.<\/p>\n
Helpful Resources<\/h3>\n
2. Prerequisites<\/h2>\n
To use Kiwoom Securities Open API, several prerequisites are necessary. You need a Kiwoom Securities account and an API key.<\/p>\n
2.1 Creating a Kiwoom Securities Account<\/h3>\n
Visit the Kiwoom Securities website to create an account. After creating the account, configure the necessary settings through the API-related menu.<\/p>\n
2.2 Issuing an API Key<\/h3>\n
After logging in, fill out the API application form to get your API key. This is essential for using the API.<\/p>\n
2.3 Setting Up the Python Environment<\/h3>\n
Prepare the Python development environment. Anaconda or Visual Studio Code is recommended. The necessary libraries are as follows:<\/p>\n
pip install pyqt5\npip install pandas\npip install numpy\n<\/code><\/pre>\n3. Logging into Kiwoom Securities Open API+<\/h2>\n
Before using the API, you must first log in. The code below demonstrates the process of logging into the API.<\/p>\n
3.1 Importing Kiwoom API Module<\/h3>\nimport win32com.client\nimport pythoncom\n<\/code><\/pre>\n3.2 Defining Login-related Functions<\/h3>\n
Define a callback function for logging in. This is necessary for event handling with the API.<\/p>\n
\nclass Kiwoom:\n def __init__(self):\n self.tr = win32com.client.Dispatch(\"KHOPENAPI.KHOpenAPICtrl.1\")\n self.login_event_slot()\n\n def login_event_slot(self):\n self.tr.OnEventConnect.connect(self.login_event)\n\n def login_event(self, err_code):\n if err_code == 0:\n print(\"Login Successful\")\n else:\n print(\"Login Failed\")\n<\/code><\/pre>\n3.3 Executing Login<\/h3>\nif __name__ == \"__main__\":\n app = QtWidgets.QApplication([])\n kiwoom = Kiwoom()\n kiwoom.tr.CommConnect()\n app.exec_()\n<\/code><\/pre>\nRunning the above code will display the Kiwoom Securities login window. After logging in, if the connection is successful, the message “Login Successful” will be printed.<\/p>\n
4. Obtaining Stock Codes<\/h2>\n
After logging in, add the following code to obtain the code for the desired stock.<\/p>\n
\ndef get_code_list(self):\n code_list = self.tr.GetCodeListByMarket(0) # 0: KOSPI\n return code_list.split(';')\n<\/code><\/pre>\nThis function retrieves the codes of stocks listed on the KOSPI.<\/p>\n
4.1 Printing Stock Codes<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n code_list = kiwoom.get_code_list()\n print(\"KOSPI Stock Code List:\", code_list)\n<\/code><\/pre>\n5. Placing Stock Orders<\/h2>\n
Next, we will write code to allow placing orders. Below is an example of placing a buy order.<\/p>\n
\ndef buy_stock(self, code, quantity):\n self.tr.SendOrder(\"Order Name\", \"130\", \"Stock Code\", quantity, 0, \"00\", \"0\", \"0\", \"\")\n<\/code><\/pre>\nThe above function shows an example of buying stocks at market price.<\/p>\n
5.1 Executing Buy Orders<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n kiwoom.buy_stock(\"005930\", 1) # Buy 1 share of Samsung Electronics\n<\/code><\/pre>\n6. Placing Sell Orders<\/h2>\n
Sell orders are processed similarly.<\/p>\n
\ndef sell_stock(self, code, quantity):\n self.tr.SendOrder(\"Sell Order\", \"130\", \"Stock Code\", -quantity, 0, \"00\", \"0\", \"0\", \"\")\n<\/code><\/pre>\nWhen placing an order, the quantity value is entered as a negative number to execute a sell.<\/p>\n
6.1 Executing Sell Orders<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n kiwoom.sell_stock(\"005930\", 1) # Sell 1 share of Samsung Electronics\n<\/code><\/pre>\n7. Receiving Real-time Data<\/h2>\n
One of the important aspects of trading is receiving real-time data. Below explains how to receive real-time data.<\/p>\n
\ndef setup_signal(self):\n self.tr.OnReceiveRealData.connect(self.receive_real_data)\n\ndef receive_real_data(self, code, real_type, real_data):\n print(f\"Stock: {code}, Real-time Data: {real_type}, Data: {real_data}\")\n<\/code><\/pre>\nThis function allows you to process real-time data.<\/p>\n
7.1 Executing Real-time Data Reception<\/h3>\nif __name__ == \"__main__\":\n # Existing code ...\n kiwoom.setup_signal()\n kiwoom.tr.SetRealReg(\"0001\", \"005930\", \"20\", \"0\") # Register real-time data for Samsung Electronics\n<\/code><\/pre>\n8. Conclusion<\/h2>\n
In this article, we explored the initial setup and login method for automated trading using Kiwoom Securities Open API with Python. There are many more functionalities, so I encourage you to add the features you need and build your own automated trading system. Through continuous learning and experimentation, you can develop your own trading strategies.<\/p>\n
Helpful Resources<\/h3>\n