> For the complete documentation index, see [llms.txt](https://docs.liminal.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.liminal.money/tokenized/developers/sdk/metrics.md).

# Metrics

Retrieve historical daily TVL, PPS (Price Per Share), and total supply for an xToken.

#### Endpoint

```
GET /sdk/tokenized/:symbol/metrics
```

#### Parameters

**Path Parameters**

| Parameter | Type   | Required | Description                       |
| --------- | ------ | -------- | --------------------------------- |
| `symbol`  | string | Yes      | The xToken symbol (e.g., "xHYPE") |

**Query Parameters**

| Parameter | Type   | Default | Description             |
| --------- | ------ | ------- | ----------------------- |
| `range`   | string | "30d"   | Date range for the data |

**Valid Range Values**

| Value  | Description        |
| ------ | ------------------ |
| `7d`   | Last 7 days        |
| `30d`  | Last 30 days       |
| `90d`  | Last 90 days       |
| `180d` | Last 180 days      |
| `max`  | All available data |

#### Response

```json
[
  {
    "timestamp": 1764028799999,
    "tvl": "1200000.123456789012345678",
    "pps": "1.045012345678901234",
    "totalSupply": "1148325.123456789012345678"
  },
  {
    "timestamp": 1764115199999,
    "tvl": "1250000.987654321098765432",
    "pps": "1.048023456789012345",
    "totalSupply": "1192748.098765432109876543"
  },
  {
    "timestamp": 1764201599999,
    "tvl": "1300000.555555555555555555",
    "pps": "1.051034567890123456",
    "totalSupply": "1237029.444444444444444444"
  }
]
```

#### Response Fields

| Field                                                                                    | Type   | Description                                            |
| ---------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------ |
| `timestamp`                                                                              | number | End of day UTC (23:59:59.999) in milliseconds          |
| `tvl`                                                                                    | string | Total Value Locked (totalAssets from vault contract)   |
| `pps`                                                                                    | string | Price Per Share (shareValue = totalAssets/totalSupply) |
| `totalSupply`                                                                            | string | Total supply of xToken shares                          |
| All numeric values are returned as **strings** to preserve full precision (18 decimals). |        |                                                        |

#### Important Notes

* Timestamps represent the **end of day UTC** (23:59:59.999)
* Values are from the last available record of each day (end of day snapshot)
* Data is collected hourly and aggregated to daily for this endpoint
* If the requested range exceeds available data, all available data is returned
* Empty array is returned if no historical data exists for the xToken

#### Errors

| Code | Description                                   |
| ---- | --------------------------------------------- |
| 400  | Missing `symbol` parameter or invalid `range` |
| 404  | xToken not found or no TVL data available     |
| 500  | Internal server error                         |

#### Example Requests

**Default Request (30 days)**

```bash
curl "https://api.liminal.money/sdk/tokenized/xHYPE/metrics"
```

**Last 7 Days**

```bash
curl "https://api.liminal.money/sdk/tokenized/xHYPE/metrics?range=7d"
```

**Last 90 Days**

```bash
curl "https://api.liminal.money/sdk/tokenized/xHYPE/metrics?range=90d"
```

**All Available Data**

```bash
curl "https://api.liminal.money/sdk/tokenized/xHYPE/metrics?range=max"
```