Skip to main content

Faucet API

The Faucet API allows you to request test tokens on the MOI public devnet for development and testing purposes.

1. Base URL​

https://dev.voyage-rpc.moi.technology/devnet/v2/faucet

2. How do I authenticate?​

The faucet API requires a faucet token in the URL path to authorize the request.

If you do not yet have a faucet token, please follow the Getting Started guide to generate one from your Voyage dashboard.

3. How do I request test tokens?​

Use HTTPS to call the faucet claim endpoint. In this example we use curl to request test tokens.

Note: Replace YOUR_API_KEY with a valid token from your voyage dashboard.

curl --location 'https://dev.voyage-rpc.moi.technology/devnet/v2/faucet/YOUR_API_KEY/claim' \
--header 'Content-Type: application/json' \
--data '{
    "address": "0xda7120153debabe8c41237a4f3c5e59e42653b1f6d541bdb217ccaba812aa0b5"
}'

4. Response​

A successful response will confirm that the faucet request has been accepted:

{"success":true,"message":"The request to claim the token was successful."}

If the faucet token is invalid or the address has exceeded request limits, an appropriate error message will be returned.

5. Notes​

  • Each account(moi id) can only request tokens once every fixed cooldown period.
  • Faucet tokens are only for testing and hold no real value.