Rheofi REST API

The Rheofi REST API provides programmatic access to protocol data including markets, accounts, governance, and more. It is designed for developers building applications, dashboards, and integrations on top of the Rheofi Protocol.

Base URL

https://api.rheofi.com/v1

Authentication

All API requests require an API key passed via the X-API-Key header. You can generate an API key from the Rheofi Developer Portal.

curl -H "X-API-Key: your_api_key_here" https://api.rheofi.com/v1/markets

Rate Limiting

API requests are rate-limited to ensure fair usage across all consumers:

• Free tier: 100 requests per minute
• Pro tier: 1,000 requests per minute
• Enterprise tier: Custom limits

Rate limit headers are included in every response:

Header	Description
X-RateLimit-Limit	Maximum requests allowed per window
X-RateLimit-Remaining	Remaining requests in current window
X-RateLimit-Reset	Unix timestamp when the window resets

Endpoints

Method	Endpoint	Description
GET	/markets	List all markets with current supply/borrow rates
GET	/markets/{address}	Get detailed information for a specific market
GET	/accounts/{address}	Get account positions, balances, and health factor
GET	/governance/proposals	List all governance proposals with status
GET	/governance/proposals/{id}	Get details of a specific proposal

Example Request

List All Markets

curl -X GET https://api.rheofi.com/v1/markets \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json"

Example Response

{
  "data": [
    {
      "address": "0x1a2B3c4D5e6F7890AbCdEf1234567890aBcDeF01",
      "symbol": "rETH",
      "underlyingSymbol": "ETH",
      "chain": "ethereum",
      "supplyApy": "3.25",
      "borrowApy": "5.12",
      "totalSupply": "150000000.00",
      "totalBorrow": "89000000.00",
      "liquidity": "61000000.00",
      "collateralFactor": "0.80"
    },
    {
      "address": "0x3c4D5e6F7890AbCdEf1234567890aBcDeF012345",
      "symbol": "rUSDC",
      "underlyingSymbol": "USDC",
      "chain": "ethereum",
      "supplyApy": "4.50",
      "borrowApy": "6.80",
      "totalSupply": "320000000.00",
      "totalBorrow": "210000000.00",
      "liquidity": "110000000.00",
      "collateralFactor": "0.85"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42
  }
}

Error Handling

All errors follow a consistent format:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded the rate limit. Please try again later.",
    "status": 429
  }
}

For additional support, visit the Rheofi Developer Forum or open an issue on GitHub.