Endpoints
| Method | Path | Auth | Returns |
|---|---|---|---|
GET | /v1/vaults | None | All vaults with TVL, APY, share price |
GET | /v1/vaults/:id/nav | None | NAV series since inception |
GET | /v1/portfolio/:address | None | Positions for one address |
POST | /v1/deposits | API key | Builds an unsigned deposit transaction |
WS | /v1/stream | None | Live NAV and price channels |
Quick example
curl https://api.loaf.com/v1/vaults \
-H "Accept: application/json"
{
"vaults": [
{ "id": "core-yield", "chain": "base", "asset": "USDC",
"tvl": 318000, "apy30d": 0.094, "sharePrice": "1.0472" }
]
}Rate limits & conventions
60 req / minPublic read endpoints, per IP
600 req / minAuthenticated, per API key
ISO 8601 + UTCEvery timestamp, no exceptions
Amounts are returned as strings in base units to avoid float rounding. Errors use
standard HTTP status codes with a machine-readable
code field.