{"id":15047714,"url":"https://github.com/astrodynamic/exchangequest","last_synced_at":"2026-01-30T08:03:43.368Z","repository":{"id":249451311,"uuid":"823337275","full_name":"Astrodynamic/ExchangeQuest","owner":"Astrodynamic","description":"ExchangeQuest is a C++ client-server trading exchange system for USD and RUB with order matching, supporting multiple clients and real-time balance updates.","archived":false,"fork":false,"pushed_at":"2024-07-23T14:15:26.000Z","size":674,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-01-20T17:17:20.186Z","etag":null,"topics":["asio","asio-library","async","boost","client","client-server","cmake","cpp","cpp20","exchange","finance","gtest","networking","server","socket","tcp","tcp-client","tcp-server","trading","traiding"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Astrodynamic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-02T21:07:11.000Z","updated_at":"2024-07-23T14:15:29.000Z","dependencies_parsed_at":"2024-07-20T23:32:51.143Z","dependency_job_id":"fe5fd283-277b-410b-9ec3-882452e166fd","html_url":"https://github.com/Astrodynamic/ExchangeQuest","commit_stats":null,"previous_names":["astrodynamic/exchangequest"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Astrodynamic%2FExchangeQuest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Astrodynamic%2FExchangeQuest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Astrodynamic%2FExchangeQuest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Astrodynamic%2FExchangeQuest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Astrodynamic","download_url":"https://codeload.github.com/Astrodynamic/ExchangeQuest/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243489778,"owners_count":20298997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asio","asio-library","async","boost","client","client-server","cmake","cpp","cpp20","exchange","finance","gtest","networking","server","socket","tcp","tcp-client","tcp-server","trading","traiding"],"created_at":"2024-09-24T21:03:25.746Z","updated_at":"2026-01-30T08:03:43.305Z","avatar_url":"https://github.com/Astrodynamic.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ExchangeQuest\n\n- [ExchangeQuest](#exchangequest)\n  - [Introduction](#introduction)\n  - [Requirements](#requirements)\n  - [Building and Running](#building-and-running)\n  - [Testing](#testing)\n  - [Usage](#usage)\n    - [1. Starting the Client and Server](#1-starting-the-client-and-server)\n    - [2. Connecting to the Server](#2-connecting-to-the-server)\n    - [3. Registering a User](#3-registering-a-user)\n    - [4. Logging In](#4-logging-in)\n    - [5. Creating a Order](#5-creating-a-order)\n    - [6. Checking Balance](#6-checking-balance)\n  - [LICENSE](#license)\n\n## Introduction\nExchangeQuest is a simple client-server trading exchange system that allows users to trade USD for RUB. This project demonstrates the implementation of a multi-client trading system with order matching logic using C++20. It leverages Boost.Asio for networking and GoogleTest for testing.\n\n## Requirements\n- Boost.Asio (latest stable version)\n- CMake (version 3.21 or later)\n- C++20 or later\n- GoogleTest (for testing)\n\n## Building and Running\nTo build the project, follow these steps:\n\n\n```sh\nmake\n```\n\nTo run the server:\n```sh\n./build/server/ExchangeQuestServer\n```\n\nTo run the client:\n```sh\n./build/client/ExchangeQuestClient\n```\n\n## Testing\nThe project includes unit tests for order matching and other functionalities. To run the tests, follow these steps:\n\n```sh\nmake tests\n```\n\n## Usage\n\n### 1. Starting the Client and Server\n\nStart the server:\n```sh\n./build/server/ExchangeQuestServer\n```\n\nStart the client:\n```sh\n./build/client/ExchangeQuestClient\n```\n\n### 2. Connecting to the Server\n\nWhen you start the client, you'll be presented with a menu. Choose the option to connect to the server by selecting `1`.\n\n```\n --------------------------------------------------------------\n|                         Exchange 1.0                         |\n --------------------------------------------------------------\n --------------------------------------------------------------\n|                       Select menu item                       |\n --------------------------------------------------------------\n| 0. Exit                                                      |\n| 1. Connect to the server                                     |\n| 2. Registration                                              |\n| 3. Login                                                     |\n| 4. Order                                                     |\n| 5. Balance                                                   |\n --------------------------------------------------------------\n```\n\n### 3. Registering a User\n\nTo register, select option `2`.\n\n```\n --------------------------------------------------------------\n|                       Select menu item                       |\n --------------------------------------------------------------\n| 0. Exit                                                      |\n| 1. Connect to the server                                     |\n| 2. Registration                                              |\n| 3. Login                                                     |\n| 4. Order                                                     |\n| 5. Balance                                                   |\n --------------------------------------------------------------\n \n```\n\n### 4. Logging In\n\nAfter registration, you can log in by selecting option `3` and entering your UID.\n\n```\n --------------------------------------------------------------\n|                       Select menu item                       |\n --------------------------------------------------------------\n| 0. Exit                                                      |\n| 1. Connect to the server                                     |\n| 2. Registration                                              |\n| 3. Login                                                     |\n| 4. Order                                                     |\n| 5. Balance                                                   |\n --------------------------------------------------------------\n\nEnter UID:\n```\n\n### 5. Creating a Order\n\nTo create a new trading order, select option `4` and follow the format for entering your order details.\n\n```\n --------------------------------------------------------------\n|                       Select menu item                       |\n --------------------------------------------------------------\n| 0. Exit                                                      |\n| 1. Create a new trading order                                |\n|    Format: [INSTRUMENT]|[SIDE]:[VOLUME]@[PRICE]              |\n|    INSTRUMENT: Trading instrument (e.g., USD)                |\n|    SIDE: BUY (for buying) or SELL (for selling)              |\n|    VOLUME: Number of units to trade                          |\n|    PRICE: Price per unit                                     |\n|                                                              |\n|    Example: USD|BUY:100@150.25                               |\n --------------------------------------------------------------\n\nEnter your order:\n```\n\n### 6. Checking Balance\n\nTo check your balance, select option `5`.\n\n```\n --------------------------------------------------------------\n|                       Select menu item                       |\n --------------------------------------------------------------\n| 0. Exit                                                      |\n| 1. Connect to the server                                     |\n| 2. Registration                                              |\n| 3. Login                                                     |\n| 4. Order                                                     |\n| 5. Balance                                                   |\n --------------------------------------------------------------\n\nChecking balance...\n```\n\n\n## LICENSE\nThis project is licensed under the [MIT License](LICENSE). Feel free to modify and distribute it as per the terms of the license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrodynamic%2Fexchangequest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrodynamic%2Fexchangequest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrodynamic%2Fexchangequest/lists"}