# SDK

The Tokenized SDK API provides programmatic access to xToken data, user holdings, and performance metrics.

### Base URL

```
https://api.liminal.money
```

All endpoints are prefixed with `/sdk/tokenized/:symbol` where `:symbol` is the xToken symbol (e.g., "xHYPE").

### Authentication

Currently, the SDK API is public and does not require authentication.

### Rate Limiting

* Results are cached server-side (TTL varies by endpoint)
* Rate limits are enforced but are generous for normal usage

### Available Endpoints

#### Users

Retrieve xToken holder data with detailed balance breakdowns and weighted LST holdings.

| Endpoint                                  | Description                          |
| ----------------------------------------- | ------------------------------------ |
| `GET /sdk/tokenized/:symbol/users`        | Get all users with detailed balances |
| `GET /sdk/tokenized/:symbol/lst-holdings` | Get users with weighted LST holdings |

***

#### APY

Retrieve historical APY data for xTokens.

| Endpoint                         | Description                   |
| -------------------------------- | ----------------------------- |
| `GET /sdk/tokenized/:symbol/apy` | Get daily trailing 7d/30d APY |

***

### Balance Sources

The SDK aggregates xToken holdings from multiple DeFi protocols:

| Source          | Description                                        |
| --------------- | -------------------------------------------------- |
| Vault Balances  | Direct xToken holdings in vault contracts          |
| Pendle PT/YT/LP | Pendle protocol positions (converted to xToken)    |
| DEX LP          | Concentrated liquidity positions (Prjx, HyperSwap) |
| Money Markets   | Collateral in lending markets (HyperLend)          |

### Supported xTokens

| Symbol  | Description                  |
| ------- | ---------------------------- |
| `xHYPE` | Tokenized HYPE delta-neutral |