DeFi Flows and Events
Bridge Flows
Tool: defillama:get_bridge_flows
- Two-way bridge deduplication is applied automatically when aggregating
- Grain: bridge x chain (one row per bridge per chain)
inflows = deposit_amount - withdraw_amount (pre-computed, positive = net inflow)- Params:
bridge, chain, period, start_date, end_date, sort_by, limit
ETF Flows
Tool: defillama:get_etf_flows
flow_usd is signed: positive = inflow, negative = outflow- Filter by underlying:
token: "bitcoin" for all BTC ETFs, token: "ethereum" for ETH ETFs
- Use
etf param to filter specific ETF (e.g., "ibit", "fbtc")
- Current view shows latest day only. Use
period: "30d" for historical.
Stablecoin Supply
Tool: defillama:get_stablecoin_supply
- Supply = issuance on each chain, NOT DeFi deposits
- Grain: stablecoin x chain (one row per stablecoin per chain)
- Use
circulating_supply (not total_supply) for supply queries
- Filter by
peg_type (usd, eur)
- Params:
stablecoin, chain, peg_type, period, sort_by, limit
Institutional Holdings (DAT)
Tool: defillama:get_dat_holdings
- Tokens are automatically prefixed with
coingecko: if not already (e.g., token: "bitcoin" works)
- Base response: institution overview (total value, cost, mNAV ratios)
include_history: true adds historical holding snapshotsinclude_mnav: true adds mNAV time seriestransaction_type filters history by transaction type (e.g., "purchase", "sale")
mNAV (multiple of Net Asset Value) -- measures crypto exposure relative to market cap:
realized_mnav: conservative estimaterealistic_mnav: expected dilutionmax_mnav: maximum dilution- mNAV > 1 means crypto holdings exceed the company's market cap attribution
Hacks and Exploits
Tool: defillama:get_events with event_type: "hacks"
- Filter by
protocol (victim slug), chain (uses = ANY(chains) for array column), min_amount
returned_funds shows how much was recovered after the hack- Use
sort_by: "amount desc" for biggest hacks
Fundraising Rounds
Tool: defillama:get_events with event_type: "raises"
- Filter by
protocol, chain (uses = ANY(chains) for array column), min_amount
- Use
sort_by: "amount desc" for largest rounds
Protocol Events
Tool: defillama:get_events with event_type: "protocol_events"
- Governance votes, upgrades, launches, and other protocol milestones
- Additional filters:
target_type (filter by target type), sub_protocol (filter by sub-protocol slug)
CEX Volumes
Tool: defillama:get_cex_volumes
- CEX slugs differ from common names: binance ->
binance-cex, huobi -> htx, gate.io -> gate-io
- Params:
cex, period, sort_by, limit
Open Interest
Tool: defillama:get_open_interest
- Aggregates with SUM/GROUP BY for proper protocol-level totals
- Params:
protocol, chain, period, start_date, end_date, sort_by, limit
Treasury
Tool: defillama:get_treasury
- Aggregates with SUM/GROUP BY for proper protocol-level totals
treasury_excl_own_token is the realistic value (excludes inflation of protocol's own token)treasury_total includes own token (inflated value)- Params:
treasury, chain (for per-chain breakdown), period, start_date, end_date, sort_by, limit
Examples
Example 1:
User: "Bitcoin ETF flows this month"
Tool call: defillama:get_etf_flows(token: "bitcoin", period: "30d")
Example 2:
User: "MicroStrategy bitcoin holdings"
Tool call: defillama:get_dat_holdings(institution: "microstrategy", token: "coingecko:bitcoin", include_history: true)
Example 3:
User: "Biggest DeFi hacks in 2024"
Tool call: defillama:get_events(event_type: "hacks", sort_by: "amount desc", limit: 10, start_date: "2024-01-01", end_date: "2024-12-31")
Example 4:
User: "USDT supply across chains"
Tool call: defillama:get_stablecoin_supply(stablecoin: "coingecko:tether", sort_by: "circulating_supply desc")
Example 5:
User: "Top bridge volume this week"
Tool call: defillama:get_bridge_flows(period: "7d", sort_by: "volume desc", limit: 10)
Example 6:
User: "Largest crypto fundraises this year"
Tool call: defillama:get_events(event_type: "raises", period: "365d", sort_by: "amount desc", limit: 20)
Example 7:
User: "Binance trading volume"
Tool call: defillama:get_cex_volumes(cex: "binance-cex")
Example 8:
User: "Uniswap treasury breakdown"
Tool call: defillama:get_treasury(treasury: "uniswap")
Example 9:
User: "ETF flows in February 2025"
Tool call: defillama:get_etf_flows(token: "bitcoin", start_date: "2025-02-01", end_date: "2025-02-28")
1---2name: flows-and-events3description: Guide for querying DeFi flow data and events using DefiLlama MCP tools. Covers bridge flows, ETF inflows/outflows, stablecoin supply, institutional/DAT holdings with mNAV ratios, hacks and exploits, fundraising rounds, CEX volumes, open interest, and protocol treasuries. Use when users ask about bridge volume, ETF flows, stablecoin supply, MicroStrategy holdings, DeFi hacks, funding rounds, exchange volume, or treasury data.4---5
6# DeFi Flows and Events
7
8## Bridge Flows
9
10Tool: `defillama:get_bridge_flows`
11
12- Two-way bridge deduplication is applied automatically when aggregating
13- Grain: bridge x chain (one row per bridge per chain)
14- `inflows = deposit_amount - withdraw_amount` (pre-computed, positive = net inflow)
15- Params: `bridge`, `chain`, `period`, `start_date`, `end_date`, `sort_by`, `limit`
16
17## ETF Flows
18
19Tool: `defillama:get_etf_flows`
20
21- `flow_usd` is **signed**: positive = inflow, negative = outflow
22- Filter by underlying: `token: "bitcoin"` for all BTC ETFs, `token: "ethereum"` for ETH ETFs
23- Use `etf` param to filter specific ETF (e.g., `"ibit"`, `"fbtc"`)
24- Current view shows latest day only. Use `period: "30d"` for historical.
25
26## Stablecoin Supply
27
28Tool: `defillama:get_stablecoin_supply`
29
30- Supply = **issuance** on each chain, NOT DeFi deposits
31- Grain: stablecoin x chain (one row per stablecoin per chain)
32- Use `circulating_supply` (not `total_supply`) for supply queries
33- Filter by `peg_type` (usd, eur)
34- Params: `stablecoin`, `chain`, `peg_type`, `period`, `sort_by`, `limit`
35
36## Institutional Holdings (DAT)
37
38Tool: `defillama:get_dat_holdings`
39
40- Tokens are automatically prefixed with `coingecko:` if not already (e.g., `token: "bitcoin"` works)
41- Base response: institution overview (total value, cost, mNAV ratios)
42- `include_history: true` adds historical holding snapshots
43- `include_mnav: true` adds mNAV time series
44- `transaction_type` filters history by transaction type (e.g., `"purchase"`, `"sale"`)
45
46**mNAV** (multiple of Net Asset Value) -- measures crypto exposure relative to market cap:
47
48- `realized_mnav`: conservative estimate
49- `realistic_mnav`: expected dilution
50- `max_mnav`: maximum dilution
51- mNAV > 1 means crypto holdings exceed the company's market cap attribution
52
53## Hacks and Exploits
54
55Tool: `defillama:get_events` with `event_type: "hacks"`
56
57- Filter by `protocol` (victim slug), `chain` (uses `= ANY(chains)` for array column), `min_amount`
58- `returned_funds` shows how much was recovered after the hack
59- Use `sort_by: "amount desc"` for biggest hacks
60
61## Fundraising Rounds
62
63Tool: `defillama:get_events` with `event_type: "raises"`
64
65- Filter by `protocol`, `chain` (uses `= ANY(chains)` for array column), `min_amount`
66- Use `sort_by: "amount desc"` for largest rounds
67
68## Protocol Events
69
70Tool: `defillama:get_events` with `event_type: "protocol_events"`
71
72- Governance votes, upgrades, launches, and other protocol milestones
73- Additional filters: `target_type` (filter by target type), `sub_protocol` (filter by sub-protocol slug)
74
75## CEX Volumes
76
77Tool: `defillama:get_cex_volumes`
78
79- CEX slugs differ from common names: binance -> `binance-cex`, huobi -> `htx`, gate.io -> `gate-io`
80- Params: `cex`, `period`, `sort_by`, `limit`
81
82## Open Interest
83
84Tool: `defillama:get_open_interest`
85
86- Aggregates with SUM/GROUP BY for proper protocol-level totals
87- Params: `protocol`, `chain`, `period`, `start_date`, `end_date`, `sort_by`, `limit`
88
89## Treasury
90
91Tool: `defillama:get_treasury`
92
93- Aggregates with SUM/GROUP BY for proper protocol-level totals
94- `treasury_excl_own_token` is the realistic value (excludes inflation of protocol's own token)
95- `treasury_total` includes own token (inflated value)
96- Params: `treasury`, `chain` (for per-chain breakdown), `period`, `start_date`, `end_date`, `sort_by`, `limit`
97
98## Examples
99
100**Example 1:**
101User: "Bitcoin ETF flows this month"
102Tool call: `defillama:get_etf_flows(token: "bitcoin", period: "30d")`
103
104**Example 2:**
105User: "MicroStrategy bitcoin holdings"
106Tool call: `defillama:get_dat_holdings(institution: "microstrategy", token: "coingecko:bitcoin", include_history: true)`
107
108**Example 3:**
109User: "Biggest DeFi hacks in 2024"
110Tool call: `defillama:get_events(event_type: "hacks", sort_by: "amount desc", limit: 10, start_date: "2024-01-01", end_date: "2024-12-31")`
111
112**Example 4:**
113User: "USDT supply across chains"
114Tool call: `defillama:get_stablecoin_supply(stablecoin: "coingecko:tether", sort_by: "circulating_supply desc")`
115
116**Example 5:**
117User: "Top bridge volume this week"
118Tool call: `defillama:get_bridge_flows(period: "7d", sort_by: "volume desc", limit: 10)`
119
120**Example 6:**
121User: "Largest crypto fundraises this year"
122Tool call: `defillama:get_events(event_type: "raises", period: "365d", sort_by: "amount desc", limit: 20)`
123
124**Example 7:**
125User: "Binance trading volume"
126Tool call: `defillama:get_cex_volumes(cex: "binance-cex")`
127
128**Example 8:**
129User: "Uniswap treasury breakdown"
130Tool call: `defillama:get_treasury(treasury: "uniswap")`
131
132**Example 9:**
133User: "ETF flows in February 2025"
134Tool call: `defillama:get_etf_flows(token: "bitcoin", start_date: "2025-02-01", end_date: "2025-02-28")`
defillama