---
title: "Create a wallet"
---
To create a wallet, use the [Create a wallet](/api-reference/wallets/post-v1-wallets) endpoint. Each request requires a customer id and your Api Key:

```bash title="create a wallet request"
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:

```json title="create a wallet response"
{
  "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](/platform/wallets/retrieve-wallets#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](/getting-started/payments-and-supported-countries#pay-in-methods).