# Get holder rewards

> What Cash Payback holders were paid across every coin: totals, dollars per asset, the top 25 coins and recent payouts newest first. A basket dividend is one row with every asset it paid.


`GET https://payday.direct/api/v1/rewards`

What Cash Payback holders were paid across every coin: totals, dollars per asset, the top 25 coins and recent payouts newest first. A basket dividend is one row with every asset it paid.

## Parameters

- `mint` (query, string): one coin only (top is then empty)
- `limit` (query, integer): recent rounds per page
- `cursor` (query, string): next_cursor from the previous page

## Responses

- 200: OK
- 401: Missing or invalid key
- 429: Over the limit. Retry-After says when to try again.

```json
{
  "data": {
    "totals": {
      "distributed_usd": "2418.68",
      "last_24h_usd": "512.30",
      "last_7d_usd": "2418.68",
      "rounds": 140,
      "dividends": 22,
      "transactions": 980,
      "paying_coins": 12,
      "holder_payouts": 4120,
      "wallets_paid": 1630,
      "assets_paid": 9,
      "last_distributed_at": "2026-11-15T19:25:14.126Z"
    },
    "by_asset": [
      {
        "asset": {
          "mint": "So11111111111111111111111111111111111111112",
          "symbol": "SOL"
        },
        "amount": "9.81",
        "usd": "1412.20",
        "rounds": 88,
        "coins": 7
      }
    ],
    "top": [
      {
        "mint": "3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump",
        "symbol": "Example",
        "category": "pairing",
        "reward_symbols": [
          "SOL"
        ],
        "distributed_usd": "57.49",
        "rounds": 3,
        "wallets_paid": 168,
        "last_at": "2026-11-15T19:25:14.126Z"
      }
    ],
    "recent": [
      {
        "id": "r812",
        "mint": "3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump",
        "symbol": "Example",
        "type": "round",
        "round": 3,
        "dividend": null,
        "asset": {
          "mint": "So11111111111111111111111111111111111111112",
          "symbol": "SOL"
        },
        "amount": "0.045607",
        "usd": "10.62",
        "wallets": 89,
        "transactions": 7,
        "tx": "3fQk...9aZ",
        "status": "done",
        "assets": [],
        "at": "2026-11-15T19:25:14.126Z"
      }
    ]
  },
  "next_cursor": "ODEy"
}
```

## Example

```bash
curl "https://payday.direct/api/v1/rewards" \
  -H "Authorization: Bearer pd_YOUR_KEY"
```