DAMMbtcAlgo — API access
Fetch live and historical data for the DAMM BTC Algo Fund — an algorithmic, rule-based liquidity-provision fund — from the Lagoon API. See Integrations for the endpoint, conventions, and response shapes shared by all funds.
DAMMbtcAlgo is whitelist-gated and currently admits only the DAMMbtc fund as a depositor — that's why its management and performance fees are 0%: fees are charged once, at the DAMMbtc level. To get exposure, invest through DAMMbtc (whitelisting required — contact [email protected] or our Telegram group). Its data remains fully readable via the API.
1. Core state, fees & APRs
curl -s -X POST https://api.lagoon.finance/query \
-H "Content-Type: application/json" \
-d '{"query":"{ vaultByAddress(address:\"0x9c414834a4a85aa15ec461edcd8cc9dd8ec979b9\", 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. Track performance in the native series (pricePerShare), not the USD variants. - Fees are basis points (1e4 = 100%). Current configuration:
managementFee: 0,performanceFee: 0(fees are charged at the DAMMbtc level),protocolFee: 1000= 10% (of collected 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:\"0x9c414834a4a85aa15ec461edcd8cc9dd8ec979b9\", 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:[\"0x9c414834a4a85aa15ec461edcd8cc9dd8ec979b9\"], 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 (0x9b326b6d89b93aad46b5e998c300b458924469f9), not to a third-party counterparty.