> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Обзор Wallet API (бета-версия)

> Запрашивайте данные кошельков Solana с помощью Wallet API. Получайте балансы, историю транзакций, переводы, сведения об идентификации и источниках финансирования в одном запросе.

<Note>
  Wallet API находится на этапе бета-тестирования. Эндпоинты и форматы ответов могут измениться.
</Note>

## Что такое Wallet API?

Wallet API предоставляет высокоуровневые REST-эндпоинты для запроса полных данных кошельков Solana: балансов, истории транзакций, переводов токенов, идентификационных данных, исторических балансов и источников финансирования. Вместо нескольких вызовов RPC и разбора необработанных данных блокчейна вы получаете структурированную и понятную информацию с ценами в USD в одном запросе.

Он предназначен для кошельков, трекеров портфелей, обозревателей, платежных систем, налоговых инструментов, а также систем комплаенса и противодействия отмыванию денег (AML). Все эндпоинты используют базовый URL `https://api.helius.xyz` и возвращают суммы в удобных для чтения единицах без необходимости преобразования лампортов.

## Почему стоит выбрать Helius для работы с данными кошельков?

<CardGroup cols={2}>
  <Card title="One REST call" icon="bolt">
    Структурированные балансы, история и переводы без необходимости объединять необработанные
    ответы RPC.
  </Card>

  <Card title="USD pricing built in" icon="dollar-sign">
    Балансы токенов содержат значения в USD и общую стоимость портфеля, полученные из DAS.
  </Card>

  <Card title="Identity resolution" icon="address-card">
    Более 32 500 размеченных аккаунтов и программ, а также более 21,5 млн категориальных тегов для
    бирж, протоколов и организаций.
  </Card>

  <Card title="Human-readable output" icon="book-open">
    Понятные данные с учетом десятичных разрядов вместо необработанных лампортов и инструкций.
  </Card>
</CardGroup>

## Основные эндпоинты

<CardGroup cols={2}>
  <Card title="Wallet Identity" icon="address-card" href="/docs/ru/wallet-api/identity">
    Определяйте известные кошельки по адресу или домену SNS/ANS: биржи, протоколы,
    организации.
  </Card>

  <Card title="Wallet Balances" icon="scale-balanced" href="/docs/ru/wallet-api/balances">
    Балансы всех токенов и NFT со значениями в USD, логотипами и метаданными.
  </Card>

  <Card title="Historical Balance" icon="clock" href="/docs/ru/wallet-api/balance-at">
    Баланс токена или SOL на момент прошлой временной метки, даты и времени либо слота.
  </Card>

  <Card title="Wallet History" icon="clock-rotate-left" href="/docs/ru/wallet-api/history">
    Полная история транзакций с изменениями баланса для каждой транзакции.
  </Card>

  <Card title="Token Transfers" icon="arrow-right-arrow-left" href="/docs/ru/wallet-api/transfers">
    Все входящие и исходящие переводы со сведениями об отправителе и получателе.
  </Card>

  <Card title="Funding Source" icon="money-bill-transfer" href="/docs/ru/wallet-api/funded-by">
    Исходный источник финансирования кошелька, определенный по первому входящему переводу SOL.
  </Card>
</CardGroup>

## Какой эндпоинт использовать?

| Что вам нужно | Используйте | Возвращаемые данные |
| - | - | - |
| Владелец кошелька (биржа, протокол, метка) | [Идентификация](/docs/ru/wallet-api/identity) | Название, категория и теги известных адресов |
| Текущий портфель кошелька | [Балансы](/docs/ru/wallet-api/balances) | Все токены и NFT со значениями в USD |
| Баланс на определенный момент в прошлом | [Исторический баланс](/docs/ru/wallet-api/balance-at) | Баланс одного токена или SOL на момент временной метки, даты и времени либо слота |
| Полная история транзакций | [История](/docs/ru/wallet-api/history) | Обработанные транзакции с изменениями баланса для каждой транзакции |
| Только отправленные и полученные переводы | [Переводы](/docs/ru/wallet-api/transfers) | Данные на уровне переводов с контрагентом и направлением |
| Откуда поступили средства кошелька | [Источник финансирования](/docs/ru/wallet-api/funded-by) | Первый входящий перевод SOL и его отправитель |

Краткий справочник по базовым маршрутам (базовый URL: `https://api.helius.xyz`):

* `GET /v1/wallet/{wallet}/identity` — получить идентификационные данные кошелька по адресу или домену SNS/ANS
* `POST /v1/wallet/batch-identity` — пакетный поиск идентификационных данных (до 100 адресов и/или доменов)
* `GET /v1/wallet/{wallet}/balances` — получить балансы всех токенов и NFT
* `GET /v1/wallet/{wallet}/balance-at` — получить баланс токена или SOL на момент прошлой временной метки, даты и времени либо слота
* `GET /v1/wallet/{wallet}/history` — получить историю транзакций с изменениями баланса
* `GET /v1/wallet/{wallet}/transfers` — получить данные обо всех переводах токенов
* `GET /v1/wallet/{wallet}/funded-by` — найти исходный источник финансирования

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

Для всех запросов Wallet API требуется ключ API. Его можно передать как параметр запроса или заголовок:

<Tabs>
  <Tab title="Query Parameter">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="Header">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances" \
      -H "X-Api-Key: YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## Требования к тарифному плану

Для эндпоинтов идентификации и источника финансирования требуется платный тарифный план. На бесплатном тарифе запросы к этим эндпоинтам возвращают `403 Forbidden`. Все остальные эндпоинты доступны на всех тарифах, включая бесплатный.

| Эндпоинт | Бесплатный тариф |
| - | - |
| `GET /v1/wallet/{wallet}/identity` | `403` — только платные тарифы |
| `POST /v1/wallet/batch-identity` | `403` — только платные тарифы |
| `GET /v1/wallet/{wallet}/funded-by` | `403` — только платные тарифы |
| `GET /v1/wallet/{wallet}/balances` | Доступен |
| `GET /v1/wallet/{wallet}/balance-at` | Доступен |
| `GET /v1/wallet/{wallet}/history` | Доступен |
| `GET /v1/wallet/{wallet}/transfers` | Доступен |

Любой платный тариф открывает доступ к закрытым эндпоинтам: Developer, Business и всем более высоким тарифам, например Enterprise. Чтобы включить поиск идентификационных данных и источников финансирования, [повысьте тарифный план в панели управления](https://dashboard.helius.dev).

## Суммы и единицы измерения

Wallet API — это высокоуровневая абстракция над необработанными данными Solana. Все поля `amount` в ответах представлены в **удобном для чтения виде**: они уже разделены на `decimals` токена, поэтому их можно отображать напрямую без преобразования. Необработанные вызовы Solana RPC возвращают значения в лампортах (минимальных единицах, 10⁻⁹ SOL), а Wallet API — нет. `"amount": 1.5` означает 1,5 SOL, а не 1,5 лампорта.

Если требуются точные вычисления, некоторые эндпоинты также предоставляют `amountRaw`: то же значение в виде необработанного целого числа, сериализованного как строка во избежание потери точности при вычислениях с плавающей запятой. Формула преобразования:

`amount = parseInt(amountRaw) / 10**decimals`

| Эндпоинт | Удобочитаемое значение `amount` | Необработанная строка `amountRaw` |
| - | - | - |
| **Балансы** | Поле `balance` | Недоступно |
| **Баланс на момент времени** | Поле `balance` (десятичная **строка**) | Поле `balanceRaw` |
| **Источник финансирования** | Поле `amount` | Поле `amountRaw` |
| **Переводы** | Поле `amount` | Поле `amountRaw` |
| **История** (`balanceChanges`) | Поле `amount` | Недоступно |

Используйте `amount` для отображения. Используйте `amountRaw` при передаче значений в ончейн-инструкции или другие системы, которым требуются точные целочисленные вычисления.

## Начало работы

<Steps>
  <Step title="Get your API key">
    Зарегистрируйтесь на [dashboard.helius.dev](https://dashboard.helius.dev), чтобы получить ключ API.
  </Step>

  <Step title="Choose your endpoint">
    Используйте приведенную выше таблицу, чтобы выбрать эндпоинт для своего сценария использования.
  </Step>

  <Step title="Make your first request">
    Начните с простого запроса баланса:

    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
    ```
  </Step>

  <Step title="Handle the response">
    Разберите ответ JSON и отобразите данные в своем приложении.
  </Step>
</Steps>

## Следующие шаги

<CardGroup cols={3}>
  <Card title="Getting Data" icon="database" href="/docs/ru/getting-data">
    Изучите все способы запроса данных Solana в Helius.
  </Card>

  <Card title="API Reference" icon="code" href="/docs/ru/api-reference/wallet-api">
    Схемы запросов и ответов для всех эндпоинтов Wallet API.
  </Card>

  <Card title="Contact Support" icon="headset" href="/docs/ru/support/contact-support">
    Получите помощь через Discord, чат или электронную почту.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.