> ## 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.

# Получение данных об идентичности кошелька

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

Каждый запрос стоит **100 кредитов**.

Требуется платный тариф. Запросы на бесплатном тарифе возвращают `403 Forbidden`.

## Параметры запроса

<ParamField body="wallet" type="string" required default="GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz">
  Адрес кошелька Solana (в кодировке base58) или доменное имя SNS/ANS (например, `toly.sol`,
  `miester.bonk`). Разрешение доменных имён доступно только в основной сети. Любой домен, отличный от `.sol`, считается пользовательским TLD в ANS — фиксированного списка разрешённых TLD нет.
</ParamField>


## OpenAPI

````yaml ru/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/identity
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}/identity:
    get:
      tags:
        - Идентификация
      summary: Получить идентификационные данные кошелька
      description: >
        Получает идентификационные данные известного кошелька (биржи, протоколы
        и т. д.). Принимает

        адрес кошелька Solana или доменное имя SNS (`.sol`) / ANS с
        пользовательским TLD

        (например, `toly.sol`, `miester.bonk`). Разрешение доменов доступно
        только в основной сети.


        Ответ представляет собой стандартный объект идентификации для
        **разрешенного адреса**. Маркер

        домена (`inputDomain`) в этой конечной точке не добавляется. Используйте
        `POST /v1/wallet/batch-identity`,

        если необходимо сопоставить входные и выходные данные.


        Возвращает `404`, если для кошелька нет записи идентификации или домен
        не удалось разрешить.

        Возвращает `400`, если входное значение не является допустимым адресом
        или доменным именем либо если

        домен передан в развертывании не основной сети.
      operationId: getWalletIdentity
      parameters:
        - $ref: '#/components/parameters/WalletOrDomain'
      responses:
        '200':
          description: Идентификационные данные найдены
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Identity'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Идентификационные данные недоступны или домен не удалось разрешить
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    WalletOrDomain:
      name: wallet
      in: path
      required: true
      description: >
        Адрес кошелька Solana (в кодировке base58) или доменное имя SNS/ANS
        (например, `toly.sol`,

        `miester.bonk`). Разрешение доменов доступно только в основной сети.
        Любой домен, отличный от `.sol`, считается

        пользовательским TLD ANS — фиксированного белого списка TLD нет.
      schema:
        type: string
        default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
      examples:
        address:
          summary: Адрес Solana
          value: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
        snsDomain:
          summary: Домен SNS (.sol)
          value: toly.sol
        ansDomain:
          summary: Пользовательский TLD ANS
          value: miester.bonk
  schemas:
    Identity:
      type: object
      properties:
        address:
          type: string
          description: Адрес кошелька Solana
          example: HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
        type:
          type: string
          description: Тип сущности
          example: exchange
        name:
          type: string
          description: Отображаемое имя
          example: Binance 1
        category:
          type: string
          description: Классификационная категория
          example: Централизованная биржа
        tags:
          type: array
          items:
            type: string
          description: Дополнительные классификационные теги
          example:
            - Централизованная биржа
        domainNames:
          type: array
          items:
            type: string
          description: >-
            Все доменные имена в блокчейне, принадлежащие этому адресу, включая
            SNS (.sol) и пользовательские TLD ANS (.bonk, .wen и т. д.). Если
            выбран любимый домен .sol, он отображается первым; остальные домены
            сортируются по алфавиту. Поле отсутствует, если кошелек не владеет
            доменами.
          example:
            - toly.sol
            - kash.superteam
      required:
        - address
        - type
        - name
        - category
        - tags
    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.