> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Embed BeaconScore in Your Product

> Integrate BeaconScore metrics into your staking platform or application

## 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.

<Note>
  **API Endpoint:** This guide uses `/api/v2/ethereum/validators/performance-aggregate` to fetch BeaconScore metrics.
</Note>

<Info>
  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.
</Info>

***

## Why Embed BeaconScore?

<CardGroup cols={2}>
  <Card title="Independent Validation" icon="shield-check">
    Provide users with trusted, third-party performance metrics that validate your operational quality.
  </Card>

  <Card title="Skip Backend Work" icon="rocket">
    Use our robust API to build real-time visualizations without building your own indexing infrastructure.
  </Card>

  <Card title="Ecosystem Retention" icon="users">
    Keep customers in your platform by offering independent data within your UI.
  </Card>

  <Card title="Competitive Advantage" icon="trophy">
    Differentiate your product with transparent performance reporting.
  </Card>
</CardGroup>

***

## Quick Start

### 1. Fetch BeaconScore Data

```bash theme={null}
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

```json theme={null}
{
  "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:

<Frame>
  <img src="https://mintcdn.com/bitflyexplorergmbh/u4FDQLNfRccMj2Kg/images/license-materials/beaconscore_black.svg?fit=max&auto=format&n=u4FDQLNfRccMj2Kg&q=85&s=af3f46de08814ba4df3fdea7290973a5" alt="BeaconScore" width="186" height="56" data-path="images/license-materials/beaconscore_black.svg" />
</Frame>

***

## Attribution Requirements

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

### 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` |

<Card title="Download License Materials" icon="download" href="/legal/license-materials">
  Download official badges in SVG and PNG formats
</Card>

<Tip>
  **Enterprise Exemption:** Enterprise API plan users are exempt from attribution requirements. [Contact sales](https://beaconcha.in/pricing) for details.
</Tip>

***

## API Plans for Integration

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

<Tip>
  For high-volume integrations or white-label requirements, [contact our sales team](https://beaconcha.in/pricing).
</Tip>

***

## Related Resources

* [Monitor Validator Performance](/use-cases/performance-introduction) — BeaconScore deep dive
* [BeaconScore Calculation](/beaconscore/introduction) — How the metric is calculated
* [License Materials](/legal/license-materials) — Download official badges
* [BeaconScore License](/legal/beaconscore-license) — Full terms and conditions