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.

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

/apy

Current APY and NAV for both tokens.

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

Parameter	Permitted Values	Description
period	1d-30d or 1M-12M (default: 7d)	The lookback window for APY calculations.
tokens	reUSD/reUSDe/reUSD,reUSDe (default: reUSD,reUSDe)	The tokens to fetch APY data for.

Response

{
  "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.

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

{
  "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.

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

Response

{ "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.

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:

Metric	Description
reusd	reUSD product TVL.
reusde	reUSDe product TVL.
total	Total protocol TVL.
onchain_capital	On-chain capital.
offchain_capital	Off-chain capital.
premium-receivables	Outstanding insurance premiums owed to Re under active reinsurance contracts.

/tvl/{metric}

Latest value of one metric.

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

Response

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

Parameter	Permitted Values	Description
period	1d-30d or 1M-12M (default: full history)	Limits how far the series goes.

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.

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

Parameter	Permitted Values	Description
limit	1-100 (default: 100)	The amount of pages to return.
offset	Any integer (default: 0)	Pagination offset.
season	Any valid season integer (default: the current season)	The season of points too fetch the leaderboard for.

Response

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

Parameter	Permitted Values	Description
address	All Ethereum 32-byte addresses (required)	The wallet to fetch balances for.
token	reUSD/reUSDe (default: both)	The token to fetch data for. Omit for both.

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

Parameter	Permitted Values	Description
address	All Ethereum 32-byte addresses (required)	The wallet to fetch points balance for.

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"
}

---

_{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 Disclosures for important additional information.}