> ## 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.
# requestAirdrop
> requestAirdrop envía un airdrop de lamports a cualquier cuenta de Solana en devnet. Fondea una billetera de prueba con SOL antes de enviar transacciones durante el desarrollo.
## Parámetros de la solicitud
Dirección de la billetera de Solana (clave pública) que recibirá el airdrop de tokens SOL de prueba.
Cantidad de SOL que se enviará mediante airdrop, expresada en lamports (1 SOL = 1,000,000,000 lamports), para realizar pruebas.
Nivel de compromiso de la solicitud.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml es/openapi/rpc-http/requestAirdrop.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API de Solana enfocada en el desarrollo para solicitar airdrops de tokens
SOL en redes de prueba y financiar cuentas destinadas al desarrollo, las
pruebas y la experimentación de aplicaciones.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://devnet.helius-rpc.com
description: Endpoint RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: requestAirdrop
description: >
Solicita tokens SOL gratis en las redes de prueba de Solana para fines
de desarrollo y pruebas.
Esta API exclusiva para desarrollo permite financiar billeteras con SOL
en entornos de Devnet y Testnet
para crear y probar aplicaciones de Solana sin usar fondos reales. Es
esencial para el
desarrollo local, las canalizaciones de CI/CD, las pruebas automatizadas
y la experimentación con nuevas
funciones de Solana. Puedes usar los SOL recibidos mediante el airdrop
para pagar comisiones de transacción, crear cuentas
y probar lógica financiera en entornos que no son de producción.
operationId: requestAirdrop
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- requestAirdrop
description: El nombre del método RPC que se invocará.
example: requestAirdrop
default: requestAirdrop
params:
type: array
description: Parámetros de la solicitud de airdrop.
default:
- 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- 1000000000
items:
oneOf:
- type: string
description: >-
Dirección de la billetera de Solana (clave pública)
que recibirá el airdrop de tokens SOL de prueba.
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- type: integer
description: >-
Cantidad de SOL que se distribuirá mediante el
airdrop, expresada en lamports (1 SOL = 1,000,000,000
lamports), para realizar pruebas.
example: 1000000000
- type: object
description: Objeto de configuración para el airdrop.
properties:
commitment:
type: string
description: El nivel de compromiso de la solicitud.
enum:
- confirmed
- finalized
- processed
example: finalized
responses:
'200':
description: El airdrop se solicitó correctamente.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
result:
type: string
description: >-
Firma de la transacción de Solana correspondiente al
airdrop completado. Puedes usarla para verificar que se
recibieron los SOL.
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
'400':
description: >-
Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
con formato incorrecto.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: 'No autorizado: la clave de API no es válida o no se proporcionó.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: 'Error interno del servidor: se produjo un error en el servidor.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: >-
Servicio no disponible: el servicio no está disponible
temporalmente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: >-
Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
de espera de la solicitud.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: El código de error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````