requestAirdrop RPC Method

Please note that the Airdrop method is subject to limits set by Solana. For more tools for getting Devnet SOL, check out our Guide on : A Complete Guide to Airdropping Test SOL on Solana

Parameters

pubkey

string

The Pubkey of account to receive lamports, as a base-58 encoded string

lamports

integer

The lamports to airdrop, as a u64

object

array

The configuration object with the following fields:

commitment

string

The level of commitment required for the query. The options include:

finalized

string

The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized

confirmed

string

The node will query the most recent block that has been voted on by the supermajority of the cluster

processed

string

The node will query its most recent block. Note that the block may not be complete

Returns

result

The transaction signature of the airdrop, as a base-58 encoded string

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0", "id":1, "method":"requestAirdrop", "params": ["YOUR_WALLET_ADDRESS", 1000000000]}'

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "requestAirdrop",
  "params": [
    "YOUR_WALLET_ADDRESS",
    1000000000
  ]
})

response = https.request(request)
puts response.read_body

import { createSolanaRpc, address, lamports } from "@solana/kit";

(async () => {
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
  const walletAddress = address("YOUR_WALLET_ADDRESS");
  const airdropAmount = lamports(BigInt(1_000_000_000));

  try {
    const airdropSignature = await solanaRpc.requestAirdrop(walletAddress, airdropAmount).send();
    console.log(airdropSignature);
  } catch (error) {
    console.error("Error requesting airdrop:", error);
  }
})();

const web3 = require("@solana/web3.js");
(async () => {
  const url = "https://docs-demo.solana-mainnet.quiknode.pro/";
  const solana = new web3.Connection(url);
  console.log(
    await solana.requestAirdrop(
      new web3.PublicKey("YOUR_WALLET_ADDRESS"),
      1000000000
    )
  );
})();

from solana.rpc.api import Client
from solana.publickey import PublicKey
print(solana_client.request_airdrop(PublicKey("YOUR_WALLET_ADDRESS"), 1000000000))

use reqwest::header;
use reqwest::Client;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = Client::new();
    let json_data = r#"
    {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "requestAirdrop",
        "params": [
            "YOUR_WALLET_ADDRESS",
            1000000000
        ]
    }
    "#;
    let response = client
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
        .headers(headers)
        .body(json_data)
        .send()
        .await?; 

    let body = response.text().await?;
    println!("{}", body);

    Ok(())
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free