> ## 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 transferencias de billetera
> Obtén todas las transferencias de tokens y SOL de una dirección de billetera de Solana con paginación.
Cada solicitud cuesta **100 créditos**.
## Parámetros de la solicitud
Dirección de billetera de Solana (codificada en base58)
Número máximo de transferencias que se devolverán
Cursor de paginación de la respuesta anterior
## OpenAPI
````yaml es/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/transfers
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}/transfers:
get:
tags:
- Transferencias
summary: Obtén las transferencias de tokens
description: >
Recupera toda la actividad de transferencia de tokens de una billetera,
incluida la información del remitente y del destinatario.
Devuelve las transferencias en orden cronológico inverso (las más
recientes primero).
operationId: getWalletTransfers
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: limit
in: query
description: Cantidad máxima de transferencias que se devolverán
schema:
type: integer
minimum: 1
maximum: 100
default: 50
- name: cursor
in: query
description: Cursor de paginación de la respuesta anterior
schema:
type: string
responses:
'200':
description: El historial de transferencias se recuperó correctamente
content:
application/json:
schema:
$ref: '#/components/schemas/TransfersResponse'
'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: Dirección de billetera de Solana (codificada en base58)
schema:
type: string
pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
schemas:
TransfersResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Transfer'
pagination:
$ref: '#/components/schemas/Pagination'
required:
- data
- pagination
Transfer:
type: object
properties:
signature:
type: string
description: Firma de la transacción
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
timestamp:
type: integer
description: Marca de tiempo Unix en segundos
example: 1704067200
direction:
type: string
enum:
- in
- out
description: Dirección de la transferencia con respecto a la billetera
example: in
counterparty:
type: string
description: >-
La otra parte de la transferencia (remitente si es 'in' y
destinatario si es 'out')
example: HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664
mint:
type: string
description: >-
Dirección de acuñación del token
(So11111111111111111111111111111111111111112 para SOL)
example: So11111111111111111111111111111111111111112
symbol:
type: string
nullable: true
description: Símbolo del token, si se conoce
example: SOL
amount:
type: number
description: Cantidad transferida (legible, dividida entre los decimales)
example: 1.5
amountRaw:
type: string
description: >-
Cantidad bruta transferida en la unidad más pequeña (lamports para
SOL y cantidad bruta del token para tokens SPL)
example: '1500000000'
decimals:
type: integer
description: Decimales del token
example: 9
required:
- signature
- timestamp
- direction
- counterparty
- mint
- amount
- amountRaw
- decimals
Pagination:
type: object
properties:
hasMore:
type: boolean
description: Indica si hay más resultados disponibles
example: true
nextCursor:
type: string
nullable: true
description: Cursor para obtener la página siguiente de resultados
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
required:
- hasMore
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
````