Skip to main content

simple package to communicate and crawl data from tsetmc.com (Tehran Stock Exchange Website)

Project description

TSETMC-API

This library is for getting data from tsetmc website. It is divided into 5 subcomponents:

Installation

You can install this library using the following command:

pip install tsetmc-api

Examples

You can find examples of using each component in examples directory.

Component Example File
Symbol symbol_example.py
Market Watch market_watch_example.py
Day Details day_details_example.py
Market Map market_map_example.py
Group group_example.py
Async async_example.py

Usage

  • symbol: working with main symbol page and live data ( e.g. this page)
  • market_watch: getting data visible from market watch page
  • day_details: working with details of a symbol in a single day of history ( e.g. this page)
  • market_map: getting data visible in market map page
  • group: getting list of available symbol groups

Symbol Component (tsetmc_api.symbol)

Symbol Component

Market Watch Component (tsetmc_api.market_watch)

Market Watch Component

Day Details Component (tsetmc_api.day_details)

Day Details Component

Market Map Component (tsetmc_api.market_map)

Market Map Component

Group Component (tsetmc_api.group)

Group component currently only has one function (get_all_groups) which returns all the symbol groups.

Errors

Tsetmc sometimes returns 403 and you should retry.

Async Support

Each method in the library has an async counterpart with the same name and a _async suffix. These methods use the sync functions behind the scene in an asyncio pool executor.

TODO

  • Migrate symbol component to use new tsetmc.
  • Migrate market_watch component to use new tsetmc.
  • Migrate day_details component to use new tsetmc.
  • Migrate market_map component to use new tsetmc.
  • Migrate group component to use new tsetmc.
  • Support asyncio.

Support and Donation

If this repository helped you, please support it by giving a star (:star:).

For contacting me about this project please use the following email:

mahdi74sadeghi+tsetmc_api@gmail.com

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tsetmc_api-5.3.0.tar.gz (18.6 kB view details)

Uploaded Source

Built Distribution

tsetmc_api-5.3.0-py3-none-any.whl (27.8 kB view details)

Uploaded Python 3

File details

Details for the file tsetmc_api-5.3.0.tar.gz.

File metadata

  • Download URL: tsetmc_api-5.3.0.tar.gz
  • Upload date:
  • Size: 18.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.10.2 Linux/5.15.0-1039-azure

File hashes

Hashes for tsetmc_api-5.3.0.tar.gz
Algorithm Hash digest
SHA256 333948d0ed7ac71a3b72639bf06b8e49340f0199ec632519e08aa463d13aa97e
MD5 41043842e53c99b99e67e941e7c371bd
BLAKE2b-256 cf610e473c706f21a33632954fd9cc8fe239abae725357066e93f271c4f231d5

See more details on using hashes here.

File details

Details for the file tsetmc_api-5.3.0-py3-none-any.whl.

File metadata

  • Download URL: tsetmc_api-5.3.0-py3-none-any.whl
  • Upload date:
  • Size: 27.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.10.2 Linux/5.15.0-1039-azure

File hashes

Hashes for tsetmc_api-5.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 26fdffb242a6a249e80d9d4d6d831a48395558c8ae19bcd48077dc657453a5f0
MD5 a358816ccb87ac2e7d83cffb7947e311
BLAKE2b-256 c43f391c961ee5164841583471732fb73846f223f1f63cf960459d0af5cdb213

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page