Add 500 STX tokens to the specified testnet address. Testnet STX addresses begin with ST. If the stacking
parameter is set to true, the faucet will add the required number of tokens for individual stacking to the
specified testnet address.
The endpoint returns the transaction ID, which you can use to view the transaction in the
Stacks Explorer. The tokens are delivered once the transaction has
been included in an anchor block.
A common reason for failed faucet transactions is that the faucet has run out of tokens. If you are experiencing
failed faucet transactions to a testnet address, you can get help in Discord.
Note
This is a testnet only endpoint. This endpoint will not work on the mainnet.
Status code
Description
200
Success
500
Faucet call failed
POST request that initiates a transfer of tokens to a specified testnet address