# Earn Products

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The Earn products your tenant offers on a network, each with its state and rate on every chain it is on.

## Overview

- Only the products your tenant has on that network [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md) are listed: without one, `products` is empty ([Earn](https://docs.aureahub.com/docs/guide-earn.md)).
- Each venue is read now: `observedAt` is when the state and the rate were true, and `fresh` whether a deposit or a withdrawal may be decided on them. `readable: false` when the chain could not be read; `apy` is in percent.
- `status` is the product's own (`active`, `paused`, `retired`); `acceptsDeposits` whether it takes new deposits. `limits` are your tenant's per deposit, in the asset's smallest unit (`null`: no limit). `disclosureVersion` is the version the user must have accepted before depositing.
- User token, and the tenant signature or a server token ([Calling the Earn Routes](https://docs.aureahub.com/docs/guide-earn.md)).

## Endpoint

### `GET /v1/earn/products`

Authentication: bearer token required.

The Earn products the tenant offers on the network.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | string | no | `true` testnet, `false` (default) mainnet |

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "products": [
    {
      "productId": "lumen",
      "name": "Lumen",
      "status": "active",
      "acceptsDeposits": true,
      "asset": { "symbol": "EUR.e" },
      "disclosureVersion": 1,
      "limits": { "depositMinAmount": "1000000000000000000", "depositMaxAmount": null },
      "venues": [
        {
          "chain": "gnosis",
          "chainId": 100,
          "assetAddress": "0xcB44…C56E",
          "readable": true,
          "state": "active",
          "apy": 2.41,
          "apyBasisPoints": 241,
          "rateSource": "onchain",
          "observedAt": "2026-10-05T10:00:05.000Z",
          "fresh": true,
          "assetDecimals": 18
        }
      ]
    }
  ]
}
```

`200` Nothing Switched On

```json
{
  "isTestnet": false,
  "products": []
}
```

---

Web version: https://docs.aureahub.com/#earn-products