Create a wallet

To create a wallet, use the Create a wallet endpoint. Each request requires a customer id and your Api Key:

curl --request POST \
     --url https://api.gravv.xyz/v1/wallets \
     --header 'Api-Key: <Api Key>' \
     --header 'Idempotency-Key: 979879887678789_attempt_1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
  "name": "my wallet",
  "network": "stellar"
}
'

After sending the request, you will get a response that includes the wallet address and other wallet details:

{
  "data": {
    "address": "GDZQAF4A2E5VZMMQVW7XG4FKWZ5KDSUEZF5VQBDQVM53TMU2YLE54NTX",
    "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
    "date_created": "2025-10-30T12:18:34.484+00:00",
    "id": "2d52eb6d-4fac-44db-a225-d0e6aa13b0e3",
    "name": "my wallet",
    "network": "stellar"
  },
  "error": null
}

You can create multiple wallets for a specific customer. To retrieve all wallets associated with a particular customer, see Filter wallets by customer.

Once created, the wallet can receive stablecoins on its specified blockchain network. You can share the wallet address with anyone who needs to send you stablecoins.

Each wallet can only receive stablecoins that match both the blockchain network and the supported stablecoin for that network. For information on the stablecoins you can receive on each blockchain network, see Pay-in methods.