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

[
  {
    "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)

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

Last 7 Days

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

Last 90 Days

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

All Available Data

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