moex-iss-client 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of moex-iss-client might be problematic. Click here for more details.
- moex_iss_client-0.1.0/PKG-INFO +176 -0
- moex_iss_client-0.1.0/README.md +154 -0
- moex_iss_client-0.1.0/pyproject.toml +71 -0
- moex_iss_client-0.1.0/pyproject.toml.orig +64 -0
- moex_iss_client-0.1.0/src/moex_iss_client/__init__.py +40 -0
- moex_iss_client-0.1.0/src/moex_iss_client/auth.py +98 -0
- moex_iss_client-0.1.0/src/moex_iss_client/client.py +313 -0
- moex_iss_client-0.1.0/src/moex_iss_client/endpoints/__init__.py +5 -0
- moex_iss_client-0.1.0/src/moex_iss_client/endpoints/candles.py +157 -0
- moex_iss_client-0.1.0/src/moex_iss_client/endpoints/securities.py +111 -0
- moex_iss_client-0.1.0/src/moex_iss_client/exceptions.py +23 -0
- moex_iss_client-0.1.0/src/moex_iss_client/models.py +65 -0
- moex_iss_client-0.1.0/src/moex_iss_client/utils.py +258 -0
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
Metadata-Version: 2.3
|
|
2
|
+
Name: moex-iss-client
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Python client for the MOEX Information and Statistical Server (ISS) API
|
|
5
|
+
Keywords: moex,iss,stock,futures,ohlcv,trading
|
|
6
|
+
Author: moex-iss-client contributors
|
|
7
|
+
License: MIT
|
|
8
|
+
Classifier: Development Status :: 3 - Alpha
|
|
9
|
+
Classifier: Intended Audience :: Developers
|
|
10
|
+
Classifier: Programming Language :: Python :: 3
|
|
11
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
12
|
+
Classifier: Topic :: Office/Business :: Financial :: Investment
|
|
13
|
+
Requires-Dist: httpx>=0.27
|
|
14
|
+
Requires-Dist: pytest>=8.0 ; extra == 'dev'
|
|
15
|
+
Requires-Dist: pytest-httpx>=0.30 ; extra == 'dev'
|
|
16
|
+
Requires-Dist: ruff>=0.6 ; extra == 'dev'
|
|
17
|
+
Requires-Dist: pandas>=2.0 ; extra == 'pandas'
|
|
18
|
+
Requires-Python: >=3.14
|
|
19
|
+
Provides-Extra: dev
|
|
20
|
+
Provides-Extra: pandas
|
|
21
|
+
Description-Content-Type: text/markdown
|
|
22
|
+
|
|
23
|
+
# moex-iss-client
|
|
24
|
+
|
|
25
|
+
Python-клиент к [Информационно-статистическому серверу Московской Биржи (MOEX ISS)](http://iss.moex.com/iss/reference/).
|
|
26
|
+
|
|
27
|
+
Библиотека «чистая»: без CLI, без собственного сервера. Предназначена для импорта в другие Python-проекты.
|
|
28
|
+
|
|
29
|
+
## Возможности
|
|
30
|
+
|
|
31
|
+
- Получение OHLCV-свечей по акциям, фьючерсам и индексам за указанный период с заданным таймфреймом.
|
|
32
|
+
- Получение списка тикеров с описанием (акции, фьючерсы, индексы).
|
|
33
|
+
- Аутентификация через `passport.moex.com` (basic-auth + cookie `MicexPassportCert`), с автоматическим продлением. Библиотека работает и без авторизации — для публичных данных.
|
|
34
|
+
- Опциональный возврат `pandas.DataFrame` (`return_df=True`).
|
|
35
|
+
- Ретраи для статусов 500–504 и транспортных ошибок.
|
|
36
|
+
- Многопоточный пул (`max_workers`) заложен архитектурно; `get_ohlcv` использует последовательную пагинацию (см. раздел «Пагинация»).
|
|
37
|
+
|
|
38
|
+
## Установка
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
uv sync
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
С `pandas` (для `return_df=True`):
|
|
45
|
+
```bash
|
|
46
|
+
uv sync --extra pandas
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
С dev-зависимостями (тесты, линтер):
|
|
50
|
+
```bash
|
|
51
|
+
uv sync --extra dev --extra pandas
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Быстрый старт
|
|
55
|
+
|
|
56
|
+
```python
|
|
57
|
+
from moex_iss_client import MoexISSClient
|
|
58
|
+
|
|
59
|
+
with MoexISSClient() as client:
|
|
60
|
+
df = client.get_ohlcv(
|
|
61
|
+
"SBER",
|
|
62
|
+
timeframe="1D",
|
|
63
|
+
start="01-01-2024",
|
|
64
|
+
end="31-01-2024",
|
|
65
|
+
return_df=True,
|
|
66
|
+
)
|
|
67
|
+
print(df.head())
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Список акций:
|
|
71
|
+
```python
|
|
72
|
+
with MoexISSClient() as client:
|
|
73
|
+
df = client.get_securities("stock", return_df=True)
|
|
74
|
+
print(df[["SECID", "SHORTNAME"]].head())
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
С авторизацией:
|
|
78
|
+
```python
|
|
79
|
+
with MoexISSClient(login="...", password="...") as client:
|
|
80
|
+
df = client.get_ohlcv("SBER", "1D", start="01-01-2024", end="31-01-2024", return_df=True)
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Таймфреймы
|
|
84
|
+
|
|
85
|
+
| Обозначение | Значение | ISS `interval` |
|
|
86
|
+
|:---:|:---:|:---:|
|
|
87
|
+
| `1m` | 1 минута | 1 |
|
|
88
|
+
| `10m` | 10 минут | 10 |
|
|
89
|
+
| `1H` | 1 час | 60 |
|
|
90
|
+
| `1D` | 1 день | 24 |
|
|
91
|
+
| `1W` | 1 неделя | 7 |
|
|
92
|
+
| `1M` | 1 месяц | 31 |
|
|
93
|
+
| `1Q` | 1 квартал | 4 |
|
|
94
|
+
|
|
95
|
+
Маппинг задан в `moex_iss_client.models.ISS_INTERVAL_BY_TIMEFRAME`.
|
|
96
|
+
|
|
97
|
+
## Параметры `MoexISSClient`
|
|
98
|
+
|
|
99
|
+
| Параметр | По умолчанию | Описание |
|
|
100
|
+
|:---|:---|:---|
|
|
101
|
+
| `login` | `None` | Логин MOEX passport. |
|
|
102
|
+
| `password` | `None` | Пароль MOEX passport. |
|
|
103
|
+
| `timeout` | `30.0` | Таймаут запроса, сек. |
|
|
104
|
+
| `max_retries` | `3` | Число ретраев для 500–504 и транспортных ошибок. |
|
|
105
|
+
| `retry_backoff` | `1.0` | Базовая задержка между ретраями, сек (экспоненциальный рост). |
|
|
106
|
+
| `max_workers` | `4` | Максимум потоков для параллельных запросов. |
|
|
107
|
+
| `verify` | `True` | TLS-проверка. `True` / `False` / путь к PEM / `ssl.SSLContext`. |
|
|
108
|
+
| `trust_env` | `True` | Читать `SSL_CERT_FILE` / `REQUESTS_CA_BUNDLE` из окружения. |
|
|
109
|
+
|
|
110
|
+
## TLS и корпоративные сети
|
|
111
|
+
|
|
112
|
+
Если `passport.moex.com` или `iss.moex.com` возвращают ошибку проверки сертификата (`CERTIFICATE_VERIFY_FAILED: self-signed certificate in certificate chain`), это значит, что в цепочке есть корень, отсутствующий в `certifi`. Два типичных случая: корпоративный MITM-прокси или переход MOEX на сертификаты НУЦ Минцифры.
|
|
113
|
+
|
|
114
|
+
Варианты решения:
|
|
115
|
+
1. **Системное хранилище доверия** (рекомендуется):
|
|
116
|
+
```python
|
|
117
|
+
import ssl
|
|
118
|
+
from moex_iss_client import MoexISSClient
|
|
119
|
+
|
|
120
|
+
ctx = ssl.create_default_context()
|
|
121
|
+
with MoexISSClient(verify=ctx) as client:
|
|
122
|
+
...
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
2. **Путь к PEM-bundle:**
|
|
126
|
+
```python
|
|
127
|
+
with MoexISSClient(verify="/path/to/combined_cacert.pem") as client:
|
|
128
|
+
...
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
3. **Переменные окружения** (при `trust_env=True`, по умолчанию):
|
|
132
|
+
```bash
|
|
133
|
+
export SSL_CERT_FILE=/path/to/combined_cacert.pem
|
|
134
|
+
uv run python examples/get_ohlcv.py
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
4. **Отключение проверки** — только для локальной отладки. Вызов `MoexISSClient(verify=False)` эмитит `UserWarning`.
|
|
138
|
+
|
|
139
|
+
## Пагинация
|
|
140
|
+
|
|
141
|
+
- `get_securities` запрашивает весь список одним запросом: ISS не поддерживает пагинацию для этого эндпоинта (`start` игнорируется).
|
|
142
|
+
- `get_ohlcv` использует последовательную пагинацию через параметр `start`, поскольку блок `cursor` для `/candles` не отдаётся. Ответ содержит не более 500 строк (`CANDLES_MAX_ROWS_PER_RESPONSE`); цикл останавливается на пустой или частичной странице. Результат сортируется по колонке `begin`.
|
|
143
|
+
|
|
144
|
+
## Ограничения ISS
|
|
145
|
+
|
|
146
|
+
- Данные ранее `2000-01-01` недоступны. `get_ohlcv` валидирует даты и бросает `ValidationError`.
|
|
147
|
+
- Онлайн-данные и итоги торгов доступны по подписке. Без авторизации данные приходят с задержкой (индексы — без задержки).
|
|
148
|
+
- Формат ответа задаётся расширением в URL: `.json`, `.xml`, `.csv`, `.html`. Библиотека использует `.json`.
|
|
149
|
+
|
|
150
|
+
## Исключения
|
|
151
|
+
|
|
152
|
+
Иерархия в `moex_iss_client.exceptions`:
|
|
153
|
+
- `MoexISSError` — базовое.
|
|
154
|
+
- `ValidationError` — неверные аргументы (таймфрейм, даты).
|
|
155
|
+
- `AuthError` — ошибка аутентификации.
|
|
156
|
+
- `NotFoundError` — 404 от ISS.
|
|
157
|
+
- `TransportError` — транспортная ошибка после всех ретраев.
|
|
158
|
+
|
|
159
|
+
## Разработка
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
uv sync --extra dev --extra pandas
|
|
163
|
+
uv run ruff check
|
|
164
|
+
uv run ruff format --check
|
|
165
|
+
uv run pytest -q
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
Примеры:
|
|
169
|
+
```bash
|
|
170
|
+
uv run python examples/get_ohlcv.py
|
|
171
|
+
uv run python examples/list_securities.py
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
## Лицензия
|
|
175
|
+
|
|
176
|
+
**MIT**
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# moex-iss-client
|
|
2
|
+
|
|
3
|
+
Python-клиент к [Информационно-статистическому серверу Московской Биржи (MOEX ISS)](http://iss.moex.com/iss/reference/).
|
|
4
|
+
|
|
5
|
+
Библиотека «чистая»: без CLI, без собственного сервера. Предназначена для импорта в другие Python-проекты.
|
|
6
|
+
|
|
7
|
+
## Возможности
|
|
8
|
+
|
|
9
|
+
- Получение OHLCV-свечей по акциям, фьючерсам и индексам за указанный период с заданным таймфреймом.
|
|
10
|
+
- Получение списка тикеров с описанием (акции, фьючерсы, индексы).
|
|
11
|
+
- Аутентификация через `passport.moex.com` (basic-auth + cookie `MicexPassportCert`), с автоматическим продлением. Библиотека работает и без авторизации — для публичных данных.
|
|
12
|
+
- Опциональный возврат `pandas.DataFrame` (`return_df=True`).
|
|
13
|
+
- Ретраи для статусов 500–504 и транспортных ошибок.
|
|
14
|
+
- Многопоточный пул (`max_workers`) заложен архитектурно; `get_ohlcv` использует последовательную пагинацию (см. раздел «Пагинация»).
|
|
15
|
+
|
|
16
|
+
## Установка
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
uv sync
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
С `pandas` (для `return_df=True`):
|
|
23
|
+
```bash
|
|
24
|
+
uv sync --extra pandas
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
С dev-зависимостями (тесты, линтер):
|
|
28
|
+
```bash
|
|
29
|
+
uv sync --extra dev --extra pandas
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Быстрый старт
|
|
33
|
+
|
|
34
|
+
```python
|
|
35
|
+
from moex_iss_client import MoexISSClient
|
|
36
|
+
|
|
37
|
+
with MoexISSClient() as client:
|
|
38
|
+
df = client.get_ohlcv(
|
|
39
|
+
"SBER",
|
|
40
|
+
timeframe="1D",
|
|
41
|
+
start="01-01-2024",
|
|
42
|
+
end="31-01-2024",
|
|
43
|
+
return_df=True,
|
|
44
|
+
)
|
|
45
|
+
print(df.head())
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Список акций:
|
|
49
|
+
```python
|
|
50
|
+
with MoexISSClient() as client:
|
|
51
|
+
df = client.get_securities("stock", return_df=True)
|
|
52
|
+
print(df[["SECID", "SHORTNAME"]].head())
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
С авторизацией:
|
|
56
|
+
```python
|
|
57
|
+
with MoexISSClient(login="...", password="...") as client:
|
|
58
|
+
df = client.get_ohlcv("SBER", "1D", start="01-01-2024", end="31-01-2024", return_df=True)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Таймфреймы
|
|
62
|
+
|
|
63
|
+
| Обозначение | Значение | ISS `interval` |
|
|
64
|
+
|:---:|:---:|:---:|
|
|
65
|
+
| `1m` | 1 минута | 1 |
|
|
66
|
+
| `10m` | 10 минут | 10 |
|
|
67
|
+
| `1H` | 1 час | 60 |
|
|
68
|
+
| `1D` | 1 день | 24 |
|
|
69
|
+
| `1W` | 1 неделя | 7 |
|
|
70
|
+
| `1M` | 1 месяц | 31 |
|
|
71
|
+
| `1Q` | 1 квартал | 4 |
|
|
72
|
+
|
|
73
|
+
Маппинг задан в `moex_iss_client.models.ISS_INTERVAL_BY_TIMEFRAME`.
|
|
74
|
+
|
|
75
|
+
## Параметры `MoexISSClient`
|
|
76
|
+
|
|
77
|
+
| Параметр | По умолчанию | Описание |
|
|
78
|
+
|:---|:---|:---|
|
|
79
|
+
| `login` | `None` | Логин MOEX passport. |
|
|
80
|
+
| `password` | `None` | Пароль MOEX passport. |
|
|
81
|
+
| `timeout` | `30.0` | Таймаут запроса, сек. |
|
|
82
|
+
| `max_retries` | `3` | Число ретраев для 500–504 и транспортных ошибок. |
|
|
83
|
+
| `retry_backoff` | `1.0` | Базовая задержка между ретраями, сек (экспоненциальный рост). |
|
|
84
|
+
| `max_workers` | `4` | Максимум потоков для параллельных запросов. |
|
|
85
|
+
| `verify` | `True` | TLS-проверка. `True` / `False` / путь к PEM / `ssl.SSLContext`. |
|
|
86
|
+
| `trust_env` | `True` | Читать `SSL_CERT_FILE` / `REQUESTS_CA_BUNDLE` из окружения. |
|
|
87
|
+
|
|
88
|
+
## TLS и корпоративные сети
|
|
89
|
+
|
|
90
|
+
Если `passport.moex.com` или `iss.moex.com` возвращают ошибку проверки сертификата (`CERTIFICATE_VERIFY_FAILED: self-signed certificate in certificate chain`), это значит, что в цепочке есть корень, отсутствующий в `certifi`. Два типичных случая: корпоративный MITM-прокси или переход MOEX на сертификаты НУЦ Минцифры.
|
|
91
|
+
|
|
92
|
+
Варианты решения:
|
|
93
|
+
1. **Системное хранилище доверия** (рекомендуется):
|
|
94
|
+
```python
|
|
95
|
+
import ssl
|
|
96
|
+
from moex_iss_client import MoexISSClient
|
|
97
|
+
|
|
98
|
+
ctx = ssl.create_default_context()
|
|
99
|
+
with MoexISSClient(verify=ctx) as client:
|
|
100
|
+
...
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
2. **Путь к PEM-bundle:**
|
|
104
|
+
```python
|
|
105
|
+
with MoexISSClient(verify="/path/to/combined_cacert.pem") as client:
|
|
106
|
+
...
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
3. **Переменные окружения** (при `trust_env=True`, по умолчанию):
|
|
110
|
+
```bash
|
|
111
|
+
export SSL_CERT_FILE=/path/to/combined_cacert.pem
|
|
112
|
+
uv run python examples/get_ohlcv.py
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
4. **Отключение проверки** — только для локальной отладки. Вызов `MoexISSClient(verify=False)` эмитит `UserWarning`.
|
|
116
|
+
|
|
117
|
+
## Пагинация
|
|
118
|
+
|
|
119
|
+
- `get_securities` запрашивает весь список одним запросом: ISS не поддерживает пагинацию для этого эндпоинта (`start` игнорируется).
|
|
120
|
+
- `get_ohlcv` использует последовательную пагинацию через параметр `start`, поскольку блок `cursor` для `/candles` не отдаётся. Ответ содержит не более 500 строк (`CANDLES_MAX_ROWS_PER_RESPONSE`); цикл останавливается на пустой или частичной странице. Результат сортируется по колонке `begin`.
|
|
121
|
+
|
|
122
|
+
## Ограничения ISS
|
|
123
|
+
|
|
124
|
+
- Данные ранее `2000-01-01` недоступны. `get_ohlcv` валидирует даты и бросает `ValidationError`.
|
|
125
|
+
- Онлайн-данные и итоги торгов доступны по подписке. Без авторизации данные приходят с задержкой (индексы — без задержки).
|
|
126
|
+
- Формат ответа задаётся расширением в URL: `.json`, `.xml`, `.csv`, `.html`. Библиотека использует `.json`.
|
|
127
|
+
|
|
128
|
+
## Исключения
|
|
129
|
+
|
|
130
|
+
Иерархия в `moex_iss_client.exceptions`:
|
|
131
|
+
- `MoexISSError` — базовое.
|
|
132
|
+
- `ValidationError` — неверные аргументы (таймфрейм, даты).
|
|
133
|
+
- `AuthError` — ошибка аутентификации.
|
|
134
|
+
- `NotFoundError` — 404 от ISS.
|
|
135
|
+
- `TransportError` — транспортная ошибка после всех ретраев.
|
|
136
|
+
|
|
137
|
+
## Разработка
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
uv sync --extra dev --extra pandas
|
|
141
|
+
uv run ruff check
|
|
142
|
+
uv run ruff format --check
|
|
143
|
+
uv run pytest -q
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
Примеры:
|
|
147
|
+
```bash
|
|
148
|
+
uv run python examples/get_ohlcv.py
|
|
149
|
+
uv run python examples/list_securities.py
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
## Лицензия
|
|
153
|
+
|
|
154
|
+
**MIT**
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "moex-iss-client"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "Python client for the MOEX Information and Statistical Server (ISS) API"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.14"
|
|
7
|
+
keywords = [
|
|
8
|
+
"moex",
|
|
9
|
+
"iss",
|
|
10
|
+
"stock",
|
|
11
|
+
"futures",
|
|
12
|
+
"ohlcv",
|
|
13
|
+
"trading",
|
|
14
|
+
]
|
|
15
|
+
classifiers = [
|
|
16
|
+
"Development Status :: 3 - Alpha",
|
|
17
|
+
"Intended Audience :: Developers",
|
|
18
|
+
"Programming Language :: Python :: 3",
|
|
19
|
+
"Programming Language :: Python :: 3.14",
|
|
20
|
+
"Topic :: Office/Business :: Financial :: Investment",
|
|
21
|
+
]
|
|
22
|
+
dependencies = ["httpx>=0.27"]
|
|
23
|
+
|
|
24
|
+
[project.license]
|
|
25
|
+
text = "MIT"
|
|
26
|
+
|
|
27
|
+
[[project.authors]]
|
|
28
|
+
name = "moex-iss-client contributors"
|
|
29
|
+
|
|
30
|
+
[project.optional-dependencies]
|
|
31
|
+
pandas = ["pandas>=2.0"]
|
|
32
|
+
dev = [
|
|
33
|
+
"pytest>=8.0",
|
|
34
|
+
"pytest-httpx>=0.30",
|
|
35
|
+
"ruff>=0.6",
|
|
36
|
+
]
|
|
37
|
+
|
|
38
|
+
[build-system]
|
|
39
|
+
requires = ["uv_build>=0.13,<0.14"]
|
|
40
|
+
build-backend = "uv_build"
|
|
41
|
+
|
|
42
|
+
[tool.uv.build-backend]
|
|
43
|
+
module-name = "moex_iss_client"
|
|
44
|
+
|
|
45
|
+
[tool.ruff]
|
|
46
|
+
line-length = 100
|
|
47
|
+
target-version = "py314"
|
|
48
|
+
src = [
|
|
49
|
+
"src",
|
|
50
|
+
"tests",
|
|
51
|
+
]
|
|
52
|
+
|
|
53
|
+
[tool.ruff.lint]
|
|
54
|
+
select = [
|
|
55
|
+
"E",
|
|
56
|
+
"W",
|
|
57
|
+
"F",
|
|
58
|
+
"I",
|
|
59
|
+
"B",
|
|
60
|
+
"UP",
|
|
61
|
+
"SIM",
|
|
62
|
+
"RUF",
|
|
63
|
+
]
|
|
64
|
+
ignore = ["E501"]
|
|
65
|
+
|
|
66
|
+
[tool.ruff.lint.isort]
|
|
67
|
+
known-first-party = ["moex_iss_client"]
|
|
68
|
+
|
|
69
|
+
[tool.pytest.ini_options]
|
|
70
|
+
testpaths = ["tests"]
|
|
71
|
+
addopts = "-ra"
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "moex-iss-client"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "Python client for the MOEX Information and Statistical Server (ISS) API"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
requires-python = ">=3.14"
|
|
7
|
+
license = { text = "MIT" }
|
|
8
|
+
authors = [
|
|
9
|
+
{ name = "moex-iss-client contributors" },
|
|
10
|
+
]
|
|
11
|
+
keywords = ["moex", "iss", "stock", "futures", "ohlcv", "trading"]
|
|
12
|
+
classifiers = [
|
|
13
|
+
"Development Status :: 3 - Alpha",
|
|
14
|
+
"Intended Audience :: Developers",
|
|
15
|
+
"Programming Language :: Python :: 3",
|
|
16
|
+
"Programming Language :: Python :: 3.14",
|
|
17
|
+
"Topic :: Office/Business :: Financial :: Investment",
|
|
18
|
+
]
|
|
19
|
+
|
|
20
|
+
dependencies = [
|
|
21
|
+
"httpx>=0.27",
|
|
22
|
+
]
|
|
23
|
+
|
|
24
|
+
[project.optional-dependencies]
|
|
25
|
+
pandas = ["pandas>=2.0"]
|
|
26
|
+
dev = [
|
|
27
|
+
"pytest>=8.0",
|
|
28
|
+
"pytest-httpx>=0.30",
|
|
29
|
+
"ruff>=0.6",
|
|
30
|
+
]
|
|
31
|
+
|
|
32
|
+
[build-system]
|
|
33
|
+
requires = ["uv_build>=0.13,<0.14"]
|
|
34
|
+
build-backend = "uv_build"
|
|
35
|
+
|
|
36
|
+
[tool.uv.build-backend]
|
|
37
|
+
module-name = "moex_iss_client"
|
|
38
|
+
|
|
39
|
+
[tool.ruff]
|
|
40
|
+
line-length = 100
|
|
41
|
+
target-version = "py314"
|
|
42
|
+
src = ["src", "tests"]
|
|
43
|
+
|
|
44
|
+
[tool.ruff.lint]
|
|
45
|
+
select = [
|
|
46
|
+
"E", # pycodestyle errors
|
|
47
|
+
"W", # pycodestyle warnings
|
|
48
|
+
"F", # pyflakes
|
|
49
|
+
"I", # isort
|
|
50
|
+
"B", # flake8-bugbear
|
|
51
|
+
"UP", # pyupgrade
|
|
52
|
+
"SIM", # flake8-simplify
|
|
53
|
+
"RUF", # ruff-specific rules
|
|
54
|
+
]
|
|
55
|
+
ignore = [
|
|
56
|
+
"E501", # line length handled by formatter
|
|
57
|
+
]
|
|
58
|
+
|
|
59
|
+
[tool.ruff.lint.isort]
|
|
60
|
+
known-first-party = ["moex_iss_client"]
|
|
61
|
+
|
|
62
|
+
[tool.pytest.ini_options]
|
|
63
|
+
testpaths = ["tests"]
|
|
64
|
+
addopts = "-ra"
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
"""moex-iss-client — Python client for the MOEX ISS API.
|
|
2
|
+
|
|
3
|
+
Public API
|
|
4
|
+
----------
|
|
5
|
+
- :class:`MoexISSClient` — the main client class.
|
|
6
|
+
- Exceptions: :class:`MoexISSError`, :class:`ValidationError`, :class:`AuthError`,
|
|
7
|
+
:class:`NotFoundError`, :class:`TransportError`.
|
|
8
|
+
- Timeframe constants and helpers from :mod:`moex_iss_client.models`.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
from moex_iss_client.client import MoexISSClient
|
|
14
|
+
from moex_iss_client.exceptions import (
|
|
15
|
+
AuthError,
|
|
16
|
+
MoexISSError,
|
|
17
|
+
NotFoundError,
|
|
18
|
+
TransportError,
|
|
19
|
+
ValidationError,
|
|
20
|
+
)
|
|
21
|
+
from moex_iss_client.models import (
|
|
22
|
+
ISS_INTERVAL_BY_TIMEFRAME,
|
|
23
|
+
InstrumentType,
|
|
24
|
+
timeframe_to_interval,
|
|
25
|
+
)
|
|
26
|
+
|
|
27
|
+
__version__ = "0.1.0"
|
|
28
|
+
|
|
29
|
+
__all__ = [
|
|
30
|
+
"ISS_INTERVAL_BY_TIMEFRAME",
|
|
31
|
+
"AuthError",
|
|
32
|
+
"InstrumentType",
|
|
33
|
+
"MoexISSClient",
|
|
34
|
+
"MoexISSError",
|
|
35
|
+
"NotFoundError",
|
|
36
|
+
"TransportError",
|
|
37
|
+
"ValidationError",
|
|
38
|
+
"__version__",
|
|
39
|
+
"timeframe_to_interval",
|
|
40
|
+
]
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
"""Basic authentication and cookie management for the MOEX passport service."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import logging
|
|
6
|
+
import threading
|
|
7
|
+
|
|
8
|
+
import httpx
|
|
9
|
+
|
|
10
|
+
from moex_iss_client.exceptions import AuthError
|
|
11
|
+
from moex_iss_client.models import PASSPORT_BASE_URL
|
|
12
|
+
|
|
13
|
+
logger = logging.getLogger(__name__)
|
|
14
|
+
|
|
15
|
+
# Cookie name that the passport service sets on successful authentication.
|
|
16
|
+
PASSPORT_COOKIE_NAME = "MicexPassportCert"
|
|
17
|
+
# Header that the ISS data endpoints use to report access level.
|
|
18
|
+
PASSPORT_MARKER_HEADER = "X-MicexPassport-Marker"
|
|
19
|
+
PASSPORT_MARKER_GRANTED = "granted"
|
|
20
|
+
PASSPORT_MARKER_DENIED = "denied"
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
class PassportAuth:
|
|
24
|
+
"""Thread-safe basic-auth handler for ``passport.moex.com``.
|
|
25
|
+
|
|
26
|
+
The handler authenticates once, stores the resulting ``MicexPassportCert``
|
|
27
|
+
cookie inside the provided :class:`httpx.Client`, and can re-authenticate
|
|
28
|
+
on demand (e.g. when the ISS returns ``X-MicexPassport-Marker: denied``).
|
|
29
|
+
|
|
30
|
+
Parameters
|
|
31
|
+
----------
|
|
32
|
+
client : httpx.Client
|
|
33
|
+
Shared HTTP client whose cookie jar will receive ``MicexPassportCert``.
|
|
34
|
+
login : str
|
|
35
|
+
MOEX passport login.
|
|
36
|
+
password : str
|
|
37
|
+
MOEX passport password.
|
|
38
|
+
"""
|
|
39
|
+
|
|
40
|
+
def __init__(self, client: httpx.Client, login: str, password: str) -> None:
|
|
41
|
+
self._client = client
|
|
42
|
+
self._login = login
|
|
43
|
+
self._password = password
|
|
44
|
+
self._lock = threading.Lock()
|
|
45
|
+
self._authenticated = False
|
|
46
|
+
|
|
47
|
+
@property
|
|
48
|
+
def authenticated(self) -> bool:
|
|
49
|
+
"""Whether a successful authentication has already happened."""
|
|
50
|
+
return self._authenticated
|
|
51
|
+
|
|
52
|
+
def ensure_authenticated(self) -> None:
|
|
53
|
+
"""Authenticate if not done yet.
|
|
54
|
+
|
|
55
|
+
Thread-safe: concurrent callers block until the first authentication
|
|
56
|
+
attempt completes, then reuse its result.
|
|
57
|
+
"""
|
|
58
|
+
if self._authenticated:
|
|
59
|
+
return
|
|
60
|
+
with self._lock:
|
|
61
|
+
if self._authenticated:
|
|
62
|
+
return
|
|
63
|
+
self._do_authenticate()
|
|
64
|
+
|
|
65
|
+
def refresh(self) -> None:
|
|
66
|
+
"""Force a re-authentication (used when the ISS reports ``denied``).
|
|
67
|
+
|
|
68
|
+
Thread-safe: if several threads detect ``denied`` at the same time,
|
|
69
|
+
only the first one actually hits the passport service; the others
|
|
70
|
+
see ``_authenticated`` already reset and wait.
|
|
71
|
+
"""
|
|
72
|
+
with self._lock:
|
|
73
|
+
self._do_authenticate()
|
|
74
|
+
|
|
75
|
+
def _do_authenticate(self) -> None:
|
|
76
|
+
"""Perform the actual basic-auth request against the passport service."""
|
|
77
|
+
url = f"{PASSPORT_BASE_URL}/authenticate"
|
|
78
|
+
logger.debug("Authenticating against %s", url)
|
|
79
|
+
try:
|
|
80
|
+
response = self._client.get(url, auth=(self._login, self._password))
|
|
81
|
+
except httpx.HTTPError as exc:
|
|
82
|
+
self._authenticated = False
|
|
83
|
+
raise AuthError(f"Transport error during authentication: {exc}") from exc
|
|
84
|
+
|
|
85
|
+
if response.status_code != 200:
|
|
86
|
+
self._authenticated = False
|
|
87
|
+
raise AuthError(
|
|
88
|
+
f"Authentication failed with status {response.status_code}: {response.text[:200]!r}"
|
|
89
|
+
)
|
|
90
|
+
|
|
91
|
+
if PASSPORT_COOKIE_NAME not in self._client.cookies:
|
|
92
|
+
self._authenticated = False
|
|
93
|
+
raise AuthError(
|
|
94
|
+
f"Authentication response did not set the {PASSPORT_COOKIE_NAME} cookie"
|
|
95
|
+
)
|
|
96
|
+
|
|
97
|
+
self._authenticated = True
|
|
98
|
+
logger.debug("Authentication successful, cookie %r acquired", PASSPORT_COOKIE_NAME)
|