> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gizatech.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet Information

> Get information about a specific wallet

<Note>
  **SDK Alternative**: Use `agent.portfolio()` for a simpler TypeScript interface. [See SDK docs](/sdk-reference/agent/monitoring)
</Note>

## Description

Retrieves detailed information about a specific wallet including status, deposits, withdrawals, and protocol allocations.

## Path Parameters

<ParamField path="chain_id" type="integer" required>
  The blockchain chain ID (e.g., 8453 for Base)
</ParamField>

<ParamField path="wallet" type="string" required>
  The wallet address to query
</ParamField>

## Query Parameters

<ParamField query="eoa" type="boolean" default="false">
  If `true`, treats the wallet parameter as an EOA (origin wallet) address and looks up the associated smart account
</ParamField>

## Response

<ResponseField name="wallet" type="string">
  The wallet address
</ResponseField>

<ResponseField name="status" type="string">
  Current agent status: `activated`, `activating`, `deactivating`, `deactivated`, `running`, `blocked`, `emergency`
</ResponseField>

<ResponseField name="deposits" type="array">
  List of deposits made to the wallet

  <Expandable>
    <ResponseField name="amount" type="integer">
      Deposit amount in smallest token unit
    </ResponseField>

    <ResponseField name="token_type" type="string">
      Token address
    </ResponseField>

    <ResponseField name="date" type="string">
      ISO date of deposit
    </ResponseField>

    <ResponseField name="tx_hash" type="string">
      Transaction hash
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="withdraws" type="array">
  List of withdrawals
</ResponseField>

<ResponseField name="selected_protocols" type="array">
  Protocols the agent is configured to use
</ResponseField>

<ResponseField name="current_protocol" type="string">
  Currently active protocol (if single protocol mode)
</ResponseField>

<ResponseField name="current_protocols" type="array">
  Currently active protocols (if multi protocol mode)
</ResponseField>

<ResponseField name="activation_date" type="string">
  ISO date when the agent was activated
</ResponseField>

<ResponseField name="last_deactivation_date" type="string">
  ISO date of last deactivation (if applicable)
</ResponseField>

<ResponseField name="eoa" type="string">
  The origin wallet address
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/wallets/0x1234567890abcdef1234567890abcdef12345678"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/wallets/0x1234567890abcdef1234567890abcdef12345678'
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://partners-backend-1038109371738.europe-west1.run.app/api/v1/8453/wallets/0x1234567890abcdef1234567890abcdef12345678'
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "wallet": "0x1234567890abcdef1234567890abcdef12345678",
    "status": "activated",
    "deposits": [
      {
        "amount": 1000000000,
        "token_type": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "date": "2024-01-15T10:30:00Z",
        "tx_hash": "0xabc..."
      }
    ],
    "withdraws": [],
    "selected_protocols": ["aave", "compound", "moonwell"],
    "current_protocols": ["aave"],
    "current_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "activation_date": "2024-01-15T10:35:00Z",
    "last_deactivation_date": null,
    "last_reactivation_date": null,
    "eoa": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "detail": "Data not found for the wallet"
  }
  ```
</ResponseExample>
