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

# Obtener identidad de la billetera

> Resuelve la información de identidad en cadena de una billetera de Solana, incluidos nombres de dominio y perfiles sociales.

Cada solicitud cuesta **100 créditos**.

Requiere un plan de pago. Las solicitudes del plan gratuito devuelven `403 Forbidden`.

## Parámetros de la solicitud

<ParamField body="wallet" type="string" required default="GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz">
  Dirección de la billetera de Solana (codificada en base58) o nombre de dominio SNS/ANS (p. ej., `toly.sol`,
  `miester.bonk`). La resolución de dominios solo está disponible en mainnet. Cualquier dominio que no sea `.sol` se trata
  como un TLD personalizado de ANS; no hay una lista fija de TLD permitidos.
</ParamField>


## OpenAPI

````yaml es/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/identity
openapi: 3.0.3
info:
  title: API de billeteras
  description: >
    Una API REST de alto rendimiento para consultar datos de billeteras de
    Solana, incluidos saldos, historial de transacciones, transferencias e
    información de identidad.


    ## Autenticación


    Todas las solicitudes requieren una clave de API enviada de una de estas
    formas:

    - Parámetro de consulta: `?api-key=YOUR_API_KEY`

    - Encabezado: `X-Api-Key: YOUR_API_KEY`
  version: 1.0.0
  contact:
    name: Soporte de API
    url: https://helius.dev
servers:
  - url: https://api.helius.xyz
    description: Servidor de producción
security:
  - ApiKeyQuery: []
  - ApiKeyHeader: []
tags:
  - name: Identidad
    description: Busca identidades de billeteras y direcciones conocidas
  - name: Saldos
    description: Consulta saldos de tokens y NFT
  - name: Historial
    description: Historial de transacciones y cambios de saldo
  - name: Transferencias
    description: Actividad de transferencia de tokens
  - name: Financiamiento
    description: Información de financiamiento de billeteras
paths:
  /v1/wallet/{wallet}/identity:
    get:
      tags:
        - Identidad
      summary: Obtén la identidad de una billetera
      description: >
        Recupera información de identidad de una billetera conocida (exchanges,
        protocolos, etc.). Acepta

        una dirección de billetera de Solana o un nombre de dominio SNS (`.sol`)
        o TLD personalizado de ANS

        (p. ej., `toly.sol`, `miester.bonk`). La resolución de dominios solo
        está disponible en mainnet.


        La respuesta es el objeto de identidad estándar para la **dirección
        resuelta**. Este endpoint no

        incluye ningún marcador de dominio (`inputDomain`); usa `POST
        /v1/wallet/batch-identity`

        si necesitas correlacionar las entradas con las salidas.


        Devuelve `404` si la billetera no tiene una entrada de identidad o si no
        se puede resolver una entrada de dominio.

        Devuelve `400` si la entrada no es una dirección válida ni un nombre de
        dominio válido, o si se envía una

        entrada de dominio en un despliegue que no es de mainnet.
      operationId: getWalletIdentity
      parameters:
        - $ref: '#/components/parameters/WalletOrDomain'
      responses:
        '200':
          description: Se encontró información de identidad
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Identity'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: >-
            No hay información de identidad disponible o no se pudo resolver el
            dominio
          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: >
        Dirección de billetera de Solana (codificada en base58) o nombre de
        dominio SNS/ANS (p. ej., `toly.sol`,

        `miester.bonk`). La resolución de dominios solo está disponible en
        mainnet. Cualquier dominio que no sea `.sol` se trata

        como un TLD personalizado de ANS; no hay una lista blanca fija de TLD.
      schema:
        type: string
        default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
      examples:
        address:
          summary: Dirección de Solana
          value: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
        snsDomain:
          summary: Dominio SNS (.sol)
          value: toly.sol
        ansDomain:
          summary: TLD personalizado de ANS
          value: miester.bonk
  schemas:
    Identity:
      type: object
      properties:
        address:
          type: string
          description: Dirección de billetera de Solana
          example: HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
        type:
          type: string
          description: Tipo de entidad
          example: exchange
        name:
          type: string
          description: Nombre para mostrar
          example: Binance 1
        category:
          type: string
          description: Clasificación de categoría
          example: Exchange centralizado
        tags:
          type: array
          items:
            type: string
          description: Etiquetas de clasificación adicionales
          example:
            - Exchange centralizado
        domainNames:
          type: array
          items:
            type: string
          description: >-
            Todos los nombres de dominio en cadena propiedad de esta dirección,
            incluidos SNS (.sol) y los TLD personalizados de ANS (.bonk, .wen,
            etc.). El dominio .sol favorito aparece primero si está configurado;
            los dominios restantes se ordenan alfabéticamente. Se omite si la
            billetera no posee dominios.
          example:
            - toly.sol
            - kash.superteam
      required:
        - address
        - type
        - name
        - category
        - tags
    Error:
      type: object
      properties:
        error:
          type: string
          description: Mensaje de error
          example: Dirección de billetera no válida
        code:
          type: integer
          description: Código de estado HTTP
          example: 400
        details:
          type: string
          description: Detalles adicionales del error
          example: '''invalid-address'' no es una dirección de Solana válida'
      required:
        - error
        - code
  responses:
    BadRequest:
      description: Parámetros de solicitud no válidos
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Dirección de billetera no válida
            code: 400
            details: '''invalid-address'' no es una dirección de Solana válida'
    Unauthorized:
      description: Falta la clave de API o no es válida
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: >-
              Se requiere una clave de API. Envíala mediante ?api-key=xxx o el
              encabezado X-Api-Key
            code: 401
    RateLimited:
      description: Se superó el límite de solicitudes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: RATE_LIMIT_EXCEEDED
            code: 429
            details: Demasiadas solicitudes. Vuelve a intentarlo después de 2 segundos.
    InternalError:
      description: >-
        Error transitorio del servidor. Se puede reintentar con espera
        exponencial.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: INTERNAL_ERROR
            code: 500
            details: Ocurrió un error inesperado. Vuelve a intentarlo.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Clave de API enviada como parámetro de consulta
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Clave de API enviada en el encabezado de la solicitud

````