> ## 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.
# Получение балансов кошелька
> Получите балансы токенов и активы SOL для адреса кошелька Solana.
Каждый запрос стоит **100 кредитов**.
## Параметры запроса
Адрес кошелька Solana (в кодировке base58)
Номер страницы для пагинации (нумерация начинается с 1)
Максимальное количество токенов на странице
Включать токены с нулевым балансом
Включать нативный SOL в результаты
Включать NFT в результаты (не более 100, только на первой странице)
## OpenAPI
````yaml ru/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/balances
openapi: 3.0.3
info:
title: Wallet API
description: >
Высокопроизводительный REST API для запросов данных кошельков Solana,
включая балансы, историю транзакций, переводы и сведения об идентификации.
## Аутентификация
Для всех запросов требуется ключ API, передаваемый одним из следующих
способов:
- Параметр запроса: `?api-key=YOUR_API_KEY`
- Заголовок: `X-Api-Key: YOUR_API_KEY`
version: 1.0.0
contact:
name: Поддержка API
url: https://helius.dev
servers:
- url: https://api.helius.xyz
description: Рабочий сервер
security:
- ApiKeyQuery: []
- ApiKeyHeader: []
tags:
- name: Идентификация
description: Поиск идентификационных данных кошельков и известных адресов
- name: Балансы
description: Запрос балансов токенов и NFT
- name: История
description: История транзакций и изменения баланса
- name: Переводы
description: Операции перевода токенов
- name: Финансирование
description: Сведения о финансировании кошелька
paths:
/v1/wallet/{wallet}/balances:
get:
tags:
- Балансы
summary: Получить балансы кошелька
description: >
Получает балансы токенов и NFT кошелька. **Пагинация выполняется
вручную** — API возвращает до 100 токенов за запрос.
Результаты сортируются по стоимости в USD в порядке убывания. Сначала
отображаются токены с данными о цене, затем токены без цены.
**Пагинация:** Используйте параметр `page`, чтобы получить
дополнительные страницы. Ответ содержит `pagination.hasMore`,
который указывает, доступны ли дополнительные результаты. Каждый запрос
выполняет один вызов API и стоит 100 кредитов.
operationId: getWalletBalances
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: page
in: query
description: Номер страницы для пагинации (нумерация начинается с 1)
schema:
type: integer
minimum: 1
default: 1
example: 1
- name: limit
in: query
description: Максимальное количество токенов на странице
schema:
type: integer
minimum: 1
maximum: 100
default: 100
example: 100
- name: showZeroBalance
in: query
description: Включать токены с нулевым балансом
schema:
type: boolean
default: false
- name: showNative
in: query
description: Включать нативный SOL в результаты
schema:
type: boolean
default: true
- name: showNfts
in: query
description: Включать NFT в результаты (не более 100, только на первой странице)
schema:
type: boolean
default: false
responses:
'200':
description: Балансы кошелька успешно получены
content:
application/json:
schema:
$ref: '#/components/schemas/BalancesResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
parameters:
WalletAddress:
name: wallet
in: path
required: true
description: Адрес кошелька Solana (в кодировке base58)
schema:
type: string
pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
schemas:
BalancesResponse:
type: object
properties:
balances:
type: array
items:
$ref: '#/components/schemas/TokenBalance'
description: >
Массив балансов токенов для текущей страницы, включая нативный SOL.
Если showNative=true, SOL отображается первым элементом с адресом
минтинга So11111111111111111111111111111111111111112.
Остальные токены сортируются по стоимости в USD (по убыванию).
nfts:
type: array
items:
$ref: '#/components/schemas/Nft'
description: >-
Массив имеющихся NFT (включается только при showNfts=true; не более
100 и только на первой странице)
totalUsdValue:
type: number
description: >-
Общая стоимость балансов на этой странице в USD (не общая стоимость
портфеля)
example: 217.98
pagination:
type: object
description: >-
Метаданные пагинации. Пользователи должны вручную запрашивать
дополнительные страницы с помощью параметра page.
properties:
page:
type: integer
description: Номер текущей страницы
example: 1
limit:
type: integer
description: Количество элементов на странице
example: 100
hasMore:
type: boolean
description: >-
Имеет значение true, если доступны дополнительные результаты.
Увеличьте параметр page, чтобы получить следующую страницу.
example: true
required:
- page
- limit
- hasMore
required:
- balances
- totalUsdValue
- pagination
TokenBalance:
type: object
properties:
mint:
type: string
description: Адрес минтинга токена
example: So11111111111111111111111111111111111111112
symbol:
type: string
nullable: true
description: Символ токена
example: SOL
name:
type: string
nullable: true
description: Название токена
example: Solana
balance:
type: number
description: Баланс токена (с учетом десятичных разрядов)
example: 1.5
decimals:
type: integer
description: Количество десятичных разрядов
example: 9
pricePerToken:
type: number
nullable: true
description: Цена одного токена в USD
example: 145.32
usdValue:
type: number
nullable: true
description: Общая стоимость активов в USD
example: 217.98
logoUri:
type: string
nullable: true
description: URL изображения логотипа токена
example: https://example.com/sol-logo.png
tokenProgram:
type: string
enum:
- spl-token
- token-2022
description: >-
Тип программы токена (spl-token для устаревшего стандарта,
token-2022 для нового)
example: spl-token
required:
- mint
- balance
- decimals
- tokenProgram
Nft:
type: object
properties:
mint:
type: string
description: Адрес минтинга NFT
example: 7Xq8wXyXVqfBPPqVJjPDwG9zN5wCVxBYZ6z7vPYBzr6F
name:
type: string
nullable: true
description: Название NFT
example: Degen Ape
imageUri:
type: string
nullable: true
description: URI изображения NFT
example: https://example.com/nft.png
collectionName:
type: string
nullable: true
description: Название коллекции
example: Degen Ape Academy
collectionAddress:
type: string
nullable: true
description: Адрес коллекции
example: DegN1dXmU2uYa4n7U9qTh7YNYpK4u8L9qXx7XqYqJfGH
compressed:
type: boolean
description: Является ли этот NFT сжатым
example: false
required:
- mint
- compressed
Error:
type: object
properties:
error:
type: string
description: Сообщение об ошибке
example: Недопустимый адрес кошелька
code:
type: integer
description: Код состояния HTTP
example: 400
details:
type: string
description: Дополнительные сведения об ошибке
example: '''invalid-address'' не является допустимым адресом Solana'
required:
- error
- code
responses:
BadRequest:
description: Недопустимые параметры запроса
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Недопустимый адрес кошелька
code: 400
details: '''invalid-address'' не является допустимым адресом Solana'
Unauthorized:
description: Ключ API отсутствует или недействителен
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: >-
Требуется ключ API. Передайте его через ?api-key=xxx или заголовок
X-Api-Key
code: 401
RateLimited:
description: Превышено ограничение частоты запросов.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: RATE_LIMIT_EXCEEDED
code: 429
details: Слишком много запросов. Повторите попытку через 2 секунды.
InternalError:
description: >-
Временная ошибка сервера. Запрос можно повторить с экспоненциальной
задержкой.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: INTERNAL_ERROR
code: 500
details: Произошла непредвиденная ошибка. Повторите попытку.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: Ключ API, передаваемый как параметр запроса
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
description: Ключ API, передаваемый в заголовке запроса
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.