get_token_protocols | GET /api/tokenProtocols/{symbol} Lists the amount of a certain token within all protocols.
Parameters:
symbol: token slug (e.g., 'usdt') |
get_protocol_inflows | GET /api/inflows/{protocol}/{timestamp} Lists the amount of inflows and outflows for a protocol at a given date.
Parameters:
protocol: protocol slug (e.g., 'compound-v3')
timestamp: unix timestamp (e.g., 1700006400) |
get_chain_assets | GET /api/chainAssets Get assets of all chains. |
get_protocols | GET /api/protocols List all protocols on defillama along with their tvl. |
get_protocol_details | GET /api/protocol/{protocol} Get historical TVL of a protocol and breakdowns by token and chain.
Parameters:
protocol: protocol slug (e.g., 'aave') |
get_historical_chain_tvl | GET /api/v2/historicalChainTvl Get historical TVL (excludes liquid staking and double counted tvl) of DeFi on all chains. |
get_historical_chain_tvl_by_chain | GET /api/v2/historicalChainTvl/{chain} Get historical TVL (excludes liquid staking and double counted tvl) of a chain.
Parameters:
chain: chain slug (e.g., 'Ethereum') |
get_protocol_tvl | GET /api/tvl/{protocol} Simplified endpoint to get current TVL of a protocol.
Parameters:
protocol: protocol slug (e.g., 'uniswap') |
get_chains | GET /api/v2/chains Get current TVL of all chains. |
get_stablecoin_dominance | GET /stablecoins/stablecoindominance/{chain} Get stablecoin dominance per chain along with the info about the largest coin in a chain.
Parameters:
chain: chain slug (e.g., 'Ethereum')
stablecoin: stablecoin ID (optional) |
get_stablecoins | GET /stablecoins/stablecoins List all stablecoins along with their circulating amounts.
Parameters:
include_prices: whether to include current stablecoin prices (default: True) |
get_stablecoin_charts_all | GET /stablecoins/stablecoincharts/all Get historical mcap sum of all stablecoins.
Parameters:
stablecoin: stablecoin ID (optional) |
get_stablecoin_charts_by_chain | GET /stablecoins/stablecoincharts/{chain} Get historical mcap sum of all stablecoins in a chain.
Parameters:
chain: chain slug (e.g., 'Ethereum')
stablecoin: stablecoin ID (optional) |
get_stablecoin_history | GET /stablecoins/stablecoin/{asset} Get historical mcap and historical chain distribution of a stablecoin.
Parameters:
asset: stablecoin ID |
get_stablecoin_chains | GET /stablecoins/stablecoinchains Get current mcap sum of all stablecoins on each chain. |
get_stablecoin_prices | GET /stablecoins/stablecoinprices Get historical prices of all stablecoins. |
get_active_users | GET /api/activeUsers Get active users on our chains and protocols pages. |
get_user_data | GET /api/userData/{type}/{protocolId} Get user data by type and protocol.
Parameters:
type: data type (e.g., 'activeUsers')
protocol_id: protocol ID |
get_emissions | GET /api/emissions List of all tokens along with basic info for each. |
get_emission_data | GET /api/emission/{protocol} Unlocks data for a given token/protocol.
Parameters:
protocol: protocol slug (e.g., 'aave') |
get_categories | GET /api/categories Overview of all categories across all protocols. |
get_forks | GET /api/forks Overview of all forks across all protocols. |
get_oracles | GET /api/oracles Overview of all oracles across all protocols. |
get_hacks | GET /api/hacks Overview of all hacks on our Hacks dashboard. |
get_raises | GET /api/raises Overview of all raises on our Raises dashboard. |
get_treasuries | GET /api/treasuries List all protocols on our Treasuries dashboard. |
get_entities | |
get_historical_liquidity | GET /api/historicalLiquidity/{token} Provides the available liquidity for swapping from one token to another on a specific chain.
Parameters:
token: token slug (e.g., 'usdt') |
get_yield_pools_old | GET /yields/poolsOld Same as /pools but it also includes a new parameter `pool_old` which usually contains pool address. |
get_yield_pools_borrow | GET /yields/poolsBorrow Borrow costs APY of assets from lending markets. |
get_yield_chart_lend_borrow | GET /yields/chartLendBorrow/{pool} Historical borrow cost APY from a pool on a lending market.
Parameters:
pool: pool id (can be retrieved from /poolsBorrow) |
get_yield_perps | GET /yields/perps Funding rates and Open Interest of perps across exchanges, including both Decentralized and Centralized. |
get_yield_lsd_rates | GET /yields/lsdRates APY rates of multiple LSDs. |
get_etf_overview | GET /etfs/overview Get BTC ETFs and their metrics (aum, price, fees...). |
get_etf_overview_eth | |
get_etf_history | GET /etfs/history Historical AUM of all BTC ETFs. |
get_etf_history_eth | GET /etfs/historyEth Historical AUM of all ETH ETFs. |
get_fdv_performance | GET /fdv/performance/{period} Get chart of narratives based on category performance (with individual coins weighted by mcap).
Parameters:
period: One of ['7', '30', 'ytd', '365'] |
get_yield_pools | GET /yields/pools Retrieve the latest data for all pools, including enriched information such as predictions. |
get_yield_chart | GET /yields/chart/{pool} Get historical APY and TVL of a pool.
Parameters:
pool: pool id (can be retrieved from /pools) |
get_derivatives_overview | GET /api/overview/derivatives Lists all derivatives along summaries of their volumes filtering by chain.
Parameters:
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response |
get_derivatives_summary | GET /api/summary/derivatives/{protocol} Volume Details about a specific perp protocol.
Parameters:
protocol: protocol slug (e.g., 'hyperliquid')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response |
get_bridges | GET /bridges List all bridges along with summaries of recent bridge volumes.
Parameters:
include_chains: set whether to include current previous day volume breakdown by chain |
get_bridge_details | GET /bridge/{id} Get summary of bridge volume and volume breakdown by chain.
Parameters:
id: bridge ID (can be retrieved from /bridges) |
get_bridge_volume | GET /bridgevolume/{chain} Get historical volumes for a bridge, chain, or bridge on a particular chain.
Parameters:
chain: chain slug (e.g., 'Ethereum') or 'all' for volume on all chains
id: bridge ID (optional, can be retrieved from /bridges) |
get_bridge_day_stats | GET /bridgedaystats/{timestamp}/{chain} Get a 24hr token and address volume breakdown for a bridge.
Parameters:
timestamp: Unix timestamp for the 24hr period starting at 00:00 UTC
chain: chain slug (e.g., 'Ethereum')
id: bridge ID (optional, can be retrieved from /bridges) |
get_bridge_transactions | GET /transactions/{id} Get all transactions for a bridge within a date range.
Parameters:
id: bridge ID (can be retrieved from /bridges)
start_timestamp: start timestamp (Unix Timestamp) for date range
end_timestamp: end timestamp (Unix Timestamp) for date range
source_chain: filter by source chain (e.g., 'Polygon')
address: filter by address in format {chain}:{address}
limit: limit number of transactions returned (max 6000) |
get_current_prices | GET /coins/prices/current/{coins} Get current prices of tokens by contract address.
Parameters:
coins: comma-separated tokens in format {chain}:{address} (e.g., 'ethereum:0xdF574c24545E5FfEcb9a659c229253D4111d87e1,coingecko:ethereum')
search_width: time range on either side to find price data (default: '6h') |
get_historical_prices | GET /coins/prices/historical/{timestamp}/{coins} Get historical prices of tokens by contract address.
Parameters:
timestamp: UNIX timestamp for historical prices
coins: comma-separated tokens in format {chain}:{address}
search_width: time range on either side to find price data (default: '6h') |
get_batch_historical_prices | GET /coins/batchHistorical Get historical prices for multiple tokens at multiple different timestamps.
Parameters:
coins: dict where keys are coins in format {chain}:{address} and values are arrays of timestamps
search_width: time range on either side to find price data (default: '6h') |
get_price_chart | GET /coins/chart/{coins} Get token prices at regular time intervals.
Parameters:
coins: comma-separated tokens in format {chain}:{address}
start: unix timestamp of earliest data point
end: unix timestamp of latest data point
span: number of data points returned
period: duration between data points (default: '24h')
search_width: time range on either side to find price data (default: '600') |
get_price_percentage | GET /coins/percentage/{coins} Get percentage change in price over time.
Parameters:
coins: comma-separated tokens in format {chain}:{address}
timestamp: timestamp of data point (defaults to now)
look_forward: whether to look forward from timestamp (default: False)
period: duration between data points (default: '24h') |
get_first_price_record | GET /coins/prices/first/{coins} Get earliest timestamp price record for coins.
Parameters:
coins: comma-separated tokens in format {chain}:{address} |
get_closest_block | GET /coins/block/{chain}/{timestamp} Get the closest block to a timestamp.
Parameters:
chain: chain identifier
timestamp: UNIX timestamp to find closest block for |
get_dex_overview | GET /api/overview/dexs List all dexs along with summaries of their volumes and dataType history data.
Parameters:
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response |
get_dex_overview_by_chain | GET /api/overview/dexs/{chain} List all dexs along with summaries of their volumes and dataType history data filtering by chain.
Parameters:
chain: chain name (e.g., 'ethereum')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response |
get_dex_summary | GET /api/summary/dexs/{protocol} Get summary of dex volume with historical data.
Parameters:
protocol: protocol slug (e.g., 'uniswap')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response |
get_options_overview | GET /api/overview/options List all options dexs along with summaries of their volumes and dataType history data.
Parameters:
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
data_type: desired data type (default: 'dailyNotionalVolume') |
get_options_overview_by_chain | GET /api/overview/options/{chain} List all options dexs along with summaries of their volumes and dataType history data filtering by chain.
Parameters:
chain: chain name (e.g., 'ethereum')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
data_type: desired data type (default: 'dailyNotionalVolume') |
get_options_summary | GET /api/summary/options/{protocol} Get summary of options dex volume with historical data.
Parameters:
protocol: protocol slug (e.g., 'lyra')
data_type: desired data type (default: 'dailyNotionalVolume') |
get_fees_summary | GET /api/summary/fees/{protocol} Get summary of protocol fees and revenue with historical data.
Parameters:
protocol: protocol slug (e.g., 'lyra')
data_type: desired data type (default: 'dailyFees') |