Fund wallets during testing

When testing your Gravv integration, you can fund wallets created using the Create a wallet endpoint with Circle’s Testnet Faucet.

Get the wallet address

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

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

Save the address and network from the response:

{
  "data": {
    "address": "GDZQAF4A2E5VZMMQVW7XG4FKWZ5KDSUEZF5VQBDQVM53TMU2YLE54NTX",
    "network": "stellar",
    "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
    ...
  }
}

Find wallet ID

If you don't have the wallet id, use the Get wallets endpoint with a customer id and save the id from the response:

curl --request GET \
     --url 'https://api.gravv.xyz/v1/wallets?customer_id=<customer id>' \
     --header 'Api-Key: <Api Key>'

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 wallet.
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.