Открытое API 259CFA: данные базы выпусков ЦФА в JSON — 259CFA
ЦФА Аналитика
TelegramПодпишись в Telegram

Главная / API

Открытое API 259CFA: данные базы выпусков ЦФА в JSON

Данные 259CFA — открытое API: открытая база решений о выпуске цифровых финансовых активов доступна не только на сайте, но и машинно — статичными JSON-файлами без авторизации, ключей и лимитов запросов. Файлы удобно забирать в дашборды, скрипты, виджеты и исследования. Для кого это сделано: аналитикам — для расчётов и мониторинга рынка, юристам — для отслеживания практики выпусков, разработчикам — для интеграций и виджетов, СМИ — для цитирования данных с атрибуцией.

Все файлы обновляются вместе с базой: скрипт синхронизации собирает решения операторов информационных систем, а генераторы пересобирают JSON при каждом деплое сайта.

Эндпоинты

ЭндпоинтЧто отдаётКлючевые поля
https://259cfa.ru/api/releases.jsonВсе выпуски базы — по одной записи на решение о выпуске (на этих же данных работает скринер выпусков)n, platform, date, issuer, softcap, hardcap, rate, start, end, maturity, type, decision_url, card_url, issuer_url, platform_url
https://259cfa.ru/api/platforms.jsonСрез по платформам — операторам информационных системplatform, releases, hardcap_sum, avg_rate, first_date, last_date
https://259cfa.ru/api/months.jsonСрез по календарным месяцам даты решенияmonth (YYYY-MM), releases, hardcap_sum, avg_rate
https://259cfa.ru/api/cfa-index.jsonИндекс доходности ЦФА — средняя ставка по решениям с указанной ставкойheadline (месяц, ставка, изменение), points (весь ряд), avg12, avgYtd, generatedAt

Каждый файл — единый JSON-объект: generated (метка сборки, Moscow time), license (условия атрибуции), count (число записей) и массив records (в cfa-index.json структура своя — см. страницу индекса).

Смысл полей:

  • n — порядковый номер выпуска в базе; date — дата решения о выпуске (YYYY-MM-DD);
  • hardcap / hardcap_sum — заявленный максимальный объём; rate / avg_rate — ставка, % годовых (среднее простое по выпускам с указанной числовой ставкой, округление до 0,1);
  • card_url, issuer_url, platform_url — ссылки на карточку выпуска, эмитента и платформу в базе выпусков; decision_url — ссылка на первоисточник, решение оператора ИС;
  • softcap и hardcap заполнены только там, где в решении указано число — что именно означает число, определяет решение (см. ограничения ниже).

Примеры

Текущий срез по платформам и помесячная динамика:

curl -s https://259cfa.ru/api/platforms.json | head -c 600
curl -s https://259cfa.ru/api/months.json -o months.json

Выборка из всех выпусков: платформа, эмитент, ставка и объём за месяц (нужен jq):

curl -s https://259cfa.ru/api/releases.json \
  | jq '.records[] | select(.date | startswith("2026-09")) | {date, issuer, platform, rate, hardcap}'

Значение индекса доходности за последний месяц:

curl -s https://259cfa.ru/api/cfa-index.json | jq '.headline'

Лицензия и атрибуция

Данные свободны для использования, включая коммерческое, при одном условии — обязательная атрибуция: рядом с цифрами или графиком указание «Данные: 259CFA (259cfa.ru)» и активная ссылка на https://259cfa.ru/api/ либо на конкретный файл-источник. В машиночитаемых полях файлов условие зафиксировано в поле license. Для цитирования индекса действуют те же правила, что описаны на странице индекса.

Обновление

Файлы пересобираются ежедневно, вместе с синхронизацией базы: новые решения операторов ИС попадают в базу, после чего скрипты-генераторы пересчитывают все срезы. Метку актуальности видно в поле generated (в cfa-index.json — generatedAt); закладывать в код «вечные» значения не нужно — лучше перечитывать файл и кэшировать на своей стороне на разумный срок (например, на час).

Ограничения

  • As is, без SLA. Файлы отдаются «как есть»: доступность, состав полей и структуру мы можем менять по мере развития базы (структурные изменения анонсируем на этой странице);
  • Объёмы — «как в решении о выпуске». Softcap и hardcap в решениях указаны в рублях ИЛИ в количестве ЦФА (штук) — единицы определяет решение, в API это не размечено; в releases.json попадают только числовые значения, у остальных выпусков поле равно null;
  • Ставки — только фиксированные числовые. Плавающие формулы вида «ключевая ставка + N п.п.» в поле rate не попадают, поэтому средние (avg_rate, индекс) считаются по выпускам с указанной ставкой;
  • Не инвестиционная рекомендация. Данные — наблюдаемая выборка открытых решений, а не оценка доходности или риска: комиссии платформ, налоги и цена вторичного рынка в API не учтены. Данные: 259CFA, не является ИИР;
  • Первоисточник важнее агрегата. Условия конкретного выпуска проверяйте по решению оператора ИС (поле decision_url) — условия первичны в решении о выпуске.

Связанные разделы сайта

База целиком с фильтрами — в базе выпусков, помесячная динамика — в календаре размещений, рейтинги — в эмитентах и платформах, фильтруемая таблица — в скринере выпусков. Почему база 259CFA расходится со статистикой ЦБ — отдельный разбор.