Skip to main content
Glama
moex-iss

moex-iss

by Kirillov808

moex_iss

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

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
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 — инструкция для агентов и людей: выбор метода, интерпретация данных, рецепты.

  • docs/ROUTES.md — каталог проверенных роутов для акций и облигаций.

  • docs/ROUTES_STATUS.md — автоотчёт по всем 255 роутам справочника ISS.

Дисклеймер

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

Related MCP server: ru-finance

Лицензия

MIT

Available Tools

15 tools
moex_bond_eventsC
Read-only

Календарь купонов/погашений/оферт ВСЕХ облигаций за период.

Inputs: end (required), start (required), columns, filename, +2 more.

moex_bondizationB
Read-only

График платежей облигации: coupons (coupondate, value руб — None если не определён, valueprc %), amortizations (amortdate, value), offers (offerdate, price, offertype).

Inputs: secid (required), columns, filename, save_csv, +1 more.

moex_bond_yields_historyB
Read-only

История доходностей облигации: TRADEDATE, PRICE, EFFECTIVEYIELD, DURATION, ZSPREADBP, GSPREADBP, YIELDDATETYPE.

Inputs: secid (required), start (required), end, columns, +3 more.

moex_candlesA
Read-only

Свечи OHLCV: begin, open, high, low, close, value (руб), volume (шт). interval: 1, 10, 60 (мин/час), 24 (день), 7 (неделя), 31 (месяц), 4 (квартал). Время MSK. Свечи выходного дня лежат на календарных датах сб/вс.

Inputs: secid (required), start (required), interval (required), end, +5 more.

moex_historyA
Read-only

Дневные итоги торгов (до вчерашнего дня): TRADEDATE, OPEN, HIGH, LOW, CLOSE, LEGALCLOSEPRICE, WAPRICE, VOLUME, VALUE; у облигаций также ACCINT, YIELDCLOSE, DURATION, COUPONPERCENT. Объём сессий выходного дня входит в строку понедельника. Работает и для индексов (IMOEX, RGBI).

Inputs: secid (required), start (required), end, board, +5 more.

moex_history_by_dateB
Read-only

Итоги торгов всех бумаг режима за одну дату (например, все ОФЗ: market=bonds, board=TQOB).

Inputs: date (required), market (required), board, columns, +3 more.

moex_index_constituentsB
Read-only

Состав индекса с весами (%): IMOEX, MOEXBC, RTSI, RGBI, отраслевые.

Inputs: date, columns, indexid, filename, +2 more.

moex_market_snapshotA
Read-only

Все бумаги режима торгов с котировками (одна строка на бумагу). Акции: market=shares, board=TQBR (index=IMOEX — только база индекса). ОФЗ: market=bonds, board=TQOB. Корпоративные облигации: market=bonds, board=TQCB (~3000 строк, ~7 с). Большой результат сохраняется в CSV.

Inputs: board (required), market (required), index, columns, +3 more.

moex_quoteA
Read-only

Текущие котировки одной или нескольких бумаг (акции, облигации, индексы вперемешку), задержка ~15 мин (индексы — без задержки). Акции: LAST, CHANGE, LASTTOPREVPRICE, VALTODAY, UPDATETIME, SYSTIME. Облигации: цена в % номинала, ACCRUEDINT, EFFECTIVEYIELD, DURATION (дни), YIELDDATETYPE, NEXTCOUPON, MATDATE, OFFERDATE.

Inputs: secids (required), board, columns, filename, +2 more.

moex_rawA
Read-only

Любой роут ISS из docs/ROUTES.md. path без /iss и .json, например 'engines/stock/markets/shares/secstats'. all_block=<имя блока> — собрать все страницы этого блока.

Inputs: path (required), params, columns, filename, +3 more.

moex_securityA
Read-only

Карточка бумаги (description: ISIN, номинал, даты выпуска/погашения, купон, тип облигации, уровень листинга) и её режимы торгов (boards, is_primary). Принимает SECID или ISIN.

Inputs: secid (required), columns, filename, save_csv, +1 more.

moex_selfcheckA
Read-only

Самопроверка (~30 с): свежесть данных, согласованность роутов, полнота пагинации, пересчёт НКД и доходности. Запускай перед массовой выгрузкой или при сомнениях в данных.

Inputs: columns, filename, save_csv, max_inline_rows.

moex_tradesC
Read-only

Сделки текущей сессии. latest=N — N последних (новые первыми).

Inputs: secid (required), board, latest, columns, +4 more.

moex_zcycB
Read-only

Кривая бескупонной доходности ОФЗ (G-curve) на дату: yearyields (period лет -> value %), params, securities.

Inputs: date, columns, filename, save_csv, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.

      https://api.gloom.sh/mcp
    • Licensed Borsa Istanbul (BIST) data for AI assistants: live or 15-minute delayed prices, OHLCV bars from 1 minute to monthly, financial statements, ratios, KAP disclosures, indices and sectors, indicator backtests and portfolio tracking for 600+ Turkish stocks. OAuth sign-in with an istfin subscription. Never places orders.

      https://mcp.istfin.com/mcp
    • Free, no-key MCP connector for market data in Claude, Cursor and any Streamable HTTP client. Six tools: a pre-market and after-hours gapper scanner (get_premarket_gappers: top 10 names up 10% or more, $1-$100, float under 100M, with premarket relative volume, ATR, RSI and a news-catalyst flag), plus the Market Health desk: S&P 500 valuation verdict (get_market_valuation), Fed liquidity and yield-curve series (get_macro_liquidity), cross-asset regime (get_cross_asset_regime), market breadth (get_market_breadth) and risk-score history (get_market_health_history). Ships with a ready-made prompt, premarket_gappers_brief. Nothing to sign up for. Built by TraderMatrix. The full TraderMatrix connector has 51 tools, adding options flow, dealer gamma and Apex levels, unusual activity, sector flow, wheel screeners and your own watchlists.

    • Your investing research inside Claude: watchlists, financial ratios, reverse-DCF valuations, investment theses, notes, portfolio, earnings calendar and news for the companies you follow. 70 read and write tools; ask what's on your morning desk, rank a watchlist by ROE, log a trade or save a thesis. OAuth sign-in. Free to start.

      https://mcp.investjournal.io/mcp

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides access to Moscow Exchange data including quotes, trade history, candles, securities info, indices, and currency rates. Enables AI assistants to query financial market data through natural language.
      20
      40 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing financial data from Moscow Exchange and Bank of Russia, including quotes, bond metrics, interest rates, and portfolio analysis. Enables AI agents to analyze Russian financial markets through natural language.
      -
    • F
      license
      Not graded
      quality
      B
      maintenance
      Read-only MCP server for Moscow Exchange market data, providing securities search, quotes, candles, trades, and history via the official ISS API.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables access to Moscow Exchange market data, including quotes, order books, candles, trades, and trading calendar, through ISS+ WebSocket and ISS REST APIs.
      -