Перейти к содержимому
TokenBel Wiki TokenBel Wiki
Основная навигация

Интеграция

Интеграция с TokenBel REST API: способы подключить приложения к сервису, получать данные и использовать стандартизированный программный интерфейс.

Варианты

У сервиса есть несколько вариантов интеграций со сторонними программами и сервисами:

  • REST API
  • RSS лента
  • MCP

REST API

Интеграция через TokenBel REST API предоставляет гибкий и стандартизированный способ подключения к сервису. Такой подход позволит получать актуальные данные о компаниях и токенах напрямую, без необходимости открывать сайт. Благодаря универсальному формату запросов REST API легко встраивается в любые системы, которые поддерживают работу с HTTP‑запросами, будь то аналитические инструменты или собственные приложения.

Такой метод интеграции подходит не только для специализированных систем, но и для популярных приложений управления финансами, например GnuCash, где данные о токенах и компаниях могут использоваться для учёта и анализа.

Обращаться за подробной Swagger документацией к администрации через Контакты .

RSS

MCP

Интеграция через MCP (Model Context Protocol) позволяет AI‑ассистентам и совместимым клиентам (например, Claude Desktop , Cursor , MCP Inspector) напрямую получать данные о белорусских ценных бумагах: токенах, акциях, облигациях и компаниях. Протокол работает по адресу https://mcp.tokenbel.dev/mcp без необходимости аутентификации, так как все данные публичны.

Сервер предоставляет 10 инструментов для работы с данными:

  • Получение и списки токенов, акций, облигаций и компаний по UUID
  • Поиск акций и облигаций по тикеру
  • Поиск компаний по наименованию, полному названию или УНП
  • Поддержка курсорной пагинации для списков

Для подключения в Claude Desktop добавьте в конфигурацию:

{
  "mcpServers": {
    "tokenbel": {
      "url": "https://mcp.tokenbel.dev/mcp"
    }
  }
}

Для проверки работы сервера можно использовать MCP Inspector :

npx @modelcontextprotocol/inspector https://mcp.tokenbel.dev/mcp

Особенности интеграции

  • Формат данных: JSON через Streamable HTTP
  • Кэширование: на уровне Cloudflare Workers KV (TTL 300–180с в зависимости от типа запроса)
  • Ограничения: рекомендуемый лимит — 50 запросов/минуту с IP
  • CORS: поддержка любых источников (*), методы GET, POST, DELETE, OPTIONS