DAMMbtc: API access
Fetch live and historical data for the DAMM Bitcoin 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 DAMMbtc deposit guide.
The DAMMbtc vault was deployed on Ethereum mainnet on 2026-07-30, and
its first NAV settlement was on 2026-08-04. History is still short (a handful of settlements), so stateHistory has only a few points. The APR windows (weeklyApr, monthlyApr, yearlyApr) do return values, but they are annualized from very little data. Until the vault is a year old, yearlyApr equals inceptionApr, so do not read it as an annual track record (the website shows "insufficient history" for this reason). Handle null defensively anyway.
1. Core state, fees & APRs
curl -s -X POST https://api.lagoon.finance/query \
-H "Content-Type: application/json" \
-d '{"query":"{ vaultByAddress(address:\"0x7ededf832b5c9d8afa8f7365936100581a6db756\", 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 WBTC has 8 decimals) plus a convenience…Usd: Float. DAMMbtc is a BTC-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:\"0x7ededf832b5c9d8afa8f7365936100581a6db756\", 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:[\"0x7ededf832b5c9d8afa8f7365936100581a6db756\"], 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 (0xb72951329b41fa52d83e941cb5cb8555d90f1704), not to a third-party counterparty.
Notes
- DAMMbtc initially allocates to the DAMM BTC Algo Fund; fees are charged once, at the DAMMbtc level.