Skip to main content
POST
/
private
/
faucet
Request testnet faucet (signed)
curl --request POST \
  --url https://exchange-api2.bulk.trade/api/v1/private/faucet \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": {
    "type": "faucet",
    "faucet": {
      "u": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
    }
  },
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "rpkxJezRft2xqfFxaqYRCTRtoobV4Z2Btqj6P52bEcAKczLn5Rgf2Yfm37UN4HGJwywR4QkuDjJUkwZ93DB2Fw9"
}
'
{
  "success": true
}
This endpoint is only available on testnet environments. You can claim once every hour.

Before You Start

See the Transaction Signing guide for details on how to sign your faucet requests.

Body

application/json

Signed transaction for requesting testnet faucet funds

action
object
required
account
string
required

Account public key (base58)

Example:

"FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"

signer
string
required

Signer public key (base58) - usually same as account

Example:

"FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"

signature
string
required

Ed25519 signature (base58)

Response

Faucet request successful

success
boolean
Example:

true