Get Cedra Test Tokens via CLI & cURL

This short guide explains how to request Cedra testnet tokens (CEDRA) from CLI and from the command line using curl. These tokens are only for development and testing - they have no real‑world value, and it is impossible to mint CedraCoin on the Cedra mainnet.

Prerequisites

Installed CEDRA CLI you can use installation guide Cedra testnet account (address & authentication key). Use your account or generate one with the Cedra CLI:

cedra init

Save the account address (0x…) and the authentication key (64‑char hex).

1 · Fund via CLI faucet (1 CEDRA)

If you have the Cedra CLI installed, you can trigger the Cedra faucet directly without constructing a cURL request:

cedra account fund-with-faucet

• Funds 1 CEDRA to the specified account.
• Helpful when scripting alongside other Cedra CLI commands.

2 · Mint test tokens

curl --location --request POST \
  "https://faucet.cedra.dev/mint?amount=<AMOUNT>&auth_key=<AUTH_KEY>" \
  --data ''

Replace:

• <AMOUNT> - Number of CEDRA you want (e.g., 10) on Octas.
• <AUTH_KEY> - your authentication key.

Example:

curl --location --request POST \
  "https://faucet.cedra.dev/mint?amount=10&auth_key=e3219c42819854d01f0ea6865b78061cdf657374637fee8aee7501f9e6e185db" \
  --data ''

The faucet responds with a JSON payload containing the transaction hash.

3 · Verify your balance

After the transaction is finalized (normally within seconds), query the Cedra REST API:

curl "https://testnet.cedra.dev/v1/accounts/<ACCOUNT_ADDRESS>/balance/0x1::cedra_coin::CedraCoin"

Replace <ACCOUNT_ADDRESS> with your account address (0x…).

What's next?

• Start your write your first contract - via CLI guide
• Dive depper into the CLI - via CLI guide
• Build your first DApp - via our Real World Guides