Get tokens

​

Path parameters

• chain — the test network you want to receive funds on.
  • hoodi — receive testnet ETH on Hoodi.
  • sepolia — receive testnet ETH on Sepolia.
  • holesky — receive testnet ETH on Holesky.
  • bnb-testnet — receive testnet BNB.
  • amoy — receive testnet POL on Amoy testnet.
  • ton-testnet — receive TON for TON testnet.
  • zksync-testnet — receive testnet ETH on zkSync.
  • scroll-sepolia-testnet — receive testnet ETH on Scroll Sepolia.

​

Body parameters

• address — the address that will receive the funds.

​

Response

• url— the block explorer URL, including the transaction hash, to monitor the status.

​

Request funds from this page

1. Get your API key and paste it into the Bearer field in the AUTHENTICATION section.
2. At the bottom of the page, select which network you want to receive funds from.
3. At the bottom of the page, paste your Ethereum address in the address field.

​

Code examples

// npm i axios

const axios = require('axios');

// API config
const chain = 'sepolia' // goerli
const address = 'YOUR_ADDRESS';

const apiUrl = `https://api.chainstack.com/v1/faucet/${chain}`;
const apiKey = 'YOUR_CHAINSTACK_API_KEY';

const fillWallet = async () => {
    console.log(`Sending faucet request for address ${address}`)
  try {
    const response = await axios.post(apiUrl, { address }, {
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json',
      },
    });

    console.log('API call successful:', response.data);
  } catch (error) {
    console.error('Error making API call:', error.response.data);
  }

  // Schedule the next API call in 24 hours (24 * 60 * 60 * 1000 milliseconds)
  setTimeout(makeApiCall, 24 * 60 * 60 * 1000);
};

// Make the first API call immediately
fillWallet();

​

Use cases

• Smart contract development — with testnet funds, developers can deploy and interact with smart contracts, finding and fixing any issues before moving to the mainnet, where the real money is involved.
• Testing DApps and infrastructure — testnet funds allow developers to try out transactions, see how user interfaces work, and check the overall functionality of their DApps and blockchain components without risking real assets.
• Trying out new features — testnets are perfect for exploring and testing new features or updates to blockchain protocols and applications. It’s like a sandbox where developers can play around and validate their ideas before taking them live on the mainnet.
• Stress testing and scalability — developers use testnet funds to put their DApps or smart contracts through the wringer, seeing how they perform under various conditions and loads. This helps them spot any issues and fix them before going live.
• Learning and training — testnet funds create a risk-free space for developers, researchers, and enthusiasts to learn about blockchain technology, smart contracts, and DApps. It’s a great way to build expertise and understanding in the field.