Gravv DOCS
Docs Agent Get Started
API Reference Create a wallet

Create a wallet

Create a new blockchain wallet for a customer on the specified network.

POST/v1/wallets

Headers

Required for POST requests. Reuse only for an identical retry.

Request Body

ID of the customer to create a wallet for

Optional custom name for the wallet

Blockchain network for the wallet

Possible values: stellar, polygon, ethereum, base, solana, avalanche, sui, tron

Request Examples

{
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"name": "my wallet",
"network": "stellar"
}
{
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"name": "my wallet",
"network": "polygon"
}
{
"customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
"name": "my wallet",
"network": "ethereum"
}

Responses

Status Description
200 Wallet created successfully
400 Bad request — invalid input or missing required fields

200 response

Unique identifier for the wallet

ID of the customer who owns this wallet

Blockchain wallet address

Blockchain network

Possible values: stellar, polygon, ethereum, base, solana, avalanche, sui, tron

Wallet name or identifier

Timestamp when the wallet was created

{
"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
}

400 response

Authorization

  • ApiKeyAuth
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.

Ask me anything about the documentation.

ESC