# 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"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.liminal.money/tokenized/developers/sdk/metrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.