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


---

# 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.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.