Platform API

Копировать

• Копировать для LLM

  Копировать страницу как Markdown для LLM
• Просмотреть как Markdown

  Открыть эту страницу как Markdown
• Открыть в ChatGPT

  Получить анализ от ChatGPT
• Открыть в Claude

  Получить инсайты от Claude
• Подключиться к Cursor

  Установить сервер MCP в Cursor
• Подключиться к VS Code

  Установить сервер MCP в VS Code

Vilna Platform API - это RESTful-сервис для мониторинга блокчейнов, управления кошельками и обработки платежей. Он предоставляет единый интерфейс для работы с множеством блокчейн-сетей, используя стандарты CAIP для идентификации сетей и активов.

Полная документация по эндпоинтам доступна в справочнике Platform API.

Аутентификация

Все запросы требуют API-ключ в заголовке X-Api-Key. Подробности см. в руководстве по аутентификации.

Базовый URL

https://api.vilna.io/v1

Чтобы получить API-ключ, зарегистрируйтесь на app.vilna.io и создайте проект.

Ресурсы API

API данных блокчейнов

• Blockchains - запрос поддерживаемых сетей и метаданных
• Tokens - поиск метаданных активов (название, символ, десятичные знаки) по сети и адресу контракта

Управление адресами

• Addresses - отслеживание внешних и HD-производных адресов в различных сетях
• Public keys - регистрация расширенных публичных ключей HD-кошельков и деривация новых адресов

Транзакции и финансовые данные

• Balances - запрос текущих балансов токенов по отслеживаемым адресам
• Transactions - поиск деталей и истории транзакций с фильтрацией и сортировкой
• Activity - поток изменений балансов (переводы, одобрения) по всем отслеживаемым адресам

Платежи

• Invoices - создание и управление криптовалютными счетами с автоматическим определением оплаты

Уведомления

• Notification channels - настройка вебхуков и Telegram-оповещений, просмотр логов доставки

Инструменты

• Simulation - предварительный просмотр эффектов EVM-транзакций (изменения балансов, оценка газа) перед отправкой

Безопасность

• Храните API-ключи только на серверной стороне - не раскрывайте их во фронтенд-коде или публичных репозиториях.
• Используйте переменные окружения или менеджер секретов, не храните ключи в исходном коде.
• Регулярно ротируйте ключи и немедленно отзывайте скомпрометированные через Management API.
• При превышении лимитов запросов возвращается ответ 429 Too Many Requests.

Для сообщения об уязвимости обращайтесь на security@vilna.io. Подробности аутентификации в руководстве по аутентификации.

См. также

• Основные концепции - формат ответов, пагинация, денежные суммы и стандарты идентификации
• Ошибки и устранение неполадок - формат RFC 7807 и типичные коды ошибок

SDK и инструменты