---
title: "Complete staking portfolio dashboard in a single call"
method: GET
path: "/api/v1/stake/summary/{walletAddress}"
tags: ["Intelligence"]
---

# Complete staking portfolio dashboard in a single call

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

## Request

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

Returns liquid balance, total staked, per-account states with action guidance and estimated daily rewards, current APY breakdown, epoch timing, and a recommended next action (STAKE/FUND/HOLD/WAIT/WITHDRAW) with the specific endpoint to call next. Replaces calling balance + accounts + APY + epoch endpoints separately.

## Path parameters

- `walletAddress` string, required

## Response `200`

Complete staking portfolio dashboard

- StakingSummaryResponse
  - `walletAddress` string: Solana wallet address for this portfolio summary
  - `portfolio` object: Wallet portfolio breakdown — liquid balance, staked balance, and allocation percentage
    - `liquidBalanceSol` number: Unstaked SOL in wallet
    - `totalStakedSol` number: Total SOL in stake accounts
    - `totalValueSol` number: Liquid + staked combined
    - `stakedPercentage` number: Percentage of total value that is staked
  - `accounts` object[]: Individual stake accounts with state, balance, and action guidance
    - `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)
    - `estimatedDailyRewardSol` number: Estimated daily reward for active stakes
  - `apy` object: Current APY breakdown — base staking yield plus Jito MEV rewards
    - `stakingApy` number: Base staking APY percentage
    - `jitoMevApy` number: Additional APY from Jito MEV rewards
    - `totalApy` number: Combined staking + Jito MEV APY percentage
  - `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
  - `recommendedAction` object: Intelligent next-step recommendation based on wallet state and balance
    - `action` 'STAKE' | 'FUND' | 'HOLD' | 'WAIT' | 'WITHDRAW': Recommended next action
    - `reason` string: Why this action is recommended
    - `toolCall` object: Endpoint (REST) and tool name (MCP) to execute the recommended action
      - `rest` string: REST API endpoint to call
      - `mcp` string: MCP tool name to invoke
  - `_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 or StakeWiz API 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)