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
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.Set to
true to exclude each ecosystem’s native token from aggregate calculations. Only applies when ecosystem is provided.Timeframe for correlation data (e.g.,
1M, 3M). Only used when correlation=true. Defaults to 1M.Response fields
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.Deduplicated sum of observed constituent market caps, or
null when no market-cap observations are available.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.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
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.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
Response fields
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].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.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

