DAMMeth: API access
Fetch live and historical data for the DAMM Ethereum Fund from the Lagoon API. See Integrations for the endpoint, conventions, and response shapes shared by all funds.
Anyone can read this data. Only approved addresses can deposit into or redeem from the vault. Email [email protected] before you deposit, then follow the DAMMeth deposit guide.
1. Core state, fees & APRs
curl -s -X POST https://api.lagoon.finance/query \
-H "Content-Type: application/json" \
-d '{"query":"{ vaultByAddress(address:\"0x3c63f3ce75dc83735745cf4e86b63414d95ee355\", chainId:1) { name symbol asset { symbol priceUsd } curators { name } state { totalAssets totalAssetsUsd totalSupply pricePerShare pricePerShareUsd managementFee performanceFee protocolFee entryRate exitRate isPaused syncMode accessMode weeklyApr { twrrNetApr linearNetApr } monthlyApr { twrrNetApr } yearlyApr { twrrNetApr } } } }"}'
- Monetary fields are dual: raw on-chain
BigInt(totalAssets,pricePerShare, where WETH has 18 decimals) plus a convenience…Usd: Float. DAMMeth is an ETH-denominated fund: track performance in the native series (pricePerShare), not the USD variants. - Fees are basis points (1e4 = 100%). Current configuration:
managementFee: 0,performanceFee: 1500= 15%,protocolFee: 750= 7.5% (of collected fees), no entry/exit fees. weeklyApr.twrrNetApr= time-weighted net APR;linearNetApr= simple. Both are already in percent (e.g.4.99= 4.99%). AnullAPR means insufficient recent settlement data for that window.
2. Historical time series
stateHistory returns an ascending series of {x: unixSeconds, y: value}
points (max 1000 per field). Pass an optional
options: {startTimestamp, endTimestamp} window.
curl -s -X POST https://api.lagoon.finance/query \
-H "Content-Type: application/json" \
-d '{"query":"{ vaultByAddress(address:\"0x3c63f3ce75dc83735745cf4e86b63414d95ee355\", chainId:1) { stateHistory { pricePerShare(options:{}) { x y } totalAssetsUsd(options:{}) { x y } } } }"}'
Other series under stateHistory: totalAssets, totalSupply,
pricePerShareUsd, managementFee, performanceFee, protocolFee,
highWaterMark. One point lands per settlement. Cadence is irregular (gaps from under a day
to several weeks), so check the last point's x for the NAV's age.
3. Transaction / event history
Every indexed event: deposits, redeem requests, settlements, fees taken and
rate updates. Filter with suffix operators (_eq, _in, _gte, …);
paginate with first + skip.
curl -s -X POST https://api.lagoon.finance/query \
-H "Content-Type: application/json" \
-d '{"query":"{ transactions(first:10, skip:0, orderBy:timestamp, orderDirection:desc, where:{ vault_in:[\"0x3c63f3ce75dc83735745cf4e86b63414d95ee355\"], chainId_eq:1 }) { pageInfo { totalCount } items { type timestamp hash blockNumber } } }"}'
- Useful
wherefilters:type_in: [Deposit, SettleDeposit, FeeTaken, RedeemRequest],timestamp_gte,owner_in,controller_in. - A depositor's money leaves their wallet at
DepositRequest; theDepositevent fires later, at claim time. Date flows fromDepositRequest. - A redeem's share burn appears as a
Transferto the vault's pending silo (0xc23eb126da1db3b45ee4a24d90b5152780de595e), not to a third-party counterparty.
Notes
- DAMMeth holds its positions in one Safe (including its DAMMethAlgo shares), so
Lagoon's
compositionfeed reconciles closely (~97% at time of writing) withstate.totalAssetsUsd(unlike DAMMstable and DAMMethAlgo, where composition is partial).