---
title: "Wallets overview"
description: "Create and retrieve customer blockchain wallets."
---

# Wallets overview

Use the Wallets API to create blockchain wallets for customers and retrieve wallet details or lists.

<CardGroup cols={2}>
  <Card title="Browse wallet endpoints" icon="code" href="/api-reference/wallets/post-v1-wallets">
    Create a wallet or browse the operations in this category.
  </Card>
  <Card title="Wallets integration guide" icon="book" href="/platform/wallets/overview">
    Review wallet creation, retrieval, and funding guidance.
  </Card>
</CardGroup>

## How it works

Wallets are customer-owned blockchain addresses used for crypto transfers, FX settlement, and payment-link collection. Create one wallet per customer per network, then use the wallet as a source or destination in the [Transfers API](/api-reference/transfer/overview).

<Note>
For sandbox testing, create wallets on `polygon` and fund them with the [test funding guide](/platform/wallets/fund-wallets-during-testing).
</Note>

## Endpoints

| Endpoint | Description |
|---|---|
| [`POST /v1/wallets`](/api-reference/wallets/post-v1-wallets) | Create a blockchain wallet for a customer on a specified network |
| [`GET /v1/wallets`](/api-reference/wallets/get-v1-wallets) | List wallets, filterable by customer and blockchain network |
| [`GET /v1/wallets/{wallet_id}`](/api-reference/wallets/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](/getting-started/authentication) for details.