Skip to main content
POST
/
faucet
Request Testnet Tokens
curl --request POST \
  --url https://api.beta.getpara.com/faucet \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "walletId": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
  "chain": "ETHEREUM_SEPOLIA"
}
'
{
  "transactionHash": "0x1234abcd...",
  "amount": "0.01",
  "chain": "ETHEREUM_SEPOLIA",
  "walletId": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f..."
}

Authorizations

​
X-API-Key
string
header
default:sk_your_secret_key_here
required

Your partner secret key (server-side only)

Headers

​
X-Request-Id
string<uuid>

UUID for request tracing. Para returns one if omitted.

Body

application/json
​
walletId
string
required

ID of the wallet to receive testnet tokens

Example:

"0a1b2c3d-4e5f-6789-abcd-ef0123456789"

​
chain
string
default:ETHEREUM_SEPOLIA

Target testnet chain

Example:

"ETHEREUM_SEPOLIA"

Response

Testnet tokens sent

​
transactionHash
string
required

On-chain transaction hash of the faucet transfer

Example:

"0x1234abcd..."

​
amount
string
required

Amount of testnet tokens sent in standard units

Example:

"0.01"

​
chain
string
required

Chain the tokens were sent on

Example:

"ETHEREUM_SEPOLIA"

​
walletId
string
required

ID of the wallet that received the tokens

Example:

"0a1b2c3d-4e5f-6789-abcd-ef0123456789"

​
address
string
required

On-chain address that received the tokens

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f..."