Wallets overview
Use the Wallets API to create blockchain wallets for customers and retrieve wallet details or lists.
Create a wallet or browse the operations in this category.
Review wallet creation, retrieval, and funding guidance.
How it works
Wallets are customer-owned blockchain addresses used for crypto transfers, FX settlement, and collections. Every create call makes a new wallet with a new address, even for the same customer and network. Send a new Idempotency-Key only when you want another wallet. Use the wallet as a source or destination in the Transfers API.
Send networks in lower case: polygon, ethereum, avalanche, stellar, solana. Supported networks and coins lists the coins booked on each network. List filters are exact and case-sensitive, except wallet_name.
In sandbox, the USDC balance of a wallet on an EVM network is the sandbox test dollar, so faucet USDC does not show there. A public test-network faucet works for stellar and solana wallets. See Fund wallets during testing.
Endpoints
| Endpoint | Description |
|---|---|
POST /v1/wallets |
Create a blockchain wallet for a customer on the network you choose |
GET /v1/wallets |
List wallets, filterable by customer and blockchain network |
GET /v1/wallets/{wallet_id} |
Retrieve a single wallet |
Authentication
All requests use https://api.gravv.xyz/v1/ and authenticate with the Api-Key header. See Authentication for details.