# Overview

### Chorus One Rewards API

The **Chorus One Rewards API** provides comprehensive access to staking rewards data across multiple blockchain networks. **Built for Chorus One clients and partners**, these APIs offer reward tracking with enterprise-grade reliability.

### **Supported Networks**

| Network      | Coverage                      | Key Features                                                           |
| ------------ | ----------------------------- | ---------------------------------------------------------------------- |
| **Solana**   | Validator & Delegator rewards | Voting rewards, transaction fees, Jito MEV tips                        |
| **Ethereum** | StakeWise protocol staking    | Daily rewards, withdrawal tracking, event monitoring                   |
| **TON**      | TON Pool-based staking        | TON pool support, pool level or individual nominators reward reporting |

### **What You Can Track**

* **Daily (epoch) reward earnings** across all supported networks
* **Historical performance** with flexible date range queries
* **Validator/pool performance** metrics and commission structures
* **Staking events** including deposits, withdrawals, and delegation changes

### **Get Started**

1. **Get your API key** from Chorus One
2. **Choose your network** - start with any of our three supported chains
3. **Make your first call** - query rewards for any validator or delegator address

Ready to start tracking staking rewards? Let's get you authenticated and making your first API calls.

### **Authentication** <a href="#undefined" id="undefined"></a>

All API requests require authentication using an API key passed in the request header.

### **API Key Setup**

To access the Chorus One Rewards API, you'll need an API key from our team:

1. **Contact Chorus One** to request API access
2. **Receive your unique API key** via secure communication
3. **Include the key** in all API requests using the `X-API-KEY` header

### **Using Your API Key**

Add your API key to every request header:

```
bashX-API-KEY: your-api-key-here
```

### **Example Requests**

**cURL:**

```bash
curl -H "X-API-KEY: your-api-key-here" \
  "https://api.chorus.one/solana-rewards/v0/delegator_rewards?delegator_address=ADDRESS"
```

**JavaScript:**

```javascript
const headers = {
  'X-API-KEY': 'your-api-key-here',
  'Content-Type': 'application/json'
};

fetch('https://api.chorus.one/ethereum-rewards/v0/delegator_rewards', {
  headers: headers
})
```

**Python:**

```python
import requests

headers = {
    'X-API-KEY': 'your-api-key-here'
}

response = requests.get(
    'https://api.chorus.one/ton-rewards/v0/details',
    headers=headers
)
```

### Modules Overview

#### Supported Networks

* [**Ethereum**](https://kb.chorus.one/api-reference/ethereum-rewards-api)
* [**Solana**](https://kb.chorus.one/api-reference/solana-rewards-api)
* [**TON**](https://kb.chorus.one/api-reference/ton-rewards-api)

### Next Steps

To help you get started with specific blockchain networks, please check out the detailed guides for each supported chain below.

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Ethereum</strong></td><td><a href="ethereum-rewards-api">ethereum-rewards-api</a></td><td><a href="broken-reference">Broken link</a></td><td><a href="https://161360822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyuw4Rsarhx3nMuCdobop%2Fuploads%2F99Rzfkv8QkxVpCvavSIx%2Fethereum.png?alt=media&#x26;token=35c26cd2-050e-4082-a142-0d93ac1c4a51">ethereum.png</a></td></tr><tr><td><strong>Solana</strong></td><td><a href="solana-rewards-api">solana-rewards-api</a></td><td><a href="broken-reference">Broken link</a></td><td><a href="https://161360822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyuw4Rsarhx3nMuCdobop%2Fuploads%2F3SD9WnzCdLwUoova4faJ%2Fsolana.png?alt=media&#x26;token=9d9756b9-8250-4af4-a785-f8ea408a0307">solana.png</a></td></tr><tr><td><strong>TON</strong></td><td><a href="ton-rewards-api">ton-rewards-api</a></td><td><a href="broken-reference">Broken link</a></td><td><a href="https://161360822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyuw4Rsarhx3nMuCdobop%2Fuploads%2Fx9HbgHP2JpP4H4WzoC0e%2Fton.png?alt=media&#x26;token=0970392d-71cd-4911-8d7f-073f9a13efa0">ton.png</a></td></tr></tbody></table>
