---
title: "List stake accounts for wallet"
method: GET
path: "/api/v1/stake/accounts/{walletAddress}"
tags: ["Staking"]
---

# List stake accounts for wallet

`GET /api/v1/stake/accounts/{walletAddress}`

## Request

- Base URL: `https://solentic.theblueprint.xyz`
- URL: `https://solentic.theblueprint.xyz/api/v1/stake/accounts/{walletAddress}`
- Auth: none required

Returns all stake accounts delegated to Blueprint validator for the given wallet address. Shows balances, states, and authorities.

## Path parameters

- `walletAddress` string, required

## Response `200`

Stake accounts

- StakeAccountsResponse
  - `walletAddress` string: Queried wallet address
  - `validatorVoteAccount` string: Blueprint validator vote account address
  - `accounts` StakeAccountInfo[]: Stake accounts delegated to Blueprint
    - `address` string: Stake account address (base58)
    - `lamports` integer: Balance in lamports
    - `sol` number: Balance in SOL
    - `state` string: Account state: delegated, inactive, activating, deactivating
    - `voter` string: Validator vote account this stake is delegated to
    - `stakeAuthority` string: Public key authorized to stake/unstake (should be your wallet)
    - `withdrawAuthority` string: Public key authorized to withdraw (should be your wallet)
    - `activationEpoch` string: Epoch when stake was activated
    - `deactivationEpoch` string, nullable: Epoch when deactivation was requested, or null if still active
    - `action` string: Suggested next action based on account state (e.g., unstake, withdraw, wait for cooldown)
  - `totalStakedSol` number: Total SOL staked across all accounts
  - `epochTiming` EpochTiming: Current epoch timing information with estimated end time
    - `currentEpoch` integer: Current Solana epoch number
    - `slotsRemaining` integer: Slots remaining in current epoch
    - `estimatedSecondsRemaining` integer: Estimated seconds until epoch end
    - `estimatedEpochEnd` string, date-time: Estimated epoch end timestamp
    - `note` string: Explanation of epoch timing relevance
  - `message` string: Informational message (included when no accounts found)
  - `nextSteps` object: Suggested next steps (included when no accounts found)
  - `_meta` ResponseMeta: Navigation metadata included in most responses
    - `endpoint` string: The endpoint that generated this response
    - `description` string: Brief description of the response
    - `timestamp` string, date-time: ISO 8601 timestamp when this response was generated
    - `relatedEndpoints` object: Related REST endpoints for next actions
    - `relatedTools` object: Related MCP tool names (MCP responses only)
    - `nextSteps` object: Contextual next steps based on response data
    - `verifyThisCode` string: Endpoint to verify code integrity
    - `cacheTtlSeconds` integer: Cache TTL for this response
    - `documentation` string: Link to documentation
    - `support` object: Optional donation info — Blueprint is free, donation-supported infrastructure
      - `address` string: Solana address for donations
      - `message` string: Context about why donations help
      - `donate` string: How to build a donation transaction via API/MCP

## Other responses

- `400`: Invalid wallet address
- `429`: Rate limited — 100 requests per 60-second sliding window
- `500`: Internal server error
- `502`: Solana RPC unavailable

---

[API](https://skmtc.dev/theblueprint/apis/blueprint-staking-api.md) · [All operations](https://skmtc.dev/theblueprint/apis/blueprint-staking-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theblueprint/apis/blueprint-staking-api/revisions/326d6015b851?raw)
