API Reference

Get wallets

Lists your wallets, newest first. Filters are exact and case-sensitive, except wallet_name.

GEThttps://api.gravv.xyz/v1/wallets

Query Parameters

Filter by customer ID

Filter by blockchain network

Possible values: polygon, ethereum, avalanche, stellar, solana

Matches part of the name you gave, in any case. It does not match the default label.

Exact address. EVM addresses must be in checksum case.

Filter by wallet type

Possible values: customer, master

When true, each wallet has its assets

Page number

Wallets per page. The API lowers a larger value to 100 instead of rejecting it.

Responses

Status	Description
`200`	A page of wallets
`400`	The request failed. A `page`, `items_per_page` or `include_balances` value that is not valid returns `invalid request payload`.

200 response

Wallets, newest first. Each item has assets only when include_balances is true.

The page size used, after it is limited to 100

{
"data": {
"items": [
  {
    "id": "2d52eb6d-4fac-44db-a225-d0e6aa13b0e3",
    "address": "GDZQAF4A2E5VZMMQVW7XG4FKWZ5KDSUEZF5VQBDQVM53TMU2YLE54NTX",
    "network": "stellar",
    "name": "my wallet",
    "date_created": "2026-10-12T09:14:03Z",
    "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
    "wallet_type": "customer"
  },
  {
    "id": "f3c8e5c0-cdb4-4b27-91cb-078943316c8e",
    "address": "0xF95b56b0Eba262df5461F4ec21E1dB88D0a86c6F",
    "network": "ethereum",
    "name": "wallet_9e3cccad-e9ae-47a0-81ee-063af0159310_ethereum",
    "date_created": "2026-10-11T21:07:30Z",
    "customer_id": "9e3cccad-e9ae-47a0-81ee-063af0159310",
    "wallet_type": "customer"
  }
],
"page": 1,
"items_per_page": 10,
"total_items": 24,
"total_pages": 3,
"has_next_page": true,
"has_previous_page": false
},
"error": null
}

400 response

{
"data": null,
"error": "invalid request payload"
}

Authorization

ApiKeyAuth

Was this page helpful?