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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.chorus.one/api-reference/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.