Fund account wallets during testing

When testing your Gravv integration, you need testnet tokens to fund accounts. Each account includes a wallet address that you can fund using Circle’s Testnet Faucet.

Get the account wallet address

Start by using the Get a single account endpoint to retrieve the wallet address:

curl --request GET \
     --url https://api.gravv.xyz/v1/accounts/<account id> \
     --header 'Api-Key: <Api Key>'

Save the wallet_address and blockchain_network from the response:

{
  "data": {
    "wallet_address": "0xf73bdd069dc31aa8f334b177b175936ba98237a2",
    "blockchain_network": "polygon",
    "balance": "0.00",
    ...
  }
}

Fund the wallet

Use Circle’s Testnet Faucet to send testnet tokens to your wallet address:

Visit Testnet Faucet.
Select the blockchain network that matches your account.
Enter your wallet_address in the address field.
Select the token type, USDC.
Click Send 1 USDC to request tokens.

The faucet sends 1 USDC to your wallet address, and funds arrive within a few minutes, depending on network congestion.

To check your balance, use the Get a single account endpoint again.