---
title: "Get global validator peer-density distribution by city"
method: GET
path: "/api/v1/network/peer-density"
tags: ["Validator"]
---

# Get global validator peer-density distribution by city

`GET /api/v1/network/peer-density`

## Request

- Base URL: `https://solentic.theblueprint.xyz`
- URL: `https://solentic.theblueprint.xyz/api/v1/network/peer-density`
- Auth: none required

Returns the top Solana validator cities ranked by validator count, with per-city share, scored-validator count, and median APY. Includes the validator's own city for context and a global median APY across all scored validators.

## Response `200`

Peer density distribution

- PeerDensityResponse: Global validator peer-density distribution by city
  - `totalValidators` integer: Total active validators on the network
  - `globalMedianApy` number: Median APY across all scored validators globally
  - `ourCity` string: Blueprint validator's host city
  - `cities` object[]: Cities ranked by validator count
    - `city` string
    - `country` string
    - `count` integer: Number of validators in this city
    - `pct` number: Share of network as a percentage
    - `scored` integer: How many active validators contributed to medianApy
    - `medianApy` number, nullable: Median APY for the city — null if fewer than 3 scored validators
  - `_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`: Upstream data 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)