# Platform API

Отслеживайте свои адреса и сверяйте поступления через единый Platform API. Общие форматы ресурсов и [CAIP](/ru/apis/standards#caip)-идентификаторы позволяют одинаково работать с данными разных блокчейнов. Доступность балансов, транзакций и уведомлений зависит от сети; проверьте [таблицу сетей](/ru/apis/networks#table).

`api.vilna.io/v2`
`vilna_api_` · проект
REST · JSON
CAIP-идентификаторы

## Лимиты ресурсов 

[Лимиты проекта](/ru/apis/platform/api/limits/get-limits) возвращают текущее количество `used` и действующий максимум `max`. При `max`, равном 0, создание новых ресурсов запрещено; после снижения максимума `used` может его превышать. Эти значения носят справочный характер и не резервируют ёмкость.

Отключённые подписки и каналы продолжают учитываться, как и дочерние публичные ключи. Для открытых инвойсов считаются занятые платёжные окна, для доверенных активов - записи доверия проекта. Чтение лимитов требует `api:limits:read`. Существующие API-ключи не получают это право автоматически; при необходимости выпустите новый ключ взамен старого.

## Что можно делать 

### Данные блокчейнов

- **Blockchains** - поддерживаемые сети и метаданные сетей.
- **Tokens** - каталог активов с метками проверки и доверия; см. [руководство о токенах](/ru/guides/tokens).


### Адреса и кошельки

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


### Деньги

- **Balances** - текущие активы по всем отслеживаемым адресам.
- **Transactions** - поиск и история, с фильтрацией и сортировкой.
- **Activity** - поток изменений балансов по всем отслеживаемым адресам.
- **Invoices** - криптовалютные счета с автоматическим определением оплаты.


### Операции

- **Notification channels** - адресаты вебхуков и Telegram, с историей уведомлений.
- **Subscriptions** - связывает канал с семейством транзакций и условием отправки уведомления; см. [условия подписки](/ru/guides/events#triggers).
- **Notification history** - история попыток доставки по каналу; см. [историю уведомлений](/ru/guides/channels#logs).
- **Simulation** - предпросмотр эффектов EVM-транзакции до её отправки.


## Поддерживаемые сети 

Platform API поддерживает 9 сетей; Solana ограничена адресами и каталогом токенов. В [таблице сетей](/ru/apis/networks#table) указаны возможности и идентификаторы CAIP-2; `GET /blockchains` возвращает актуальный список.

Момент отправки уведомления определяется [условием подписки](/ru/guides/events#triggers).

## Ключевые факты 

- **Базовый URL** - `https://api.vilna.io/v2`
- **Аутентификация** - ключ `vilna_api_` в заголовке `X-Api-Key`. См. [Аутентификацию](/ru/apis/authentication).
- **Соглашения** - JSON в запросах и ответах, CAIP-2 / CAIP-19 идентификаторы, структурированные суммы и пагинация. См. [Основные концепции](/ru/get-started/core-concepts).
- **Ошибки** - [RFC 7807 problem+json](/ru/apis/errors).


Полный справочник эндпоинтов: [Справочник Platform API](/ru/apis/platform/api).