Embed BeaconScore in Your Product

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:

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 metrics:

Format	Light Mode	Dark Mode
SVG	`beaconscore_black.svg`	`beaconscore_white.svg`
PNG	`beaconscore_black.png`	`beaconscore_white.png`

Powered by beaconcha.in Badge

Use when your product uses any beaconcha.in API data:

Format	Light Mode	Dark Mode
SVG	`poweredby_black.svg`	`poweredby_white.svg`
PNG	`poweredby_black.png`	`poweredby_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

Plan	Best For	BeaconScore Access
Scale	Production integrations	Full access, attribution required
Enterprise	White-label solutions	Full access, attribution optional

For high-volume integrations or white-label requirements, contact our sales team.

Monitor Validator Performance — BeaconScore deep dive
BeaconScore Calculation — How the metric is calculated
License Materials — Download official badges
BeaconScore License — Full terms and conditions

Introduction

V2 API Docs

V1 API Docs

Embed BeaconScore in Your Product

Overview

Why Embed BeaconScore?

Independent Validation

Skip Backend Work

Ecosystem Retention

Competitive Advantage

Quick Start

1. Fetch BeaconScore Data

2. Display in Your UI

3. Add Attribution

Attribution Requirements

BeaconScore Badge

Powered by beaconcha.in Badge

Download License Materials

API Plans for Integration

​Overview

​Why Embed BeaconScore?

Independent Validation

Skip Backend Work

Ecosystem Retention

Competitive Advantage

​Quick Start

​1. Fetch BeaconScore Data

​2. Display in Your UI

​3. Add Attribution

​Attribution Requirements

​BeaconScore Badge

​Powered by beaconcha.in Badge

Download License Materials

​API Plans for Integration

​Related Resources

Overview

Why Embed BeaconScore?

Quick Start

1. Fetch BeaconScore Data

2. Display in Your UI

3. Add Attribution

Attribution Requirements

BeaconScore Badge

Powered by beaconcha.in Badge

API Plans for Integration

Related Resources