moex-iss
# 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
Scored across 15 tools
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.
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.
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.
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.