{
  "generated": "2026-11-05T22:50:57.768Z",
  "title": "Каталог публичных API 259cfa.ru для ИИ-агентов",
  "baseUrl": "https://259cfa.ru",
  "scope": "статические файлы в 259cfa/static/api/ (отдаются по https://259cfa.ru/api/…). Время актуальности каждого файла — в его полях generated/generatedAt/updated/asOf.",
  "attribution": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru).",
  "disclaimer": "Не является индивидуальной инвестиционной рекомендацией",
  "endpoints": [
    {
      "id": "releases",
      "url": "https://259cfa.ru/api/releases.json",
      "format": "json",
      "description": "Реестр решений о выпуске ЦФА: эмитент, площадка, даты, ставки, объёмы (softcap/hardcap), ссылки на карточки выпусков и эмитентов.",
      "updateFrequency": "ежедневно (плановая синхронизация базы ЦФА; см. поле generated)",
      "license": "атрибуция: 259CFA (259cfa.ru), использование с указанием источника",
      "note": "условия первичны в решении о выпуске",
      "keys": [
        "generated",
        "count",
        "source",
        "license",
        "note",
        "records"
      ]
    },
    {
      "id": "base-meta",
      "url": "https://259cfa.ru/api/base-meta.json",
      "format": "json",
      "description": "Сводные счётчики базы: число выпусков и эмитентов.",
      "updateFrequency": "ежедневно (вместе с releases.json; см. поле generated, формат ДД.ММ.ГГГГ)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru).",
      "keys": [
        "generated",
        "releases",
        "issuers"
      ]
    },
    {
      "id": "indicators",
      "url": "https://259cfa.ru/api/indicators.json",
      "format": "json",
      "description": "Показатели рынка: ключевая ставка Банка России, индексы IMOEX/RGBI/RGBITR, ближайшие ОФЗ, дивиденды, курсы ЦБ, USDT/RUB, ставки по депозитам, ставки ЦБ региональных стран.",
      "updateFrequency": "по данным Банка России и Московской биржи; обновляется скриптом 259cfa/scripts/indicators/fetch.mjs (см. поле updated)",
      "license": "Данные: Банк России (www.cbr.ru) и Московская биржа (iss.moex.com) — официальные открытые источники; использование с атрибуцией. Не является индивидуальной инвестиционной рекомендацией.",
      "keys": [
        "updated",
        "description",
        "license",
        "sources",
        "keyrate",
        "moex",
        "ofz",
        "dividends",
        "cbrfx",
        "usdt",
        "deposits",
        "cbRegion"
      ]
    },
    {
      "id": "indices-259",
      "url": "https://259cfa.ru/api/indices-259.json",
      "format": "json",
      "description": "Индексы 259CFA: доходность выпусков по срочности (yiSub: ultra/short/medium/long), активность эмитентов (iai), объёмы рынка (mvi), концентрация (msi), ликвидность (li).",
      "updateFrequency": "ежемесячно за календарный месяц (поле asOf), файл перегенерируется при обновлении базы (поле generatedAt)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru).",
      "keys": [
        "generatedAt",
        "asOf",
        "yiSub",
        "iai",
        "mvi",
        "msi",
        "li"
      ]
    },
    {
      "id": "indices-sentiment",
      "url": "https://259cfa.ru/api/indices-sentiment.json",
      "format": "json",
      "description": "259-NSI — индекс новостного сантимента рынка ЦФА (шкала 0–100, нейтраль 50), помесячная история.",
      "updateFrequency": "ежемесячно за календарный месяц (поле asOf), файл перегенерируется при обновлении базы (поле generatedAt)",
      "license": "атрибуция: 259CFA (259cfa.ru), использование с указанием источника",
      "keys": [
        "generatedAt",
        "asOf",
        "status",
        "ticker",
        "name",
        "scale",
        "alpha",
        "windowDays",
        "methodology",
        "license",
        "nsi"
      ]
    },
    {
      "id": "defaults-issuers",
      "url": "https://259cfa.ru/api/defaults-issuers.json",
      "format": "json",
      "description": "Реестр эмитентов с дефолтами по ЦФА: название + slug (для сопоставления с releases.json и emitent-scores.json).",
      "updateFrequency": "по мере выявления дефолтов (период наблюдения — в поле generated)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru).",
      "keys": [
        "generated",
        "issuers"
      ]
    },
    {
      "id": "emitent-scores",
      "url": "https://259cfa.ru/api/emitent-scores.json",
      "format": "json",
      "description": "Скоринговые классы эмитентов (A/B/C/D) по slug эмитента.",
      "updateFrequency": "по мере пересмотра скоринга (см. поле generated)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru).",
      "keys": [
        "generated",
        "scores"
      ]
    },
    {
      "id": "issuer-scores-v2",
      "url": "https://259cfa.ru/api/agent/issuer-scores-v2.json",
      "format": "json",
      "description": "Скоринг эмитентов v2: score 0–100 поверх класса A/B/C/D с факторами и источниками (дефолты, просрочки, незакрытые погашения, аномальные ставки, история размещений); methodology.rules — все правила, data_quality — пропуски данных. Информационно, не ИИР.",
      "updateFrequency": "пересобирается вместе с agent-фидами при каждом деплой-цикле (см. поле generated)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru)."
    },
    {
      "id": "platforms",
      "url": "https://259cfa.ru/api/platforms.json",
      "format": "json",
      "description": "Статистика по операторам информационных систем (площадкам): число выпусков, сумма hardcap, средняя ставка, первая/последняя дата.",
      "updateFrequency": "ежедневно (пересчитывается вместе с releases.json; см. поле generated)",
      "license": "атрибуция: 259CFA (259cfa.ru), использование с указанием источника",
      "keys": [
        "generated",
        "license",
        "count",
        "records"
      ]
    },
    {
      "id": "payments",
      "url": "https://259cfa.ru/api/payments.json",
      "format": "json",
      "description": "План выплат по выпускам «денежное требование» в обращении: события (купон/погашение) со статусами подтверждения; счётчики и разбивка по площадкам.",
      "updateFrequency": "ежедневно (вместе с базой ЦФА; см. поля asOf и generated)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru).",
      "keys": [
        "asOf",
        "generated",
        "note",
        "counts",
        "per_platform",
        "issues"
      ]
    },
    {
      "id": "months",
      "url": "https://259cfa.ru/api/months.json",
      "format": "json",
      "description": "Помесячная агрегация базы: число выпусков, сумма hardcap, средняя ставка.",
      "updateFrequency": "ежедневно (пересчитывается вместе с releases.json; см. поле generated)",
      "license": "атрибуция: 259CFA (259cfa.ru), использование с указанием источника",
      "keys": [
        "generated",
        "license",
        "count",
        "records"
      ]
    },
    {
      "id": "cfa-index",
      "url": "https://259cfa.ru/api/cfa-index.json",
      "format": "json",
      "description": "Индекс доходности ЦФА · 259CFA: средняя ставка купона по решениям с указанной ставкой, за календарный месяц; помесячный ряд points.",
      "updateFrequency": "ежемесячно за календарный месяц (headline.month), файл перегенерируется при обновлении базы (поле generatedAt)",
      "license": "Свободное цитирование с активной ссылкой на https://259cfa.ru/cfa-index/",
      "keys": [
        "name",
        "description",
        "units",
        "headline",
        "avg12",
        "avg12Months",
        "avgYtd",
        "avgYtdMonths",
        "generatedAt",
        "license",
        "points"
      ]
    },
    {
      "id": "payments-calendar",
      "url": "https://259cfa.ru/api/payments-calendar.ics",
      "format": "ics",
      "description": "Календарь выплат по ЦФА в формате iCalendar.",
      "updateFrequency": "ежедневно (вместе с payments.json)",
      "license": "Данные: открытая база 259CFA (259cfa.ru) — решения о выпуске ЦФА; Банк России (cbr.ru); Московская биржа (moex.com). Атрибуция обязательна: 259CFA (259cfa.ru)."
    }
  ],
  "mcp": {
    "status": "planned",
    "note": "Будущие MCP-инструменты поверх этих эндпоинтов (план, не реализовано).",
    "tools": [
      {
        "name": "cfa_get_market_snapshot",
        "description": "Срез рынка ЦФА: число выпусков, эмитентов, объёмы, ставка ЦБ, значения индексов.",
        "source": "api/agent/market-snapshot.json",
        "args": "нет"
      },
      {
        "name": "cfa_get_latest_releases",
        "description": "Топ свежих решений о выпуске ЦФА.",
        "source": "api/agent/digest-latest.json, api/releases.json",
        "args": "limit (по умолчанию 20)"
      },
      {
        "name": "cfa_get_redflags",
        "description": "Красные флаги: дефолтные эмитенты, непогашенные выпуски с прошедшим погашением, аномальные ставки.",
        "source": "api/agent/redflags.json",
        "args": "slug эмитента или n выпуска (опционально)"
      },
      {
        "name": "cfa_get_defaults",
        "description": "Реестр эмитентов с дефолтами по ЦФА.",
        "source": "api/defaults-issuers.json",
        "args": "нет"
      },
      {
        "name": "cfa_get_index_history",
        "description": "История индексов: cfa-index, доходность по срочности (yiSub), сантимент 259-NSI.",
        "source": "api/cfa-index.json, api/indices-259.json, api/indices-sentiment.json",
        "args": "index, from, to"
      },
      {
        "name": "cfa_get_platform_stats",
        "description": "Статистика по площадкам (операторам ИС): выпуски, объёмы, средние ставки.",
        "source": "api/platforms.json, api/payments.json (per_platform)",
        "args": "platform (опционально)"
      },
      {
        "name": "cfa_get_payments_plan",
        "description": "План выплат и статусы событий по выпуску.",
        "source": "api/payments.json, api/payments-calendar.ics",
        "args": "n выпуска или card_url"
      },
      {
        "name": "cfa_search_issuers",
        "description": "Поиск эмитента по названию/slug, скоринг-класс и число выпусков.",
        "source": "api/releases.json, api/emitent-scores.json",
        "args": "query"
      },
      {
        "name": "cfa_get_issuer_scores_v2",
        "description": "Скоринг эмитентов v2: score 0–100, факторы с источниками (дефолты, просрочки, погашения, ставки, размещения).",
        "source": "api/agent/issuer-scores-v2.json",
        "args": "slug эмитента (опционально)"
      }
    ]
  }
}
