---
title: "Get historical per-epoch validator metrics"
method: GET
path: "/api/v1/validator/history"
tags: ["Validator"]
---

# Get historical per-epoch validator metrics

`GET /api/v1/validator/history`

## Request

- Base URL: `https://solentic.theblueprint.xyz`
- URL: `https://solentic.theblueprint.xyz/api/v1/validator/history`
- Auth: none required

Returns per-epoch history points (active stake, credits, APY, commission, skip rate) plus recent vote-success samples. Used to power dashboards and trend charts. Sourced from StakeWiz history endpoints.

## Response `200`

Validator history

- ValidatorHistory: Historical per-epoch validator metrics + recent vote-success samples
  - `epochs` object[]: Per-epoch history points
    - `epoch` integer
    - `totalActiveStake` number
    - `credits` number
    - `voteCredits` number
    - `stakingApy` number
    - `totalApy` number
    - `jitoApy` number
    - `commission` number
    - `skipRate` number
  - `voteSamples` object[]: Timestamped vote-success snapshots
    - `voteSuccess` number
    - `timestamp` string, date-time
  - `_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

- `429`: Rate limited — 100 requests per 60-second sliding window
- `502`: 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)