# Earn Positions

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

What the user holds in the Earn products, read from the chain.

## Overview

- For every product your tenant offers, or has offered, on the network, and every EVM wallet of the user somebody can sign for: `balance`, what the position is worth now, principal and yield together, in the asset's smallest unit. A product with share tokens adds `shares`.
- Positions of zero are left out. `incomplete: true` when a chain could not be read: the list may miss a position.

## Endpoint

### `GET /v1/earn/positions`

Authentication: bearer token required.

The user's positions in the Earn products.

**Query parameters**

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

**Responses**

`200` OK

```json
{
  "isTestnet": false,
  "positions": [
    {
      "productId": "lumen",
      "name": "Lumen",
      "chain": "gnosis",
      "chainId": 100,
      "assetAddress": "0xcB44…C56E",
      "assetSymbol": "EUR.e",
      "assetDecimals": 18,
      "walletId": "7c1e…",
      "walletAddress": "0x2f4B…",
      "balance": "50012000000000000000"
    }
  ],
  "incomplete": false
}
```

---

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