API

Read access to the live RAVA opportunity feed and lend pool state. Public endpoints, no auth, JSON responses. Rate limited to 60 requests per minute per IP.

Base URL: https://api.rava.money/v1

Liquidations

`GET /liquidations`

Returns every RWA position eligible for liquidation across Aave, Morpho, and Euler.

Query params

Param	Type	Notes
`venue`	`aave \| morpho \| euler`	Filter by venue.
`asset`	string	Asset symbol (`ACRED`, `MGLOBAL`, `PEAK`).
`status`	`liquidatable \| imminent \| watch`	Filter by status.
`min_roi_bps`	integer	Minimum expected ROI in basis points.

Response

json

{
  "data": [
    {
      "id": "morpho-acred-c12d",
      "asset": "ACRED",
      "venue": "Morpho",
      "market": "ACRED/USDC",
      "borrower": "0xc12d8b6f3e9a4c2d7b5e1a8f3c6d9b2e4a7f1c5d",
      "collateral_usd": "1502400.00",
      "debt_usd": "1368000.00",
      "health_factor": "0.97",
      "liquidation_threshold": "0.88",
      "mark_price": "0.9756",
      "liquidation_bonus_bps": 600,
      "offered_ltv_bps": 7600,
      "next_redemption_at": 1714607200,
      "status": "liquidatable"
    }
  ],
  "synced_at": 1714578432
}

`GET /liquidations/:id`

Single opportunity with extended fields (24h price history, recent borrower activity, calldata template).

Acquisitions

`POST /acquisitions/quote`

Quote an acquisition without committing. Returns expected collateral, profit math, and the offered LTV if leverage is requested.

Body

json

{
  "opportunity_id": "morpho-acred-c12d",
  "repay_usd": "1368000",
  "use_leverage": true
}

Response

json

{
  "collateral_received_usd": "1450080.00",
  "expected_profit_usd": "108420.00",
  "offered_ltv_bps": 7600,
  "loan_usd": "1039680.00",
  "loan_apr_bps": 820,
  "gas_estimate_usd": "22.40",
  "calldata": "0xa6afed95..."
}

`POST /acquisitions`

Returns signed calldata for the liquidation transaction. Submit yourself, or use the bundled execution endpoint.

Lend Pools

`GET /lend/pools`

json

{
  "data": [
    {
      "address": "0x...",
      "name": "Main Lend Pool",
      "symbol": "rvMAIN",
      "type": "main",
      "total_capital_usd": "12400000.00",
      "available_usd": "3100000.00",
      "utilization_bps": 7500,
      "lender_apy_bps": 1240,
      "loan_interest_apy_bps": 820,
      "upside_share_apy_bps": 420
    }
  ]
}

`GET /lend/pools/:address/positions/:user`

Returns the user's position in a specific pool: deposited amount, accrued earnings, share balance.

WebSocket

wss://api.rava.money/v1/stream

Subscribe to live updates by topic.

json

{ "subscribe": ["liquidations", "lend.utilization"] }

Events fire on every state change. Used by the dashboard for the live count badge.

← PREVIOUS

Lend Pool

FAQ