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.
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.
DAMMbtc went live on Ethereum mainnet on 2026-07-30. Until settlements
accumulate, stateHistory is sparse and the APR windows (weeklyApr,
monthlyApr, yearlyApr) return null.
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— 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: 1000= 10% (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:\"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 (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:[\"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.