Loov Documentation
Loov is a permissionless lending protocol on Robinhood Chain (chain id 4663). Post tokenized stocks or crypto as collateral, borrow USDG in seconds, earn as a lender, or run a keeper — with every rule enforced by public contracts.
Why Loov exists
Selling an asset to raise cash closes the position, eats slippage, and gives up the upside. Broker margin keeps the upside but custodies your assets and gates access behind reviews. Loov is the third option: overcollateralized, non-custodial loans where collateral sits in a contract you can read, rates come from open supply and demand, and repayments build credit that lives in your wallet.
Because Robinhood Chain hosts tokenized equities next to crypto, the same rails price a loan against AAPLx exactly the way they price one against ETH. Your stock portfolio becomes productive collateral.
| Loov loan | Selling | Margin loan | |
|---|---|---|---|
| Keep your upside | Yes — bag stays yours | No, position closed | Yes, but custodied |
| Time to dollars | ~12 seconds | Instant, minus slippage | Hours to days |
| Approval | One signature | None | KYC + review |
| Custody | On-chain contract | — | Broker account |
| Builds credit | Loov Score, portable | No | Internal only |
How a loan works
Every loan is one position with four parameters: collateral, debt, LTV, and an optional exit. Opening one is a single signature; the whole flow settles in about twelve seconds.
Worked example
| Collateral | 120 HOOD @ $40.10 | $4,812 value |
| Chosen LTV | 50% | borrow up to your tier's cap |
| Borrowed | 2,400 USDG | lands in ~12s |
| Rate at open | 1.4% / month | set by pool utilization |
| Health factor | 1.82 | collateral × liq threshold ÷ debt |
| Liquidation price | HOOD ≈ $22.00 | shown before you sign |
The health factor moves with the oracle price. Repay, top up collateral, or resize the loan at any time — positions bend before they break. There are no origination, deposit, or withdrawal fees: the quoted rate is the entire cost.
Interest rates
No one at Loov sets rates. Each pool follows a kinked utilization curve: cheap while liquidity sits idle, sharply more expensive as the pool nears full utilization — which attracts new lenders and nudges borrowers to repay.
On top of the pool rate, your Loov Score applies a personal discount:
| Score tier | Range | Rate adjustment | Max LTV |
|---|---|---|---|
| Newcomer | 300–579 | baseline | 50% |
| Builder | 580–669 | −15 bps | 60% |
| Trusted | 670–739 | −35 bps | 70% |
| Prime | 740–850 | best available | 80%+ |
Interest accrues per block and is collected on repayment. Here is where every dollar of it goes:
Liquidations & keepers
A position becomes liquidatable when its health factor crosses 1.00. Liquidation is a permissionless, competitive job — anyone can run a keeper; there is no admin function.
- Partial by design. One liquidation touches at most 25% of a position (the close factor). Most underwater positions are healthy again after a single clip.
- Known cost. The penalty is a flat 5% of the amount closed, split between the keeper bounty and the insurance pool. No cascading auctions.
- Visible line. Your liquidation price is shown at open and updates live in the app.
Lending pools
Lenders supply USDG into one of three tranches. Seniority decides who absorbs losses first — and who gets paid most for the risk. Repayments flow down a waterfall: senior first, junior last.
Programmable exits
Loans can close themselves. Two exit primitives ship at launch:
- Auto-repay on price. Attach a target when you open the loan. If collateral hits it, the contract sells exactly enough to clear the debt and returns the rest — take-profit and deleverage in one atomic step.
- Repay from yield. Route staking rewards or LP fees directly into the debt, so the position drifts away from liquidation every block instead of toward it.
Collateral markets
12 markets at launch. A market needs a reliable Chainlink feed on Robinhood Chain and a volatility review that sets its max LTV and close factor. Listing is permissionless-by-governance: anyone can propose; parameters are set by vote.
| Asset | Type | Max LTV |
|---|---|---|
| SPYx | Tokenized index | 85% |
| MSFTx | Tokenized stock | 80% |
| AAPLx | Tokenized stock | 80% |
| ETH | Crypto | 80% |
| WBTC | Crypto | 80% |
| NVDAx | Tokenized stock | 75% |
| HOOD | Tokenized stock | 70% |
| TSLAx | Tokenized stock | 65% |
The Loov Score
A 300–850 credit score computed entirely from on-chain repayment history — no identity, no off-chain data, no way for anyone (including us) to edit it. It lives in a registry contract keyed to your wallet, so any protocol can read it and underwrite you with it.
- On-time repayments (45%) — the dominant input.
- Repaid volume (20%) — larger, repaid loans build more history.
- Streak length (20%) — consecutive clean loans compound.
- Account age (15%) — time in the system.
Scores decay slowly with inactivity and drop sharply on liquidation. There is deliberately no penalty for early repayment.
Architecture
Every contract is public and immutable once deployed. There is no admin key that can touch user funds — the only privileged actions are governance-timelocked risk-parameter updates.
SDK quickstart
Everything the app can do, the SDK can do — the chain is the interface. Scores and market data are readable without any API key.
import { Loov } from '@loov-fi/sdk'
const loov = await Loov.connect(signer) // Robinhood Chain, 4663
// Open a loan with a programmed exit
const loan = await loov.borrow({
collateral: 'HOOD',
amount: 2_500, // USDG
ltv: 0.5,
exit: { price: 44.20 }, // auto-repay at target
})
// Read anyone's credit score
const score = await loov.score('0x4f2…9e1')
// Supply the Balanced tranche
await loov.lend({ tranche: 'balanced', amount: 10_000 })Audits & risk
Every line of the contracts is public. Two independent audits are planned before mainnet deployment, plus an open bug bounty scaled to TVL. Reports will be linked here as they complete.
- Smart-contract risk — audited, immutable code, but no audit removes risk entirely.
- Oracle risk — Chainlink feeds with staleness checks; markets pause on stale prices rather than trade through them.
- Market risk — overcollateralization, partial liquidations, and the insurance pool absorb drawdowns in that order.