Skip to main content
An ecosystem is a blockchain network and the token economy around it, such as Ethereum, Solana, or Arbitrum. This endpoint provides aggregate market data for 25 ecosystems, detailed constituent coin breakdowns, sparkline time series, TVL data via DeFi Llama, and inter-ecosystem correlation matrices.

List all ecosystems

GET /v1/ecosystems/data Returns an overview of all 25 ecosystems with aggregate market metrics. No parameters required for the default list mode.

Query parameters

string
Ecosystem identifier to fetch detail data for (e.g., ethereum, solana, arbitrum). Accepts the config id (bnb) or the URL slug (bnb-chain); an unknown value returns 400 invalid_parameter listing the valid values. When provided, the response includes constituent coins and sparkline data alongside the ecosystem list.
string
Set to true to exclude each ecosystem’s native token from aggregate calculations. Only applies when ecosystem is provided.
string
Set to true to return the inter-ecosystem correlation matrix instead of ecosystem data.
string
Timeframe for correlation data (e.g., 1M, 3M). Only used when correlation=true. Defaults to 1M.

Response fields

array
Array of ecosystem objects. Each includes: id, name, slug, nullable market observations (marketCap, volume24h, the return windows return1h … return1y and their medians medianReturn1h … medianReturn1y, openInterest, ratios, tvl, marketShare, and momentumReturn), fundingRate, topCoin (object with symbol, image, nullable price, and nullable return24h), coinCount, sentiment, mindshare, and watchlistUsers. Returns and shares (marketShare, sentiment, mindshare, each 0 to 1) are fractions: 0.0185 is 1.85%. marketShare is the ecosystem’s market cap over totalEcosystemExposureMcap. Missing upstream observations are null, never fabricated zeroes. openInterest is the constituents’ one-sided open interest across every venue, each asset once; fundingRate is their average funding (8-hour-equivalent, open-interest-weighted) annualized, as a fraction a year. An ecosystem’s constituents are the coins whose home chain it is and that are eligible (a 24h price change, market cap at least $1M, plausible 24h volume at least $100K, CoinGecko data under 48 hours old, and not a stablecoin, wrapped, bridged or staked copy, or tokenized asset); coinCount, the detail coins list and every aggregate count that one set.
number | null
Deduplicated sum of observed constituent market caps, or null when no market-cap observations are available.
object
Price returns for BTC, ETH, and SOL from CoinGecko, used to re-base ecosystem performance into BTC, ETH, or SOL terms. Each of btc, eth, and sol holds return1h, return24h, return7d, return30d, return200d, and return1y as fractions (-0.0249 = -2.49%). There are no USD prices here. basePrices is null when CoinGecko did not return every window for BTC, ETH and SOL; no window reads a fabricated 0.
string
ISO 8601 timestamp of the last data refresh.
Response

Get ecosystem detail

GET /v1/ecosystems/data?ecosystem={id} When the ecosystem parameter is provided, the response is enriched with the constituent coins and a sparkline time series for that ecosystem. Use excludeNative=true to filter out the native gas token from the coin list and aggregates.

Response fields

array
The full list of all ecosystems with aggregate metrics (same as list mode).
number | null
Deduplicated sum of observed constituent market caps, or null when unavailable.
object
Price returns for BTC, ETH, and SOL as fractions, in the same shape as list mode.
array
Constituent coins for the selected ecosystem. Each coin includes id, symbol, name, image, nullable price, marketCap, fdv, volume24h, the return windows return1h … return1y, ath, and fromAth (the price against the ATH, a fraction: -0.7232 is 72.32% below it), plus nullable fundingRate (the coin’s funding across venues on an 8-hour basis), avgFundingApr (that funding annualized, a fraction a year: 0.0493 is 4.93%) and openInterest (one-sided USD across venues), and sparkline7d.
array
Array of [timestamp, value] tuples representing the ecosystem’s market cap over time.
string
ISO 8601 timestamp of the last data refresh.
GET /v1/ecosystems/data?ecosystem=ethereum
Response

Get ecosystem correlations

GET /v1/ecosystems/data?correlation=true Returns a correlation matrix showing how ecosystem market caps move relative to each other over the specified timeframe. Useful for identifying which chains trend together and which offer diversification.

Query parameters

string
Must be true to activate correlation mode.
string
Lookback period for the correlation calculation. Defaults to 1M.

Response fields

string
The timeframe used for the correlation calculation.
string[]
Ordered list of ecosystem names corresponding to matrix rows and columns.
number[][]
Square correlation matrix. Values range from -1 (perfect inverse) to 1 (perfect correlation). matrix[i][j] is the correlation between labels[i] and labels[j].
object
Actual requested/available boundaries, bucket cadence, point count, usable pair count, and a full, partial, insufficient, or unknown status. Partial matrices are not presented as complete windows in the terminal.
string[]
Correlation windows with full boundary coverage. Short windows use 4-hour log returns; windows of 1M or longer use daily log returns.
GET /v1/ecosystems/data?correlation=true&timeframe=3M
Response
Read the error reference