Skip to main content
Glama
Kirillov808

moex-iss

by Kirillov808
README.md
# moex_iss

Клиент к MOEX ISS (Информационно-статистический сервер Московской биржи) для акций и облигаций.
Написан только на стандартной библиотеке Python 3.10+ и работает без ключа API.

```bash
python -m moex_iss quote SBER
python -m moex_iss history SU26238RMFS4 --from 2025-01-01 --format csv --out ofz.csv
python path/to/MOEX_ISS/moex.py quote SBER    # то же из любой директории
python -m unittest discover -s tests -v        # живые тесты: API, контракт CLI, примеры из документации
python scripts/verify_data.py                  # самопроверка: свежесть, согласованность, пересчёт НКД/доходности
python scripts/check_routes.py                 # проверка всех роутов ISS -> docs/ROUTES_STATUS.md
```

```python
from moex_iss import MoexISS
iss = MoexISS()
iss.quote("SBER"); iss.candles("GAZP", 60, "2026-09-22"); iss.bondization("RU000A104JQ3")
```

MCP-сервер для Claude Desktop/Cowork: `mcp_server.py` (запись в `claude_desktop_config.json`:
`"moex-iss": {"command": "<python.exe>", "args": ["<путь>/mcp_server.py"]}`).

- [AGENTS.md](AGENTS.md) — инструкция для агентов и людей: выбор метода, интерпретация данных, рецепты.
- [docs/ROUTES.md](docs/ROUTES.md) — каталог проверенных роутов для акций и облигаций.
- [docs/ROUTES_STATUS.md](docs/ROUTES_STATUS.md) — автоотчёт по всем 255 роутам справочника ISS.

## Дисклеймер

Проект неофициальный и не связан с ПАО Московская Биржа. Данные принадлежат Московской бирже;
их использование регулируется условиями биржи. Без подписки
котировки отдаются с задержкой около 15 минут. Проект не является инвестиционной рекомендацией.

## Лицензия

[MIT](LICENSE)

TDQS

A3.7/5.0

Scored across 15 tools

Disambiguation4/5

Each tool targets a distinct resource or axis (quotes vs. security card vs. market-wide snapshot; per-security history vs. per-date history vs. bond yield history), and descriptions explicitly clarify the boundaries. Minor potential for confusion between moex_quote and moex_market_snapshot, and among the history-family tools, but the guidance is clear enough to avoid misselection.

Naming Consistency5/5

All 15 tools use a uniform moex_ snake_case convention with descriptive, self-explanatory suffixes. There is no mixing of camelCase or divergent styles, so the naming is fully predictable.

Tool Count5/5

15 tools is well-scoped for a comprehensive exchange-data API covering quotes, search, candles, trades, history, and bond analytics. Each tool earns its place with no obvious redundancy or filler.

Completeness5/5

The surface covers the full lifecycle of market data: discovery (search/security), live quotes, snapshots, candles, trades, daily history, bond payment/yield analytics, yield curves, and index constituents. moex_raw provides an escape hatch for uncovered ISS routes and moex_selfcheck adds data-integrity validation, leaving no significant dead ends.

Maintenance

ActivityMaintained
ResponsivenessNo issues