---
title: "Get vault wallet"
method: GET
path: "/vault-wallet"
tags: ["Vault Wallet"]
---

# Get vault wallet

`GET /vault-wallet`

Retrieve a specific vault wallet by address (agent_address or vault_address)

## Query parameters

- `vaultAddress` string, required

## Response `200`

Vault wallet retrieved successfully

- GetVaultWalletResponseDto
  - `id` string, required — Unique identifier for the vault wallet
  - `vaultAddress` object, required — Vault wallet address
  - `leader_address` string, required — Vault wallet address
  - `agentAddress` string, required — Public address
  - `isApproved` boolean, required — Whether the vault wallet is approved for trading
  - `createdAt` string, required — Timestamp when the vault wallet was created
  - `updatedAt` string, required — Timestamp when the vault wallet was last updated
  - `privyWalletId` string, required — Privy wallet ID for creating the signer
  - `name` object, nullable — Vault wallet name
  - `about` object, nullable — Vault wallet description/about
  - `imageUrl` object, nullable — Image URL for the vault wallet
  - `transactionHash` object, nullable — Transaction hash from vault creation

## Other responses

- `401` — Unauthorized - invalid or missing token
- `404` — Vault wallet not found

---

[API](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api.md) · [All operations](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pearprotocol/pear-protocol-trading-api/revisions/d5e1438dfaa7/schema)