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.
Reading this data is open to everyone. Depositing into or redeeming from the vault requires your address to be whitelisted — request access via [email protected] or our Telegram group.
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— 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. 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 (roughly weekly).
3. Transaction / event history
Every indexed event — deposits, redeem requests, settlements, fees taken,
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 manages capital from a single Safe, so Lagoon's
compositionfeed reconciles cleanly withstate.totalAssetsUsd(unlike DAMMstable, where composition is partial).