2025-11-21 16:00:08 +03:30
2025-11-21 15:11:55 +03:30
2025-11-18 19:49:49 +03:30
2025-11-17 00:14:53 +03:30
2025-11-17 00:14:53 +03:30
2025-11-18 10:24:30 +03:30
2025-11-21 16:00:08 +03:30

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.

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, 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.

Installation

Install HedgeTech SDK via PyPI:

pip install HedgeTech

Usage

The SDK exposes all major clients through the top-level modules, so you generally do not need to import internal files like __AuthAsyncClient or __AuthSyncClient directly.

Authentication

Note: Make sure to use the matching async or sync Auth client depending on your workflow.

Async Authentication

from HedgeTech.Auth import AuthAsyncClient

auth_async_client = await AuthAsyncClient.login(
    UserName_or_Email='<YOUR UserName_or_Email>',
    Password='<YOUR Password>'
)
print(auth_client.token)

Sync Authentication

from HedgeTech.Auth import AuthSyncClient

auth_sync_client = AuthSyncClient.login(
    UserName_or_Email='<YOUR UserName_or_Email>,
    Password='<YOUR Password>'
)
print(auth_client.token)

DataEngine / TSE IFB

The DataEngine is structured to support multiple engines. Each engine can have its own async and sync clients, as well as IO types for requests and responses.

Async Data Client

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']
)
print(data)

Sync Data Client

from HedgeTech.DataEngine import DataEngine_TseIfb_SyncClient

client = DataEngine_TseIfb_SyncClient(auth_sync_client)
data = client.historical_ohlcv_by_name(
    symbolName='مهرگان',
    start_timestamp=0,
    end_timestamp='1763411432',
    AdjustedPrice=True,
    Resolution='D'
)
print(data)

Modules Overview

HedgeTech.Auth

Handles authentication for all HedgeTech clients. The async (AuthAsyncClient) and sync (AuthSyncClient) versions are exposed through the top-level Auth module.

HedgeTech.DataEngine.__tse_ifb

Handles interactions with the Tehran Stock Exchange IFB. Includes:

  • Async and sync clients for fetching market data.
  • Structured request and response types for robust and predictable data handling.
  • Designed for modular integration with other engines.

HedgeTech.DataEngine

Top-level module that initializes engines and manages imports for clients. The modular design allows adding new engines such as WebSocket clients or other future DataEngines without changing the main interface.

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.

License

This project is licensed under the MIT License. See the LICENSE file for full details.

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.

S
Description
No description provided
Readme
480 KiB
0 Stars 2 Watchers 0 Forks
2026-10-26 22:19:48 +03:30
Languages
Python 100%