28 Commits
Author SHA1 Message Date
mtrshirazi21 c8090ba334 update pyproject.toml 2026-07-22 00:09:06 +03:30
mtrshirazi21 854bee9f9e improve order edit recovery using status verification 2026-07-22 00:05:15 +03:30
mtrshirazi21 3a603db3cf add .vscode dir 2026-07-21 11:59:14 +03:30
mtrshirazi21 3906a203a6 edit version 2026-05-31 14:23:48 +03:30
mtrshirazi21 a49db4397c solve bug Generator 2026-05-31 14:23:37 +03:30
mtrshirazi21 3d947bc558 add in init files 2026-05-31 14:05:45 +03:30
mtrshirazi21 2af7dfd648 update class ime clients 2026-05-29 17:02:30 +03:30
mtrshirazi21 bde8c980ef set new beta version 2026-05-29 16:36:37 +03:30
mtrshirazi21 e63dcddbea define sync and async client in ime DE 2026-05-29 16:33:47 +03:30
mtrshirazi21 cedbd76d0e edit README and pyproject toml 2026-05-29 15:38:41 +03:30
mtrshirazi21 52be955e6e expose types 2026-05-25 19:30:05 +03:30
mtrshirazi21 ecc1070f1c defin websocket io types 2026-05-25 19:12:00 +03:30
mtrshirazi21 126eab66f7 edit io types 2026-05-25 19:11:10 +03:30
mtrshirazi21 8a5f3142ef edit io_types 2026-05-24 21:18:57 +03:30
mtrshirazi21 9cfd36a891 define io types 2026-05-24 21:18:41 +03:30
mtrshirazi21 034c9a50ea define DE IME 2026-05-24 19:27:24 +03:30
mtrshirazi21 17bea4f2a3 Modifications to the terms and conditions related to Internet force majeure during times of war. 2026-05-17 21:44:05 +03:30
mtrshirazi21 747b257432 update version 2026-02-17 17:46:56 +03:30
mtrshirazi21 e6bd5852c2 Refactor order class functions in sync and async versions for improved error handling 2026-02-17 17:46:15 +03:30
mtrshirazi21 88359c882f update version 2026-02-14 15:31:36 +03:30
mtrshirazi21 420ebda323 Add timeout for more control on Async ws 2026-02-14 15:31:08 +03:30
mtrshirazi21 83314e0074 Add timeout for more control on sync ws 2026-02-14 15:12:22 +03:30
mtrshirazi21 f6132f8044 update 0.2.3 2026-02-06 17:43:46 +03:30
mtrshirazi21 2b4e532708 edit note and email - github issue 2026-02-06 17:43:04 +03:30
mtrshirazi21 db1001111a update to Stable v 2026-02-06 00:26:28 +03:30
mtrshirazi21 f3a9dd214b update readme 2026-02-06 00:18:20 +03:30
mtrshirazi21 07ca759248 edit def docs 2026-02-05 15:30:14 +03:30
mtrshirazi21 c9799fbd7f update readme 2026-02-05 01:18:41 +03:30
14 changed files with 2708 additions and 282 deletions

No files matched your search

+3 -1
View File
@@ -208,4 +208,6 @@ __marimo__/
*.env*
*.ipynb
requirements.txt
*test*.py
*test*.py
.vscode
+349
View File
@@ -0,0 +1,349 @@
# ========================================|======================================== #
# Imports #
# ========================================|======================================== #
from asyncio import (
Event,
wait_for,
TimeoutError,
sleep,
)
from websockets.asyncio.client import connect
from json import loads
from HedgeTech.Auth import AuthAsyncClient
from typing import (
Literal,
List,
AsyncGenerator,
)
from .__io_types import (
WebsocketBase_contractName,
WebsocketBase_contractId,
OverviewResponse,
Contracts,
ContractInfoResponse,
AllowedPriceRangeResponse,
AggregateResponse,
BestLimitResponse,
)
# ========================================|======================================== #
# Class Definitions #
# ========================================|======================================== #
class DataEngine_Ime_AsyncClient:
def __init__(
self,
AuthAsyncClient : AuthAsyncClient,
):
self.__AuthAsyncClient = AuthAsyncClient
# +--------------------------------------------------------------------------------------+ #
async def search_contracts(
self,
market : Literal[
"IMEDepositCertificate",
"IMEFutures",
"IMEOption",
],
Search_char : str,
)-> Contracts :
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/static/data/contract/search',
params={
'market' : market,
'Search_char' : Search_char
}
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def contracts_static_info_by_name(self,contract_names : List[str])-> Contracts:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/static/data/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def contracts_static_info_by_id(self,contract_ids : List[str | int])-> Contracts:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/static/data/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_overview_by_name(self,contract_names : List[str])-> OverviewResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/overview/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_overview_by_id(self,contract_ids : List[str | int])-> OverviewResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/overview/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_best_limit_by_name(self,contract_names : List[str])-> BestLimitResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/best-limit/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_best_limit_by_id(self,contract_ids : List[str | int])-> BestLimitResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/best-limit/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_aggregate_by_name(self,contract_names : List[str])-> AggregateResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/aggregate/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_aggregate_by_id(self,contract_ids : List[str | int])-> AggregateResponse :
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/aggregate/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_contract_info_by_name(self,contract_names : List[str])-> ContractInfoResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/contract-info/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_contract_info_by_id(self,contract_ids : List[str | int])-> ContractInfoResponse :
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/contract-info/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_allowed_price_range_by_name(self,contract_names : List[str])-> AllowedPriceRangeResponse:
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/allowed-price-range/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def live_allowed_price_range_by_id(self,contract_ids : List[str | int])-> AllowedPriceRangeResponse :
data = await self.__AuthAsyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/allowed-price-range/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
async def websocket_by_name(
self,
contract_names: List[str],
event: Event | None = None,
)-> AsyncGenerator[
WebsocketBase_contractName,
None
]:
if not isinstance(event,Event):
event = Event()
event.set()
async with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/ime/live/data/websocket/contract/name?"
+ "&".join(f"contract_name={s}" for s in contract_names)
),
additional_headers=self.__AuthAsyncClient.token
) as ws:
while event.is_set():
try : yield loads(await wait_for(ws.recv(), timeout=2))
except TimeoutError:
await sleep(0)
continue
except Exception:
await ws.close()
break
# +--------------------------------------------------------------------------------------+ #
async def websocket_by_id(
self,
contract_ids: List[str | int],
event: Event | None = None,
)-> AsyncGenerator[
WebsocketBase_contractId,
None
]:
if not isinstance(event,Event):
event = Event()
event.set()
async with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/ime/live/data/websocket/contract/id?"
+ "&".join(f"contract_id={s}" for s in contract_ids)
),
additional_headers=self.__AuthAsyncClient.token
) as ws:
while event.is_set():
try : yield loads(await wait_for(ws.recv(), timeout=2))
except TimeoutError:
await sleep(0)
continue
except Exception:
await ws.close()
break
+339
View File
@@ -0,0 +1,339 @@
# ========================================|======================================== #
# Imports #
# ========================================|======================================== #
from threading import Event
from websockets.sync.client import connect
from json import loads
from HedgeTech.Auth import AuthSyncClient
from typing import (
Literal,
List,
Generator,
)
from .__io_types import (
WebsocketBase_contractName,
WebsocketBase_contractId,
OverviewResponse,
Contracts,
ContractInfoResponse,
AllowedPriceRangeResponse,
AggregateResponse,
BestLimitResponse,
)
# ========================================|======================================== #
# Class Definitions #
# ========================================|======================================== #
class DataEngine_Ime_SyncClient:
def __init__(
self,
AuthSyncClient : AuthSyncClient,
):
self.__AuthSyncClient = AuthSyncClient
# +--------------------------------------------------------------------------------------+ #
def search_contracts(
self,
market : Literal[
"IMEDepositCertificate",
"IMEFutures",
"IMEOption",
],
Search_char : str,
)-> Contracts :
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/static/data/contract/search',
params={
'market' : market,
'Search_char' : Search_char
}
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def contracts_static_info_by_name(self,contract_names : List[str])-> Contracts:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/static/data/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def contracts_static_info_by_id(self,contract_ids : List[str | int])-> Contracts:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/static/data/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_overview_by_name(self,contract_names : List[str])-> OverviewResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/overview/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_overview_by_id(self,contract_ids : List[str | int])-> OverviewResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/overview/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_best_limit_by_name(self,contract_names : List[str])-> BestLimitResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/best-limit/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_best_limit_by_id(self,contract_ids : List[str | int])-> BestLimitResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/best-limit/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_aggregate_by_name(self,contract_names : List[str])-> AggregateResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/aggregate/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_aggregate_by_id(self,contract_ids : List[str | int])-> AggregateResponse :
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/aggregate/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_contract_info_by_name(self,contract_names : List[str])-> ContractInfoResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/contract-info/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_contract_info_by_id(self,contract_ids : List[str | int])-> ContractInfoResponse :
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/contract-info/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_allowed_price_range_by_name(self,contract_names : List[str])-> AllowedPriceRangeResponse:
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/allowed-price-range/contract/name',
params=[('contract_names', name) for name in contract_names]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def live_allowed_price_range_by_id(self,contract_ids : List[str | int])-> AllowedPriceRangeResponse :
data = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/data-engine/ime/live/data/allowed-price-range/contract/id',
params=[('contract_ids', id) for id in contract_ids]
)
if data.is_success :
return data.json()
else :
raise ValueError(data.json().get('detail'))
# +--------------------------------------------------------------------------------------+ #
def websocket_by_name(
self,
contract_names: List[str],
event: Event | None = None,
)-> Generator[
WebsocketBase_contractName,
None,
None
]:
if not isinstance(event,Event):
event = Event()
event.set()
with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/ime/live/data/websocket/contract/name?"
+ "&".join(f"contract_name={s}" for s in contract_names)
),
additional_headers=self.__AuthSyncClient.token
) as ws:
while event.is_set():
try : yield loads(ws.recv(timeout=2))
except TimeoutError : continue
except Exception:
ws.close()
break
# +--------------------------------------------------------------------------------------+ #
def websocket_by_id(
self,
contract_ids: List[str | int],
event: Event | None = None,
)-> Generator[
WebsocketBase_contractId,
None,
None
]:
if not isinstance(event,Event):
event = Event()
event.set()
with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/ime/live/data/websocket/contract/id?"
+ "&".join(f"contract_id={s}" for s in contract_ids)
),
additional_headers=self.__AuthSyncClient.token
) as ws:
while event.is_set():
try : yield loads(ws.recv(timeout=2))
except TimeoutError : continue
except Exception:
ws.close()
break
+2
View File
@@ -0,0 +1,2 @@
from .__AsyncClient import DataEngine_Ime_AsyncClient
from .__SyncClient import DataEngine_Ime_SyncClient
@@ -0,0 +1,12 @@
from .__response import(
WebsocketBase_contractName,
WebsocketBase_contractId,
OverviewResponse,
Contracts,
ContractInfoResponse,
AllowedPriceRangeResponse,
AggregateResponse,
BestLimitResponse,
)
File diff suppressed because it is too large. Load diff
+4
View File
@@ -1,4 +1,8 @@
from .__tse_ifb import (
DataEngine_TseIfb_SyncClient,
DataEngine_TseIfb_AsyncClient
)
from .__ime import (
DataEngine_Ime_SyncClient,
DataEngine_Ime_AsyncClient
)
+24 -11
View File
@@ -2,7 +2,12 @@
# Imports #
# ========================================|======================================== #
from asyncio import Event
from asyncio import (
Event,
wait_for,
TimeoutError,
sleep,
)
from websockets.asyncio.client import connect
from json import loads
from HedgeTech.Auth import AuthAsyncClient
@@ -1461,7 +1466,7 @@ class DataEngine_TseIfb_AsyncClient:
... print(update["data"])
"""
if event is None :
if not isinstance(event,Event):
event = Event()
event.set()
@@ -1473,12 +1478,16 @@ class DataEngine_TseIfb_AsyncClient:
),
additional_headers=self.__AuthAsyncClient.token
) as ws:
while event.is_set():
try:
yield loads(await ws.recv())
except :
try : yield loads(await wait_for(ws.recv(), timeout=2))
except TimeoutError:
await sleep(0)
continue
except Exception:
await ws.close()
break
@@ -1566,10 +1575,10 @@ class DataEngine_TseIfb_AsyncClient:
... print(update["data"])
"""
if event is None :
if not isinstance(event,Event):
event = Event()
event.set()
async with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/tse-ifb/live/data/websocket/symbol/isin?"
@@ -1581,8 +1590,12 @@ class DataEngine_TseIfb_AsyncClient:
while event.is_set():
try:
yield loads(await ws.recv())
except :
try: yield loads(await wait_for(ws.recv(), timeout=2))
except TimeoutError:
await sleep(0)
continue
except Exception:
await ws.close()
break
+10 -11
View File
@@ -1425,10 +1425,10 @@ class DataEngine_TseIfb_SyncClient:
... print(update) # This will not run; method is not implemented
"""
if event is None :
if not isinstance(event,Event):
event = Event()
event.set()
with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/tse-ifb/live/data/websocket/symbol/name?"
@@ -1440,13 +1440,12 @@ class DataEngine_TseIfb_SyncClient:
while event.is_set():
try :
yield loads(ws.recv())
except :
try : yield loads(ws.recv(timeout=2))
except TimeoutError : continue
except Exception:
ws.close()
break
# +--------------------------------------------------------------------------------------+ #
def websocket_by_isin(
@@ -1520,10 +1519,10 @@ class DataEngine_TseIfb_SyncClient:
... print(update) # This will not run; method is not implemented
"""
if event is None :
if not isinstance(event,Event):
event = Event()
event.set()
with connect(
uri=(
f"wss://core.hedgetech.ir/data-engine/tse-ifb/live/data/websocket/symbol/isin?"
@@ -1535,8 +1534,8 @@ class DataEngine_TseIfb_SyncClient:
while event.is_set():
try :
yield loads(ws.recv())
except :
try : yield loads(ws.recv(timeout=2))
except TimeoutError : continue
except Exception:
ws.close()
break
@@ -9,6 +9,7 @@ from typing import (
Dict,
Optional,
TypedDict,
Literal,
)
# ========================================|======================================== #
@@ -37,7 +38,15 @@ class WebsocketBase_symbolIsin(TypedDict):
>>> message["symbolIsin"]
'IR0001234567'
"""
channel: str
channel: Literal[
"best-limit",
"order-book",
"ohlcv-last-1m",
"aggregate",
"institutional-vs-individual",
"contract-info",
"fund-info",
]
symbolIsin: str
timestamp: str
@@ -64,7 +73,15 @@ class WebsocketBase_symbolName(TypedDict):
>>> message["symbolName"]
'ETF001'
"""
channel: str
channel: Literal[
"best-limit",
"order-book",
"ohlcv-last-1m",
"aggregate",
"institutional-vs-individual",
"contract-info",
"fund-info",
]
symbolName: str
timestamp: str
@@ -734,7 +751,6 @@ class Instruments(TypedDict):
# +--------------------------------------------------------------------------------------+ #
class BestLimitItem(TypedDict):
"""
Represents the best limit order information at a given price level for a financial instrument.
@@ -766,39 +782,6 @@ class BestLimitItem(TypedDict):
sell_quantity: int
sell_price: int
class BestLimit(TypedDict):
"""
Represents the aggregated best limit orders for multiple instruments.
The structure is a nested dictionary where the first key is typically a symbol
identifier (ISIN or symbolName) and the second key represents the order level or priority.
Attributes:
items (Dict[str, Dict[str, BestLimitItem]]): Nested dictionary of BestLimitItem objects.
- Outer key: Instrument identifier (e.g., ISIN or symbolName)
- Inner key: Price level or order priority
- Value: BestLimitItem for that level
Example:
>>> best_limit: BestLimit = {
... "ETF001": {
... "1": {
... "buy_order_count": 5,
... "buy_quantity": 1000,
... "buy_price": 12000,
... "sell_order_count": 3,
... "sell_quantity": 800,
... "sell_price": 12100
... }
... }
... }
>>> best_limit["ETF001"]["1"]["sell_quantity"]
800
"""
items: Dict[str, Dict[str, BestLimitItem]]
class BestLimitResponse(TypedDict):
"""
Response structure for best limit orders from a REST API call.
@@ -810,7 +793,18 @@ class BestLimitResponse(TypedDict):
Example:
>>> response: BestLimitResponse = {
... "Data": best_limit,
... "Data": {
... "ETF001": {
... "1": {
... "buy_order_count": 5,
... "buy_quantity": 1000,
... "buy_price": 12000,
... "sell_order_count": 3,
... "sell_quantity": 800,
... "sell_price": 12100
... },
... },
... },
... "Status": {
... "State": True,
... "ServerTimeStamp": 1700350200.0,
@@ -825,7 +819,13 @@ class BestLimitResponse(TypedDict):
>>> response["Status"]["State"]
True
"""
Data: BestLimit
Data: Dict[
str,
Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem
]
]
Status: Status
@@ -867,7 +867,10 @@ class BestLimit_WS_symbolIsin(WebsocketBase_symbolIsin):
>>> ws_data["data"]["1"]["sell_price"]
12100
"""
data: Dict[str, BestLimitItem]
data: Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem,
]
class BestLimit_WS_symbolName(WebsocketBase_symbolName):
@@ -908,7 +911,10 @@ class BestLimit_WS_symbolName(WebsocketBase_symbolName):
>>> ws_data["data"]["2"]["buy_price"]
11950
"""
data: Dict[str, BestLimitItem]
data: Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem,
]
# +--------------------------------------------------------------------------------------+ #
@@ -1628,7 +1634,10 @@ class OverviewSecuritiesAndFunds(SecuritiesAndFunds):
>>> overview["FundInfo"]["nav"]
12500.0
"""
BestLimit: Dict[str, BestLimitItem]
BestLimit: Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem,
]
Aggregate: Aggregate
institutional_vs_individual: institutional_vs_individual
FundInfo: FundInfo
@@ -1649,7 +1658,10 @@ class OverviewTreasuryBonds(TreasuryBonds):
FundInfo (FundInfo)
ContractInfo (ContractInfo)
"""
BestLimit: Dict[str, BestLimitItem]
BestLimit: Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem,
]
Aggregate: Aggregate
institutional_vs_individual: institutional_vs_individual
FundInfo: FundInfo
@@ -1670,7 +1682,10 @@ class OverviewStockOptions(StockOptions):
FundInfo (FundInfo)
ContractInfo (ContractInfo)
"""
BestLimit: Dict[str, BestLimitItem]
BestLimit: Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem,
]
Aggregate: Aggregate
institutional_vs_individual: institutional_vs_individual
FundInfo: FundInfo
@@ -1691,7 +1706,10 @@ class OverviewStockFuturess(StockFutures):
FundInfo (FundInfo)
ContractInfo (ContractInfo)
"""
BestLimit: Dict[str, BestLimitItem]
BestLimit: Dict[
Literal['1','2','3','4','5','6',],
BestLimitItem,
]
Aggregate: Aggregate
institutional_vs_individual: institutional_vs_individual
FundInfo: FundInfo
@@ -1728,7 +1746,8 @@ class OverviewResponse:
True
"""
Data : Dict[
str,Optional[
str,
Optional[
Union[
OverviewSecuritiesAndFunds,
OverviewTreasuryBonds,
+161 -79
View File
@@ -93,6 +93,13 @@ class Order:
self.Price : int = Price
self.Volume : int = Volume
self.is_deleted : bool = False
self.OrderStatus : Literal[
None,
'InQueue' ,
'Cancelled',
'Broken',
'Settled',
]
self.OrderId : HexUUID | None = None
@@ -118,20 +125,24 @@ class Order:
'953097ac6ced45ca8ef205b76ca6faf2'
"""
if self.OrderId is None :
try :
SendOrder_Response = await self.__AuthASyncClient.httpx_Client.post(**self.__SendOrder_RequestInfo)
if self.OrderId is None :
match SendOrder_Response.status_code :
SendOrder_Response = await self.__AuthASyncClient.httpx_Client.post(**self.__SendOrder_RequestInfo)
case 200 :
match SendOrder_Response.status_code :
self.OrderId = SendOrder_Response.json()['Data']['order_uuid']
return None
case _ : return None
else : return None
case 200 :
self.OrderId = SendOrder_Response.json()['Data']['order_uuid']
return None
case _ : return None
else : return None
except : return None
# +--------------------------------------------------------------------------------------+ #
async def Edit(
@@ -169,41 +180,75 @@ class Order:
Example
-------
>>> await order.Edit(Price=105, Volume=15)
>>> await order.Edit(
Price = 105,
Volume = 15,
Order_ValidityType = 'GTD',
ValidityDate = 20271206
)
"""
if self.OrderId is not None:
try :
if self.OrderId is not None:
Edit_response = await self.__AuthASyncClient.httpx_Client.patch(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/edit',
data={
'order_uuid' : self.OrderId,
'Order_ValidityType' : Order_ValidityType,
'ValidityDate' : ValidityDate,
'Price' : Price,
'Volume' : Volume
}
)
match Edit_response.status_code:
case 200:
Edit_response = Edit_response.json()
self.OrderId = Edit_response['Data']['order_uuid']
self.ValidityType = Edit_response['Data']['order_validity_type']
self.ValidityDate = ValidityDate
self.Price = Edit_response['Data']['order_price']
self.Volume = Edit_response['Data']['order_volume']
self.OrderStatus = 'InQueue'
return None
case _ :
status_respnse = await self.Status()
if status_respnse and (
status_respnse['order_status'] == 'InQueue'
and status_respnse['RemainedVolume'] + status_respnse['ExecutedVolume'] == Volume
and status_respnse['Price'] == Price
and status_respnse['ValidityDate'] == ValidityDate
and status_respnse['ValidityType'] == Order_ValidityType
):
self.ValidityType = status_respnse['ValidityType']
self.ValidityDate = status_respnse['ValidityDate']
self.Price = status_respnse['Price']
self.Volume = status_respnse['RemainedVolume'] + status_respnse['ExecutedVolume']
self.OrderStatus = 'InQueue'
return None
elif status_respnse and status_respnse['order_status'] != 'InQueue' :
self.OrderStatus = status_respnse['order_status']
return None
else : return None
else : return None
except : return None
Edit_response = await self.__AuthASyncClient.httpx_Client.patch(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/edit',
data={
'order_uuid' : self.OrderId,
'Order_ValidityType' : Order_ValidityType,
'ValidityDate' : ValidityDate,
'Price' : Price,
'Volume' : Volume
}
)
match Edit_response.status_code:
case 200:
Edit_response = Edit_response.json()
self.OrderId = Edit_response['Data']['order_uuid']
self.ValidityType = Edit_response['Data']['order_validity_type']
self.ValidityDate = ValidityDate
self.Price = Edit_response['Data']['order_price']
self.Volume = Edit_response['Data']['order_volume']
return None
case _ : return None
else : return None
# +--------------------------------------------------------------------------------------+ #
async def Status(self)-> OrderStatus | None:
@@ -241,24 +286,27 @@ class Order:
'ValidityDate': 0
}
"""
if self.OrderId is not None:
status_respnse = await self.__AuthASyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
params={'order_uuid' : self.OrderId}
)
try :
match status_respnse.status_code :
case 200:
return status_respnse.json()['Data']
case _ : return None
else : return None
if self.OrderId is not None:
status_respnse = await self.__AuthASyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
params={'order_uuid' : self.OrderId}
)
match status_respnse.status_code :
case 200:
return status_respnse.json()['Data']
case _ : return None
else : return None
except : return None
# +--------------------------------------------------------------------------------------+ #
async def Delete(self)-> None:
@@ -278,26 +326,30 @@ class Order:
>>> print(order.is_deleted)
True
"""
if self.OrderId is not None:
Delete_respnse = await self.__AuthASyncClient.httpx_Client.delete(
url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
params={'order_uuid' : self.OrderId}
)
try :
match Delete_respnse.status_code :
if self.OrderId is not None:
Delete_respnse = await self.__AuthASyncClient.httpx_Client.delete(
url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
params={'order_uuid' : self.OrderId}
)
case 200:
self.is_deleted = True
return None
case _ : return None
else : return None
match Delete_respnse.status_code :
case 200:
self.is_deleted = True
return None
case _ : return None
else : return None
except : return None
# ================================================================================= #
class EmsEngine_TseIfb_AsyncClient:
@@ -364,6 +416,7 @@ class EmsEngine_TseIfb_AsyncClient:
OMS : Literal[
'Omex | Parsian',
'Sahra | Karamad',
'Sahra | NIBB',
]
)-> ImageFile:
@@ -405,6 +458,7 @@ class EmsEngine_TseIfb_AsyncClient:
async def oms_login(
self,
*,
username: str,
password: str,
captcha_value: str,
@@ -433,7 +487,11 @@ class EmsEngine_TseIfb_AsyncClient:
Example
-------
>>> await client.oms_login("user123", "pass123", "abcd")
>>> await client.oms_login(
username = "user123",
password = "pass123",
captcha_value = "abcd"
)
>>> print(client.oms_session)
'session_token_here'
"""
@@ -509,7 +567,13 @@ class EmsEngine_TseIfb_AsyncClient:
Example
-------
>>> order = await client.Buy_by_Name(symbolName="اطلس", Price=100000, Volume=10)
>>> order = await client.Buy_by_Name(
symbolName="اطلس",
Price=100000,
Volume=10,
Order_ValidityType = 'DAY',
ValidityDate = 0
)
>>> await order.send()
"""
@@ -581,7 +645,13 @@ class EmsEngine_TseIfb_AsyncClient:
Example
-------
>>> order = await client.Sell_by_Name(symbolName="اطلس", Price=100000, Volume=10)
>>> order = await client.Sell_by_Name(
symbolName="اطلس",
Price=100000,
Volume=10,
Order_ValidityType = 'DAY',
ValidityDate = 0
)
>>> await order.send()
"""
@@ -652,7 +722,13 @@ class EmsEngine_TseIfb_AsyncClient:
Example
-------
>>> order = await client.Buy_by_isin(symbolIsin="اطلس", Price=100000, Volume=10)
>>> order = await client.Buy_by_isin(
symbolName="اطلس",
Price=100000,
Volume=10,
Order_ValidityType = 'DAY',
ValidityDate = 0
)
>>> await order.send()
"""
@@ -723,7 +799,13 @@ class EmsEngine_TseIfb_AsyncClient:
Example
-------
>>> order = await client.Sell_by_isin(symbolIsin="اطلس", Price=100000, Volume=10)
>>> order = await client.Sell_by_isin(
symbolName="اطلس",
Price=100000,
Volume=10,
Order_ValidityType = 'DAY',
ValidityDate = 0
)
>>> await order.send()
"""
+139 -72
View File
@@ -92,6 +92,13 @@ class Order:
self.Price : int = Price
self.Volume : int = Volume
self.is_deleted : bool = False
self.OrderStatus : Literal[
None,
'InQueue' ,
'Cancelled',
'Broken',
'Settled',
]
self.OrderId : HexUUID | None = None
@@ -122,20 +129,24 @@ class Order:
'0xA23F...'
"""
if self.OrderId is None :
SendOrder_Response = self.__AuthSyncClient.httpx_Client.post(**self.__SendOrder_RequestInfo)
try :
match SendOrder_Response.status_code :
if self.OrderId is None :
SendOrder_Response = self.__AuthSyncClient.httpx_Client.post(**self.__SendOrder_RequestInfo)
case 200 :
match SendOrder_Response.status_code :
self.OrderId = SendOrder_Response.json()['Data']['order_uuid']
return None
case _ : return None
case 200 :
self.OrderId = SendOrder_Response.json()['Data']['order_uuid']
return None
case _ : return None
else : return None
else : return None
except : return None
# +--------------------------------------------------------------------------------------+ #
@@ -181,40 +192,74 @@ class Order:
Examples
--------
>>> order.Edit(Price=12500, Volume=800)
>>> order.Edit(
Price = 105,
Volume = 15,
Order_ValidityType = 'GTD',
ValidityDate = 20271206
)
"""
if self.OrderId is not None:
try :
Edit_response = self.__AuthSyncClient.httpx_Client.patch(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/edit',
data={
'order_uuid' : self.OrderId,
'Order_ValidityType' : Order_ValidityType,
'ValidityDate' : ValidityDate,
'Price' : Price,
'Volume' : Volume
}
)
if self.OrderId is not None:
match Edit_response.status_code:
Edit_response = self.__AuthSyncClient.httpx_Client.patch(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/edit',
data={
'order_uuid' : self.OrderId,
'Order_ValidityType' : Order_ValidityType,
'ValidityDate' : ValidityDate,
'Price' : Price,
'Volume' : Volume
}
)
case 200:
match Edit_response.status_code:
Edit_response = Edit_response.json()
self.OrderId = Edit_response['Data']['order_uuid']
self.ValidityType = Edit_response['Data']['order_validity_type']
self.ValidityDate = ValidityDate
self.Price = Edit_response['Data']['order_price']
self.Volume = Edit_response['Data']['order_volume']
return None
case _ : return None
else : return None
case 200:
Edit_response = Edit_response.json()
self.OrderId = Edit_response['Data']['order_uuid']
self.ValidityType = Edit_response['Data']['order_validity_type']
self.ValidityDate = ValidityDate
self.Price = Edit_response['Data']['order_price']
self.Volume = Edit_response['Data']['order_volume']
self.OrderStatus = 'InQueue'
return None
case _ :
status_respnse = self.Status()
if status_respnse and (
status_respnse['order_status'] == 'InQueue'
and status_respnse['RemainedVolume'] + status_respnse['ExecutedVolume'] == Volume
and status_respnse['Price'] == Price
and status_respnse['ValidityDate'] == ValidityDate
and status_respnse['ValidityType'] == Order_ValidityType
):
self.ValidityType = status_respnse['ValidityType']
self.ValidityDate = status_respnse['ValidityDate']
self.Price = status_respnse['Price']
self.Volume = status_respnse['RemainedVolume'] + status_respnse['ExecutedVolume']
self.OrderStatus = 'InQueue'
return None
elif status_respnse and status_respnse['order_status'] != 'InQueue' :
self.OrderStatus = status_respnse['order_status']
return None
else : return None
else : return None
except : return None
# +--------------------------------------------------------------------------------------+ #
@@ -305,22 +350,26 @@ class Order:
}
"""
if self.OrderId is not None:
status_respnse = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
params={'order_uuid' : self.OrderId}
)
try :
match status_respnse.status_code :
if self.OrderId is not None:
status_respnse = self.__AuthSyncClient.httpx_Client.get(
url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
params={'order_uuid' : self.OrderId}
)
case 200:
match status_respnse.status_code :
return status_respnse.json()['Data']
case 200:
return status_respnse.json()['Data']
case _ : return None
case _ : return None
else : return None
else : return None
except : return None
# +--------------------------------------------------------------------------------------+ #
@@ -346,24 +395,28 @@ class Order:
True
"""
if self.OrderId is not None:
Delete_respnse = self.__AuthSyncClient.httpx_Client.delete(
url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
params={'order_uuid' : self.OrderId}
)
match Delete_respnse.status_code :
case 200:
self.is_deleted = True
return None
case _ : return None
try :
else : return None
if self.OrderId is not None:
Delete_respnse = self.__AuthSyncClient.httpx_Client.delete(
url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
params={'order_uuid' : self.OrderId}
)
match Delete_respnse.status_code :
case 200:
self.is_deleted = True
return None
case _ : return None
else : return None
except : return None
# ================================================================================= #
@@ -396,6 +449,7 @@ class EmsEngine_TseIfb_SyncClient:
OMS : Literal[
'Omex | Parsian',
'Sahra | Karamad',
'Sahra | NIBB',
]
)-> ImageFile:
@@ -436,6 +490,7 @@ class EmsEngine_TseIfb_SyncClient:
def oms_login(
self,
*,
username: str,
password: str,
captcha_value: str,
@@ -465,7 +520,11 @@ class EmsEngine_TseIfb_SyncClient:
Examples
--------
>>> client.oms_login("user1", "pass123", "A7B9")
>>> client.oms_login(
username = "user123",
password = "pass123",
captcha_value = "abcd"
)
"""
response = self.__AuthSyncClient.httpx_Client.post(
@@ -542,7 +601,9 @@ class EmsEngine_TseIfb_SyncClient:
>>> order = client.Buy_by_Name(
... symbolName="اهرم",
... Price=12000,
... Volume=1000
... Volume=1000,
... Order_ValidityType = 'DAY',
... ValidityDate = 0
... )
>>> order.send()
"""
@@ -615,7 +676,9 @@ class EmsEngine_TseIfb_SyncClient:
>>> order = client.Sell_by_Name(
... symbolName="اهرم",
... Price=12000,
... Volume=1000
... Volume=1000,
... Order_ValidityType = 'DAY',
... ValidityDate = 0
... )
>>> order.send()
"""
@@ -686,7 +749,9 @@ class EmsEngine_TseIfb_SyncClient:
>>> order = client.Buy_by_isin(
... symbolName="اهرم",
... Price=12000,
... Volume=1000
... Volume=1000,
... Order_ValidityType = 'DAY',
... ValidityDate = 0
... )
>>> order.send()
"""
@@ -757,7 +822,9 @@ class EmsEngine_TseIfb_SyncClient:
>>> order = client.Sell_by_isin(
... symbolName="اهرم",
... Price=12000,
... Volume=1000
... Volume=1000,
... Order_ValidityType = 'DAY',
... ValidityDate = 0
... )
>>> order.send()
"""
+287 -60
View File
@@ -1,149 +1,376 @@
# HedgeTech Python SDK
HedgeTech Python SDK is a professional, lightweight, and modular Python package designed to provide seamless access to HedgeTech services. The SDK is crafted for developers, data analysts, and algorithmic traders who want to interact with the Tehran Stock Exchange (TSE & IFB) using a clean, reliable, and easy-to-use API. It supports both synchronous and asynchronous workflows, offering maximum flexibility and performance for different application scenarios.
HedgeTech Python SDK is a professional, lightweight, and modular Python
package designed to provide seamless access to HedgeTech services. The
SDK is crafted for developers, data analysts, and algorithmic traders
who want to interact with the Tehran Stock Exchange (TSE & IFB) using a
clean, reliable, and easy-to-use API.
> **Note:** This SDK requires Python >= 3.10 and is currently in Beta. Some APIs may change in future releases, but it is stable enough for daily use.
It supports both synchronous and asynchronous workflows, offering
maximum flexibility and performance for different application scenarios.
> **Note:** This SDK requires Python >= 3.10 and is production-ready.
> Development Status: **5 - Production/Stable**.
> The public APIs are stable and safe for long-term use.
------------------------------------------------------------------------
## Features
* Secure authentication with both async and sync clients.
* Real-time and historical market data retrieval from TSE & IFB.
* Modular and maintainable architecture, designed to support multiple engines (DataEngine engines, WebSocket clients, etc.).
* Structured request and response types for robust data handling.
* Fully asynchronous support for high-performance applications.
* Easy to integrate into trading bots, analytics pipelines, dashboards, or WebSocket feeds.
- Secure authentication with async and sync clients.
- Real-time and historical market data from TSE & IFB.
- Full EMS Engine order lifecycle management.
- Modular architecture (Auth, DataEngine, EMSEngine).
- Structured request/response types.
- High-performance asyncio support.
- Easy integration with trading bots and dashboards.
------------------------------------------------------------------------
## Installation
Install HedgeTech SDK via PyPI:
Install via PyPI:
```
``` bash
pip install HedgeTech
```
### Updating the Package
### Update
To update HedgeTech SDK to the latest version in your environment, use:
```
``` bash
pip install --upgrade HedgeTech
```
## Usage
------------------------------------------------------------------------
The SDK exposes all major clients through the top-level modules, so you generally do **not** need to import internal implementation files directly.
## Package Structure
### Authentication
HedgeTech/
├── Auth/
├── DataEngine/
├── EMSEngine/
└── __init__.py
> **Note:** Make sure to use the matching async or sync Auth client depending on your workflow.
------------------------------------------------------------------------
#### Async Authentication
## Authentication
```python
All services require authentication.
> Use matching Sync/Async clients.
### Async Authentication
``` python
from HedgeTech.Auth import AuthAsyncClient
auth_async_client = await AuthAsyncClient.login(
UserName_or_Email='<YOUR UserName_or_Email>',
Password='<YOUR Password>'
UserName_or_Email="user@example.com",
Password="password"
)
print(auth_async_client.token)
```
#### Sync Authentication
### Sync Authentication
```python
``` python
from HedgeTech.Auth import AuthSyncClient
auth_sync_client = AuthSyncClient.login(
UserName_or_Email='<YOUR UserName_or_Email>',
Password='<YOUR Password>'
UserName_or_Email="user@example.com",
Password="password"
)
print(auth_sync_client.token)
```
### DataEngine / TSE IFB
------------------------------------------------------------------------
The DataEngine is designed to support multiple engines in a modular way. Each engine provides its own async and sync clients, structured request and response types, and can be integrated with other engines such as WebSocket clients.
## DataEngine (Market Data)
> **Important Note on Sync vs Async:** All clients have the **same method names and behavior** in both Sync and Async versions. The only difference is how they execute: Sync runs in a blocking manner, while Async requires `await` and an event loop. This design allows you to switch between Sync and Async without changing the logic or input/output of your code.
The DataEngine module provides unified access to:
#### Async Data Client
- Live market data
- Historical OHLCV
- Order books
- Best limits
- WebSocket streams
```python
All engines follow identical Sync/Async APIs.
------------------------------------------------------------------------
### Async Data Example
``` python
from HedgeTech.DataEngine import DataEngine_TseIfb_AsyncClient
client = DataEngine_TseIfb_AsyncClient(auth_async_client)
data = await client.live_best_limit_by_isin(
symbol_isins=['IRT1AHRM0001','IRO1IKCO0001']
symbol_isins=["IRT1AHRM0001","IRO1IKCO0001"]
)
print(data)
# websocket Example
async for update in client.websocket_by_name(
channels=["best-limit", "order-book"],
channels=["best-limit","order-book"],
symbol_names=["فملی","اطلس"]
):
print(update["data"])
```
#### Sync Data Client
------------------------------------------------------------------------
```python
### Sync Data Example
``` python
from HedgeTech.DataEngine import DataEngine_TseIfb_SyncClient
client = DataEngine_TseIfb_SyncClient(auth_sync_client)
data = client.historical_ohlcv_by_name(
symbolName='مهرگان',
symbolName="مهرگان",
start_timestamp=0,
end_timestamp='1763411432',
end_timestamp="1763411432",
AdjustedPrice=True,
Resolution='D'
Resolution="D"
)
print(data)
# websocket Example
for update in client.websocket_by_isin(
channels=["best-limit", "order-book"],
channels=["best-limit","order-book"],
symbol_isins=["IR1234567890"]
):
print(update["data"])
```
## Important Notes for Users
------------------------------------------------------------------------
* This SDK requires Python >=3.10.
* The SDK is currently in **Beta** — APIs may change in future releases, but it is usable for most workflows.
* Always install dependencies with the specified versions to avoid compatibility issues.
* Async clients require an asyncio event loop.
* All main clients are exposed through top-level modules; you do not need to access internal files.
* Keywords and classifiers are chosen to make the SDK easy to find for developers working in finance, trading, and data analysis.
## EMSEngine (Order Management)
The EMSEngine module handles complete order management.
Supported markets: - TSE - IFB
------------------------------------------------------------------------
### EMSEngine Features
- Buy/Sell by Name or ISIN
- Edit Orders
- Cancel/Delete Orders
- Real-time Status
- Async/Sync Compatibility
- Order Object Lifecycle
------------------------------------------------------------------------
## Order Lifecycle
1. Create Order
2. Send
3. Monitor Status
4. Edit (Optional)
5. Settle or Delete
------------------------------------------------------------------------
## Async Trading Example
``` python
from HedgeTech.EMSEngine import EmsEngine_TseIfb_AsyncClient
ems = EmsEngine_TseIfb_AsyncClient(auth_async_client)
captcha = await ems.Get_Captcha("Omex | Parsian")
captcha.show()
await ems.oms_login(
username="user",
password="pass",
captcha_value="1234"
)
order = await ems.Buy_by_Name(
symbolName="اطلس",
Price=100000,
Volume=10
)
await order.send()
status = await order.Status()
print(status)
await order.Edit(Price=105000, Volume=12)
await order.Delete()
```
------------------------------------------------------------------------
## Sync Trading Example
``` python
from HedgeTech.EMSEngine import EmsEngine_TseIfb_SyncClient
ems = EmsEngine_TseIfb_SyncClient(auth_sync_client)
captcha = ems.Get_Captcha("Omex | Parsian")
captcha.show()
ems.oms_login(
username="user",
password="pass",
captcha_value="1234"
)
order = ems.Sell_by_Name(
symbolName="فملی",
Price=50000,
Volume=5
)
order.send()
status = order.Status()
print(status)
order.Edit(Price=52000, Volume=6)
order.Delete()
```
------------------------------------------------------------------------
## Unified API Design
All Sync and Async clients share:
- Same method names
- Same parameters
- Same return types
Only execution model differs.
This enables seamless switching between modes.
------------------------------------------------------------------------
## Error Handling
- Invalid credentials raise ValueError
- Network errors should be handled by user
- Failed requests may return None
Recommended: wrap calls in try/except.
------------------------------------------------------------------------
## Performance
- Non-blocking Async I/O
- Connection pooling
- Optimized request batching
- Suitable for HFT and Algo Trading
------------------------------------------------------------------------
## Security
- JWT Authentication
- Encrypted Transport (HTTPS)
- No password storage
- Session isolation
------------------------------------------------------------------------
## Best Practices
- Refresh tokens regularly
- Monitor order status
- Avoid duplicate send()
- Validate inputs
- Log critical operations
------------------------------------------------------------------------
## Modules Overview
### HedgeTech.Auth
Handles authentication for all HedgeTech clients. The async (`AuthAsyncClient`) and sync (`AuthSyncClient`) clients are exposed through the top-level Auth module.
Provides:
- AuthAsyncClient
- AuthSyncClient
- Token management
- Session handling
------------------------------------------------------------------------
### HedgeTech.DataEngine
Handles interactions with the Tehran Stock Exchange IFB and other engines. Provides:
Provides:
* Async and sync clients for fetching market data.
* Structured request and response types for predictable and robust data handling.
* Modular design that allows integration of additional engines, such as WebSocket clients or future data engines, without modifying the main interface.
- Market data APIs
- Historical data
- WebSocket feeds
- Modular engine design
------------------------------------------------------------------------
### HedgeTech.EMSEngine
Provides:
- EmsEngine_TseIfb_AsyncClient
- EmsEngine_TseIfb_SyncClient
- Order class
- Lifecycle management
------------------------------------------------------------------------
## Roadmap
- Auto session refresh
- Smart retry system
- Risk control module
- Order batching
- Metrics & Monitoring
- Strategy framework
------------------------------------------------------------------------
## Contributing
We welcome contributions from the community! Please follow standard Python coding conventions, write clear documentation for any new features, and submit pull requests for improvements or bug fixes.
We welcome contributions.
Guidelines:
- Follow PEP8
- Add tests
- Update documentation
- Submit Pull Requests
------------------------------------------------------------------------
## License
This project is licensed under the **Apache License 2.0**. See the LICENSE file for full details.
Licensed under Apache License 2.0.
See LICENSE file.
------------------------------------------------------------------------
## Support
For questions or issues, please open a GitHub issue or contact the HedgeTech team directly. We aim to provide timely support and guidance for all developers using the SDK.
GitHub Issues: https://gitea.hedgetech.ir/HedgeTech/HedgeTech/issues
Email: info@hedgetech.ir
------------------------------------------------------------------------
© 2026 HedgeTech. All rights reserved.
+3 -3
View File
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "HedgeTech"
version = "0.2.2b0"
version = "0.3.1b1"
description = "A unified, high-performance API layer that powers all trading infrastructure across the HedgeTech ecosystem, providing modular, scalable, and real-time interfaces for market data, order management, and execution systems."
readme = "README.md"
requires-python = ">=3.10"
@@ -59,5 +59,5 @@ dependencies = [
[project.urls]
Homepage = "https://hedgetech.ir/landing/"
Documentation = "https://github.com/HedgeTech-ir/HedgeTech/blob/main/README.md"
Repository = "https://github.com/HedgeTech-ir/HedgeTech"
Documentation = "https://gitea.hedgetech.ir/HedgeTech/HedgeTech/src/branch/main/README.md"
Repository = "https://gitea.hedgetech.ir/HedgeTech/HedgeTech"