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