What depositors kept, against what was advertised
vaults_earnedWhat depositors actually KEPT, against what their vault advertised. READ population BEFORE QUOTING ANY SHARE FROM THIS. The comparison covers only the vaults where we hold BOTH an advertised rate and a realised one, which is a narrow and lopsided set, usually dominated by one venue: population.largestVenue names it and population.concentration says how much of the set it is. A share from here is a statement about those vaults, never about DeFi and never about this whole site. Not the vault’s return, which is what a unit held throughout would have earned: this is read from the depositor register, per vault, and set against the venue’s own quote scaled to how long those depositors have held. How many gave their depositors less, and by how much, is in each answer’s population, counted when it is served; quote it from there, never from this description. ADVERTISED RATES ARE DECIMAL FRACTIONS and some are in the hundreds of per cent: 0.042 is 4.2% and 4.2 is 420%. Those survive a stated band of -1 to 5 (-100% to 500%); advertisedBand.refused says how many readings the band threw out, and advertisedIsHigh marks each row above 100% so a remarkable figure cannot be mistaken for a misplaced decimal. TWO THINGS TO REPEAT WHENEVER QUOTING IT. A depositor who withdrew everything is not in the register and the ones who left after losing are exactly the ones a return figure most needs, so this reads BETTER than the truth rather than worse; and gapPoints is percentage POINTS, not per cent, because a depositor cannot lose more than they put in. The aggregate and the widest gaps are free; the rest of the list needs the earned.detail capability and withheld says how many are missing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | How current this answer is and what it was read from: `freshness` and the ages behind it. Present on every answer from this server, whatever the tool. | |
| items | Yes | name, slug, venue, advertised, advertisedIsHigh, kept, gapPoints, medianDaysHeld. Widest gap first. | |
| limits | Yes | What this cannot tell you, including the survivorship inside the register. Quote it with the numbers. | |
| byVenue | No | FREE whatever tier you hold: coverage per protocol, largest basis first, each with `vaults`, `depositorsMeasured`, `basisUsd` and `comparable`. The population here is concentrated on the venues that publish a per-depositor profit, and reading the headline without this is reading a number about those venues as though it were about the market. | |
| returned | No | Rows in this answer. | |
| warnings | No | Anything the server wants a caller to know about THIS answer before acting on it. Empty is the normal case and is not a guarantee. | |
| withheld | No | Rows the plan does not carry. Zero with earned.detail. | |
| comparable | Yes | Vaults where the two sides can be set against each other at all. This is the population every share here is over. | |
| population | No | Who the comparison is actually about: listed, comparable, byVenue, largestVenue, concentration and isOneVenue. `listed` is how many survived the advertised band and are in `byVenue`; `comparable` is the job own count. They are different counts and must never be divided into one another. Where isOneVenue is true the figure is a reading about that one venue in a market-wide sentence. | |
| losingShare | No | Measured depositors who are down, as a decimal fraction. | |
| alsoMeasured | No | THE OTHER YIELD MEASURE, named so you do not quote one as the other. This tool answers what the depositors STILL IN a vault kept, read from the depositor register, which needs a per-depositor profit and so covers one venue. `performance.realised` on a vault answers what a unit held THROUGHOUT would have earned, read from the share price, and covers far more. A vault can deliver its advertised rate to a unit held all year while the people actually in it are down, because they arrived at different times. | |
| survivorship | No | FREE. Every figure comes from depositors STILL IN the vault: `basis` is `current-holders-only`, `exitedDepositorsIncluded` is false, and `direction` is `reads-better-than-the-truth`, the likely direction and not a guarantee (`directionCertain` is false): some depositors leave after a gain. Somebody who withdrew everything is not in the register, and the ones who left after losing money are exactly the ones a return figure most needs. No size is published for the bias, because an unmeasured correction presented as a figure would be worse than the bias itself. | |
| advertisedBand | No | minDecimal, maxDecimal, refused and means. Advertised rates are decimal fractions, so a value above 1 is above 100%; readings outside the band are refused rather than counted as zero. | |
| shortOfAdvertised | No | Of those, how many gave their depositors less. | |
| shortOfAdvertisedShare | No | The headline share, as a decimal fraction. Never quote it without `population` beside it. |