Skip to main content

​
Overview

BeaconScore provides an independent, trusted metric for validator performance. By embedding BeaconScore in your product, you can offer your users transparent performance data while keeping them in your ecosystem.
API Endpoint: This guide uses /api/v2/ethereum/validators/performance-aggregate to fetch BeaconScore metrics.
BeaconScore is a proprietary metric developed by beaconcha.in. Attribution is required when displaying BeaconScore publicly. Enterprise plan users may be exempt from attribution requirements.

​
Why Embed BeaconScore?

Independent Validation

Provide users with trusted, third-party performance metrics that validate your operational quality.

Skip Backend Work

Use our robust API to build real-time visualizations without building your own indexing infrastructure.

Ecosystem Retention

Keep customers in your platform by offering independent data within your UI.

Competitive Advantage

Differentiate your product with transparent performance reporting.

​
Quick Start

​
1. Fetch BeaconScore Data

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/performance-aggregate \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "mainnet",
  "validator": {
    "validator_identifiers": [1, 2, 3]
  },
  "range": {
    "evaluation_window": "30d"
  }
}
'

​
2. Display in Your UI

{
  "data": {
    "beaconscore": {
      "total": 0.9945,
      "attestation": 0.9952,
      "proposal": 0.9876,
      "sync_committee": 0.9991
    },
    "duties": {
      "proposal": { "successful": 3, "missed": 0 }
    }
  }
}

​
3. Add Attribution

Include the BeaconScore badge when displaying the metric publicly:
BeaconScore

​
Attribution Requirements

Required: When displaying BeaconScore data publicly in your application, website, or reports, you must include appropriate attribution using our official badges.

​
BeaconScore Badge

Use when displaying BeaconScore/Efficiency metrics:
FormatLight ModeDark Mode
SVGbeaconscore_black.svgbeaconscore_white.svg
PNGbeaconscore_black.pngbeaconscore_white.png

​
Powered by beaconcha.in Badge

Use when your product uses any beaconcha.in API data:
FormatLight ModeDark Mode
SVGpoweredby_black.svgpoweredby_white.svg
PNGpoweredby_black.pngpoweredby_white.png

Download License Materials

Download official badges in SVG and PNG formats
Enterprise Exemption: Enterprise API plan users are exempt from attribution requirements. Contact sales for details.

​
API Plans for Integration

PlanBest ForBeaconScore Access
ScaleProduction integrationsFull access, attribution required
EnterpriseWhite-label solutionsFull access, attribution optional
For high-volume integrations or white-label requirements, contact our sales team.