> For the complete documentation index, see [llms.txt](https://docs.re.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.re.xyz/products/api-reference.md).

# API reference

## Public REST API

Protocol data is available programmatically through a public REST API at `api.re.xyz`.

* No authentication is required.
* All endpoints return JSON.
* All timestamps are UTC.
* All monetary values are USD unless otherwise noted.

## General

### `/health`

Health check. Confirms the API is operational. Returns the same payload as `/apy`.

```http
GET https://api.re.xyz/health
```

### `/apy`

Current APY and NAV for both tokens.

```http
GET https://api.re.xyz/apy
```

<table><thead><tr><th width="134.68359375">Parameter</th><th width="265.73828125">Permitted Values</th><th>Description</th></tr></thead><tbody><tr><td><code>period</code></td><td><code>1d</code>-<code>30d</code> or <code>1M</code>-<code>12M</code> (default: <code>7d</code>)</td><td>The lookback window for APY calculations.</td></tr><tr><td><code>tokens</code></td><td><code>reUSD</code>/<code>reUSDe</code>/<code>reUSD,reUSDe</code> (default: <code>reUSD,reUSDe</code>)</td><td>The tokens to fetch APY data for.</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "data": {
    "reUSD":  { "apy": 6.08, "currentNAV": "1.072248...", "pastNAV": "1.071000...", "period": "7d" },
    "reUSDe": { "apy": 12,   "currentNAV": "1.344798...", "pastNAV": "1.341711...", "period": "7d" }
  },
  "timestamp": "2026-04-16T00:00:00.000Z"
}
```

Use this endpoint for integration pricing, third-party dashboards, or programmatic NAV checks. NAV values are strings to preserve full 18-decimal precision.

### `/price`

Full historical daily price and APY series for both tokens since inception.

```http
GET https://api.re.xyz/price
```

| Parameter | Permitted Values                                          | Description                                |
| --------- | --------------------------------------------------------- | ------------------------------------------ |
| `period`  | `1d`-`30d` or `1M`-`12M` (default: full range)            | Limits how far back the price series goes. |
| `tokens`  | `reUSD`/`reUSDe`/`reUSD,reUSDe` (default: `reUSD,reUSDe`) | The tokens to fetch price data for.        |

**Response**

```json
{
  "data": {
    "reUSD":  [{ "apy": 6.08, "date": "2026-04-16", "price": 1.072248 }],
    "reUSDe": [{ "apy": 12.0, "date": "2026-04-16", "price": 1.344799 }]
  },
  "success": true,
  "timestamp": "2026-04-16T05:07:44.669056Z"
}
```

Each array entry is one day. price is that day's NAV; apy is the trailing 7-day annualized yield as of that date. reUSD data starts `2025-05-26`; reUSDe data starts `2025-04-01`. The earliest entries report `"apy": 0` until a full lookback window of history exists.

This endpoint powers the charts on the Metrics page.

## Supply

Total and circulating on-chain supply. Values are returned as strings to preserve full decimal precision. Circulating supply currently equals total supply for both tokens.

The `{token}` path segment is `reusd` or `reusde` (case-insensitive).

### `/supply`

Full supply data for both tokens in one call.

```
GET https://api.re.xyz/supply
```

**Response**

```
{
  "success": true,
  "results": {
    "reUSD":  { "totalSupply": "144288804.657412684812305265", "circulating": "144288804.657412684812305265" },
    "reUSDe": { "totalSupply": "13140866.420676492698693286",  "circulating": "13140866.420676492698693286" }
  },
  "timestamp": "2026-07-13T14:43:00.526Z"
}
```

### `/supply/{token}`

Full supply data for one token.

```
GET https://api.re.xyz/supply/{token}
```

**Response**

```
{
  "success": true,
  "results": { "totalSupply": "144288804.657412684812305265", "circulating": "144288804.657412684812305265" },
  "timestamp": "2026-07-13T14:43:00.526Z"
}
```

### `/supply/{token}/total_supply`

Total supply of a token across all chains.

```http
GET https://api.re.xyz/supply/{token}/total_supply
```

**Response**

```json
{ "success": true, "result": "144288804.657412684812305265", "timestamp": "2026-07-13T14:39:31.838Z" }
```

Returned as a string to preserve full decimal precision.

### `/supply/{token}/circulating`

Circulating supply of a token.

```http
GET https://api.re.xyz/supply/{token}/circulating
```

**Response**

```
{ "success": true, "result": "144288804.657412684812305265", "timestamp": "2026-07-13T14:39:31.838Z" }
```

## TVL

Protocol TVL metrics. The `{metric}` path segment is one of:

<table><thead><tr><th width="199.890625">Metric</th><th>Description</th></tr></thead><tbody><tr><td><code>reusd</code></td><td>reUSD product TVL.</td></tr><tr><td><code>reusde</code></td><td>reUSDe product TVL.</td></tr><tr><td><code>total</code></td><td>Total protocol TVL.</td></tr><tr><td><code>onchain_capital</code></td><td>On-chain capital.</td></tr><tr><td><code>offchain_capital</code></td><td>Off-chain capital.</td></tr><tr><td><code>premium-receivables</code></td><td>Outstanding insurance premiums owed to Re under active reinsurance contracts.</td></tr></tbody></table>

### `/tvl/{metric}`

Latest value of one metric.

```http
GET https://api.re.xyz/tvl/{metric}
```

**Response**

```json
{
  "amount": 215141174.5,
  "lastUpdated": "2026-01-06T19:35:06.789440",
  "currency": "USD"
}
```

lastUpdated is the date of the most recent datapoint for that metric. Quarterly-updated metrics lag daily ones.

### `/tvl`

Latest value of every metric in one call.

```
GET https://api.re.xyz/tvl
```

**Response**

```
{
  "success": true,
  "results": {
    "reusd":   { "amount": 158281251.35, "lastUpdated": "2026-07-12T00:00:00.000Z", "currency": "USD" },
    "reusde":  { "amount": 20054341.49,  "lastUpdated": "2026-07-12T00:00:00.000Z", "currency": "USD" },
    "total":   { "amount": 565780200.76, "lastUpdated": "2026-07-12T00:00:00.000Z", "currency": "USD" },
    "onchain_capital":      { "amount": 67875713.98,  "lastUpdated": "2026-07-12T00:00:00.000Z", "currency": "USD" },
    "offchain_capital":     { "amount": 178978000.00, "lastUpdated": "2026-07-12T00:00:00.000Z", "currency": "USD" },
    "premium-receivables":  { "amount": 318925958.48, "lastUpdated": "2026-07-13T00:00:00.000Z", "currency": "USD" }
  },
  "timestamp": "2026-07-13T14:43:00.526Z"
}
```

### `/tvl/{metric}/history`

Daily history of one metric.

```
GET https://api.re.xyz/tvl/{metric}/history
```

<table><thead><tr><th width="134.68359375">Parameter</th><th width="265.73828125">Permitted Values</th><th>Description</th></tr></thead><tbody><tr><td><code>period</code></td><td><code>1d</code>-<code>30d</code> or <code>1M</code>-<code>12M</code> (default: full history)</td><td>Limits how far the series goes.</td></tr></tbody></table>

**Response**

```
{
  "data": [
    { "date": "2026-07-12", "amount": 158363778.29 },
    { "date": "2026-07-13", "amount": 158438860.18 }
  ],
  "currency": "USD"
}
```

### `/tvl/history`

Hisorical values of every metric in one call.

```
GET https://api.re.xyz/tvl/history
```

**Response**

```
{
  "success": true,
  "results": {
    "reusd":  { "data": [{ "date": "2026-07-13", "amount": 158438860.18 }], "currency": "USD" },
    "reusde": { "data": [{ "date": "2026-07-13", "amount": 20045619.92 }],  "currency": "USD" }
  }
}
```

## Points

Information about the points program.

### `/points/public/leaderboard`

Public Re Points leaderboard. Wallet addresses are truncated for privacy.

```http
GET https://api.re.xyz/points/public/leaderboard
```

<table><thead><tr><th width="134.68359375">Parameter</th><th width="265.73828125">Permitted Values</th><th>Description</th></tr></thead><tbody><tr><td><code>limit</code></td><td><code>1</code>-<code>100</code> (default: <code>100</code>)</td><td>The amount of pages to return.</td></tr><tr><td><code>offset</code></td><td>Any integer (default: <code>0)</code></td><td>Pagination offset.</td></tr><tr><td><code>season</code></td><td>Any valid season integer (default: the current season)</td><td>The season of points too fetch the leaderboard for.</td></tr></tbody></table>

**Response**

```json
{
  "status": "success",
  "data": {
    "leaderboard": [
      { "rank": 1, "wallet": "0x614d...2ade", "points": 55538590206.25 }
    ],
    "pagination": { "has_next": true },
    "total_points_awarded": 173349340803.80,
    "timestamp": "2026-07-13T14:41:30.276Z",
    "last_snapshot": "2026-07-12"
  }
}
```

Responses may be cached for up to one hour.

### `/points/public/opportunities`

Live Re Points earning opportunities: every strategy that earned points on the latest calculated day, with its boost multiplier, daily points, TVL and holder count. Strategies whose points program has ended are listed under ended.

**Response**

```
{
  "status": "success",
  "data": {
    "date": "2026-07-12",
    "opportunities": [
      {
        "token": "Pendle_YT_reUSD_Dec2026",
        "name": "Pendle YT reUSD Dec2026",
        "protocol": "Pendle",
        "chain": "ethereum",
        "multiplier": 30,
        "daily_points": 2307856254.55,
        "tvl": 76928541.82,
        "holders": 140,
        "start_date": "2026-06-09",
        "end_date": null
      }
    ],
    "ended": [],
    "totals": { "daily_points": 12345678901.23, "participants": 4321 }
  }
}
```

## Wallet

Per-wallet position and points lookups, built for integrations.

### `/wallet/balance`

A wallet's direct reUSD and reUSDe holdings across all supported chains, valued in USD at the current NAV.

```
GET https://api.re.xyz/wallet/balance?address=0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef
```

<table><thead><tr><th width="134.68359375">Parameter</th><th width="265.73828125">Permitted Values</th><th>Description</th></tr></thead><tbody><tr><td><code>address</code></td><td>All Ethereum 32-byte addresses (required)</td><td>The wallet to fetch balances for.</td></tr><tr><td><code>token</code></td><td><code>reUSD</code>/<code>reUSDe</code> (default: both)</td><td>The token to fetch data for. Omit for both.</td></tr></tbody></table>

**Response**

```
{
  "success": true,
  "address": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
  "results": {
    "reUSD": {
      "balance": "12500.000000000000000000",
      "nav": 1.088913,
      "amount": 13611.41,
      "chains": {
        "ethereum": { "balance": "10000.000000000000000000", "amount": 10889.13 },
        "bsc":      { "balance": "2000.000000000000000000",  "amount": 2177.83 },
        "base":     { "balance": "500.000000000000000000",   "amount": 544.46 }
      }
    },
    "reUSDe": {
      "balance": "1000.000000000000000000",
      "nav": 1.387237,
      "amount": 1387.24,
      "chains": {
        "ethereum": { "balance": "1000.000000000000000000", "amount": 1387.24 }
      }
    }
  },
  "total": 14998.65,
  "currency": "USD",
  "timestamp": "2026-07-14T00:00:00.000Z"
}
```

### `/wallet/points`

A wallet's accumulated Re Points and leaderboard position.s

```
GET https://api.re.xyz/wallet/points?address=0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef
```

<table><thead><tr><th width="134.68359375">Parameter</th><th width="265.73828125">Permitted Values</th><th>Description</th></tr></thead><tbody><tr><td><code>address</code></td><td>All Ethereum 32-byte addresses (required)</td><td>The wallet to fetch points balance for.</td></tr></tbody></table>

**Response**

```
{
  "success": true,
  "address": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
  "season": 2,
  "points": 1234567.89,
  "rank": 42,
  "share": 0.0007,
  "last_update": "2026-07-13",
  "timestamp": "2026-07-14T00:00:00.000Z"
}
```

***

<sub>*For educational and informational purposes only. Nothing on this Site is investment, financial, legal, or tax advice, or an offer, solicitation, or recommendation to buy, sell, or hold any digital asset, including reUSD and reUSDe. Yields are not guaranteed and all figures are illustrative, not a promise of return; past performance is not a reliable indicator of future results. Digital assets involve significant risk, including total loss of principal — the Tokens are not bank deposits and are not insured by any government agency. The Tokens are available only to eligible non-U.S. persons in permitted jurisdictions and are subject to KYC/AML requirements. The binding terms of the applicable agreements govern and prevail over this summary. See our full*</sub> [<sub>*Disclosures*</sub>](https://re.xyz/disclosure) <sub>*for important additional information.*</sub>