Retrieve wallets

retrieve wallets with optional filtering by customer, or retrieve a single wallet by its id

Retrieve wallets

Use the Get wallets endpoint to retrieve wallets. The endpoint provides optional filtering by customer, blockchain network, and pagination.

curl --request GET \
     --url https://api.gravv.xyz/v1/wallets \
     --header 'Api-Key: <Api Key>'

You will get a paginated response similar to this:

{
  "data": {
    "pagination": {
      "has_next_page": true,
      "has_previous_page": false,
      "items_per_page": 10,
      "page": 1,
      "total_items": 24,
      "total_pages": 3
    },
    "wallets": [
      {
        "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": "wallet_9e3cccad-e9ae-47a0-81ee-063af0159310_stellar_sandbox",
        "network": "stellar"
      },
      {
        "address": "0xf95b56b0eba262df5461f4ec21e1db88d0a86c6f",
        "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
        "date_created": "2025-10-14T21:07:30.836+00:00",
        "id": "f3c8e5c0-cdb4-4b27-91cb-078943316c8e",
        "name": "wallet_9e3cccad-e9ae-47a0-81ee-063af0159310_ethereum",
        "network": "ethereum"
      }
    ]
  },
  "error": null
}

Filter wallets by customer

To retrieve all wallets associated with a specific customer, include the customer id as a query parameter:

curl --request GET \
     --url 'https://api.gravv.xyz/v1/wallets?customer_id=<customer id>' \
     --header 'Api-Key: <Api Key>'

Filter wallets by blockchain network

To retrieve wallets on a specific blockchain network, include the network as a query parameter:

curl --request GET \
     --url 'https://api.gravv.xyz/v1/wallets?network=stellar' \
     --header 'Api-Key: <Api Key>'

Combine filters

You can combine customer id and network filters to retrieve wallets for a specific customer on a specific blockchain:

curl --request GET \
     --url 'https://api.gravv.xyz/v1/wallets?customer_id=<customer id>&network=stellar' \
     --header 'Api-Key: <Api Key>'

Get paginated response

You can control the number of results and navigate through pages using pagination parameters:

page: page number to retrieve
items_per_page: number of wallets per page

curl --request GET \
     --url 'https://api.gravv.xyz/v1/wallets?page=2&items_per_page=20' \
     --header 'Api-Key: <Api Key>'

Retrieve a single wallet

Use the Get a single wallet endpoint to retrieve details of a specific wallet by its wallet id:

curl --request GET \
     --url https://api.gravv.xyz/v1/wallets/<wallet id> \
     --header 'Api-Key: <Api Key>'

You will get a response similar to this:

{
  "data": {
    "address": "GCSCHETEM6QJDPTHXBL42SXLN5QIMAWYMSCKQ6QUC66IBVBBCWVL4B26",
    "assets": [
      {
        "balance": "0",
        "symbol": "USDC"
      }
    ],
    "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
    "date_created": "2025-10-30T12:18:34.484+00:00",
    "id": "6cc379fb-b458-40b9-8b4e-a2bb4a411a1c",
    "name": "my wallet",
    "network": "stellar"
  },
  "error": null
}