TriportRPC
DashboardDocs

requestAirdrop

Last updated:

requestAirdrop asks the cluster to credit a given account with a number of lamports and returns the base-58 transaction signature of the airdrop transfer. It is the standard way to fund a wallet with test SOL during local development and integration testing.

Devnet / testnet only. Airdrops are a faucet feature of Solana's test clusters. This method has no effect on mainnet — there is no faucet on mainnet and any request routed there will fail. Point your client at a devnet or testnet endpoint when calling requestAirdrop.

The returned value is just the signature string; use a confirmation method such as getSignatureStatuses (or poll getBalance) to wait until the airdrop has landed before relying on the funds. Faucets are rate-limited and may cap the lamports granted per request, so request modest amounts and retry if a drop is declined.

Parameters

requestAirdrop parameters
NameTypeRequiredDescription
pubkeyPubkeyYes
lamportsintegerYes
configCommitmentConfigNo

Returns

requestAirdrop return value
FieldType
resultobject

Examples

curl https://triport.io/sol \
  -X POST -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <api-key>' \
  -d '{"id":1,"method":"requestAirdrop","params":["<pubkey>","<lamports>","<config>"],"jsonrpc":"2.0"}'
const res = await fetch("https://triport.io/sol", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer <api-key>" },
  body: JSON.stringify({
  "id": 1,
  "method": "requestAirdrop",
  "params": [
    "<pubkey>",
    "<lamports>",
    "<config>"
  ],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post(
    "https://triport.io/sol",
    headers={"Authorization": "Bearer <api-key>"},
    json={"id":1,"method":"requestAirdrop","params":["<pubkey>","<lamports>","<config>"],"jsonrpc":"2.0"},
)
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet, devnet, testnet.
  3. Credit cost: 5 per call.

FAQ

What does requestAirdrop do?
Requests an airdrop of lamports to a Solana public key — for use on devnet and testnet only.
How many credits does requestAirdrop cost?
requestAirdrop costs 5 credit(s) per call on Triport by default.
Is requestAirdrop available over WebSocket?
requestAirdrop is an HTTP JSON-RPC method.