B2B API Документация
Полный программный доступ к скринеру облигаций, первичным размещениям, портфелям и финансовой аналитике через REST API.
Быстрый старт
Оформите B2B-подписку
Выберите тариф (1/3/6/12 мес.) и оплатите в личном кабинете.
Сгенерируйте API-ключ
Нажмите «Сгенерировать ключ» в дашборде. Ключ показывается один раз — сохраните его.
Отправьте первый запрос
Передайте ключ в заголовке x-api-key.
curl -X GET "https://owa.bonds-lab.ru/api/v1/data/instruments?PageSize=5" \ -H "x-api-key: ВАШ_API_КЛЮЧ"
Авторизация
Заголовок x-api-key
Каждый запрос к Data API должен содержать заголовок x-api-key с вашим API-ключом.
x-api-key: bl-58202eaebfbe66fbf3...
Один пользователь — один ключ
При каждой генерации нового ключа предыдущий автоматически деактивируется. Ключ привязан к вашему аккаунту и подписке.
Безопасность
Ключ отображается только в момент генерации. Храните его в безопасном месте (переменные окружения, менеджер секретов). Не передавайте ключ в URL-параметрах.
MCP-сервер
Что такое Model Context Protocol
MCP (Model Context Protocol) — открытый стандарт, позволяющий AI-ассистентам (Claude, ChatGPT, Cursor, VS Code Copilot) напрямую работать с внешними данными. Вместо ручных запросов к REST API, ваш AI-клиент автоматически обнаруживает доступные инструменты и вызывает их по мере необходимости.
Один MCP-сервер Bonds-Lab предоставляет доступ ко всем данным: скринер облигаций, детали по ISIN, портфели, первичные размещения, эмитенты, альтернативы и обзор рынка — через единый эндпоинт.
MCP-эндпоинт
https://owa.bonds-lab.ru/mcp
Авторизация через тот же x-api-key, что и для REST API.
Claude Desktop
Добавьте в файл claude_desktop_config.json:
{
"mcpServers": {
"bonds-lab": {
"url": "https://owa.bonds-lab.ru/mcp",
"headers": {
"x-api-key": "ВАШ_API_КЛЮЧ"
}
}
}
}Cursor / VS Code
Добавьте в файл .cursor/mcp.json или .vscode/mcp.json:
{
"servers": {
"bonds-lab": {
"type": "sse",
"url": "https://owa.bonds-lab.ru/mcp",
"headers": {
"x-api-key": "ВАШ_API_КЛЮЧ"
}
}
}
}Доступные инструменты (Tools)
AI-клиент автоматически обнаружит все инструменты при подключении к серверу. Каждый инструмент соответствует эндпоинту REST API:
| MCP Tool | REST API | Описание |
|---|---|---|
search_bonds | GET /data/instruments | Скринер облигаций по 25+ параметрам |
get_bond | GET /data/instruments/{id} | Детали облигации по UUID |
get_placements | GET /data/placements | Первичные размещения |
get_placement | GET /data/placements/{id} | Детали размещения |
get_market_overview | GET /data/market-overview | Обзор рынка и кривая ОФЗ |
get_portfolios | GET /data/holdings | Список портфелей |
get_portfolio | GET /data/holdings/{id} | Позиции портфеля |
get_issuers | GET /data/issuers | Список эмитентов |
get_alternatives | GET /data/alternatives/{isin} | Альтернативные облигации |
Пример диалога
Найди корпоративные облигации с доходностью от 20% и рейтингом не ниже BBB
Вызываю search_bonds с фильтрами YieldFrom=20, CreditRatingFrom=BBB...
Нашёл 12 облигаций. Топ-3 по доходности: МГКЛ 001P-06 (23.4%), АльфаДонТранс 002P-01 (22.1%)...
API Данных
Программный доступ к данным рынка облигаций. Все эндпоинты авторизуются через x-api-key.