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

# Overview

> Automate tracking, calculation, and distribution of rewards to partners.

<Note>
  The Rewards Engine is currently in **Preview**. Functionality, scope, and limits may change before General Availability. See [Preview scope and roadmap](#preview-scope-and-roadmap) for what is and isn't supported today.
</Note>

## What is the Rewards Engine?

The Rewards Engine automates the tracking, calculation, and distribution of rewards to partners.

The Rewards Engine is designed as a Paxos platform capability, so it supports any stablecoin issued through Paxos. Partners interact through the Paxos Dashboard, the API, directly with the smart contract, or any combination of these interfaces.

### Who is this for?

Distribution partners holding or distributing Paxos-issued stablecoins who want to manage their downstream rewards program with ease. This guide covers content relevant to account managers, developers, finance, product, and program managers.

## How it works

The Rewards Engine currently processes **custody rewards**. Support for additional reward types and tracking and calculation capabilities may be added based on customer needs.

### Custody rewards flow

<Steps>
  <Step title="Submit wallets">
    Register reward addresses for monitoring.
  </Step>

  <Step title="Daily snapshot">
    Balances are captured on-chain.
  </Step>

  <Step title="Rewards calculation">
    The applicable rate is multiplied by the captured balance.
  </Step>

  <Step title="Payouts">
    Rewards are claimed to the assigned payout group.
  </Step>

  <Step title="Reporting">
    Activity is reflected in the Dashboard and via the API.
  </Step>
</Steps>

## Key concepts

| Concept        | Definition                                                                                                                                                                                                                                                              |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rewards wallet | A blockchain address that accumulates rewards for eligible stablecoin activity. Rewards addresses are submitted for monitoring, and a snapshot of the daily balance is used to calculate rewards accrued.                                                               |
| Payout group   | A group of rewards wallets that receive rewards distributions collectively to a single destination address. Payout groups are chain- and jurisdiction-specific. Partners can create additional payout groups to represent different product lines or customer segments. |
| Claims         | Define when and how an organization receives rewards payouts. In Preview, the Rewards Engine supports automatic daily claims.                                                                                                                                           |
| Jurisdiction   | Payout groups carry a jurisdiction designation (EU or non-EU) that maps to the applicable earnings rate agreed upon at the contractual level.                                                                                                                           |
| Earnings rate  | Rewards rate applied to the balance daily. Rates are set at the partner level.                                                                                                                                                                                          |

## Access and interfaces

Distribution partners access the Rewards Engine through three primary surfaces: the Paxos Dashboard, the API, and direct smart contract interaction. The Paxos Dashboard and APIs are currently available in Preview.

### Dashboard

The Dashboard provides a daily view of Rewards Engine activity, including:

* **Rewards summary**: total lifetime earned, available to claim, and estimated next accrual.
* **Current earnings rate** and next accrual period.
* **Payout group overview** with balance and destination address.
* **Claims history**: per-period payout amounts.
* **Rewards wallet list** per payout group.

### API

The API supports both programmatic queries and configuration. Most features available in the Dashboard are also supported through the API. See the [Rewards Engine API reference](/api-reference/endpoints/reward-addresses/overview) for details.

## Preview scope and roadmap

The following table summarizes what's in scope today and what's planned. Customer feedback directly shapes this roadmap.

| Capability                                 | Beta        | GA          | Future                      |
| ------------------------------------------ | ----------- | ----------- | --------------------------- |
| Daily automated claims                     | ✓           | ✓           | ✓                           |
| API access                                 | ✓           | ✓           | ✓                           |
| Manual claims                              | ✗           | ✗           | ✓                           |
| Jurisdiction-specific rates                | ✓           | ✓           | ✓                           |
| Claim schedules (weekly, monthly)          | ✗           | In progress | ✓                           |
| Payout group management                    | ✓           | ✓           | ✓                           |
| Custom rates per payout group              | ✗           | In progress | ✓                           |
| Wallet verification                        | In progress | ✓           | ✓                           |
| In-product monthly statements              | In progress | ✓           | ✓                           |
| Wallet-level statement data                | ✓           | ✓           | ✓                           |
| Rewards calculation — custody rewards      | ✓           | ✓           | ✓                           |
| Rewards calculation — custom event rewards | ✗           | ✗           | Contact us for requirements |

<Warning>
  **Preview limitations to plan around**

  * Claims run automatically — partners cannot trigger manual payouts during Preview.
  * End-of-month statements are delivered outside the product (email, Slack, or other supported channels).
  * Wallet verification is not enforced today, but will be required after GA with a grace period. Partners onboarding now should plan for verification prior to GA launch.
</Warning>

## Questions or feedback?

Contact your account manager or email [support@paxos.com](mailto:support@paxos.com) with feedback, feature requests, or questions about onboarding.