Ecosystems

Ecosystems represent blockchain networks and their associated token economies, such as Ethereum, Solana, and Arbitrum. This endpoint provides aggregate market data for 23 ecosystems, detailed constituent coin breakdowns, sparkline time series, TVL data via DeFi Llama, and inter-ecosystem correlation matrices.

List all ecosystems

Returns an overview of all 23 ecosystems with aggregate market metrics. No parameters required for the default list mode.

Query parameters

Name
ecosystem
Type
string
Description
Ecosystem identifier to fetch detail data for (e.g., ethereum, solana, arbitrum). When provided, the response includes constituent coins and sparkline data alongside the ecosystem list.
Name
excludeNative
Type
string
Description
Set to true to exclude each ecosystem's native token from aggregate calculations. Only applies when ecosystem is provided.
Name
correlation
Type
string
Description
Set to true to return the inter-ecosystem correlation matrix instead of ecosystem data.
Name
timeframe
Type
string
Description
Timeframe for correlation data (e.g., 1M, 3M). Only used when correlation=true. Defaults to 1M.
Name
tvl
Type
string
Description
Reserved for TVL-specific data retrieval.
Name
historical
Type
string
Description
Reserved for historical snapshot mode.
Name
chart
Type
string
Description
Reserved for chart-specific data retrieval.

Response fields

Name
ecosystems
Type
array
Description
Array of ecosystem objects. Each includes: id, name, slug, marketCap, volume24h, change1h, change24h, change7d, change30d, change200d, change1y, median1h, median24h, median7d, median30d, median200d, median1y, openInterest, fundingRate, mcapFdvRatio, volMcapRatio, oiMcapRatio, tvl, topCoin (object with symbol, image, price, change24h), coinCount, dominance, momentum, sentimentPct, mindsharePct, watchlistUsers, telegramMembers.
Name
totalEcosystemMcap
Type
number
Description
Sum of market caps across all ecosystems.
Name
basePrices
Type
object
Description
Reference prices for base currencies (BTC, ETH, SOL) used for currency conversion.
Name
updatedAt
Type
string
Description
ISO 8601 timestamp of the last data refresh.

Request

GET

/v1/ecosystems/data

curl -G https://www.sharpe.ai/api/v1/ecosystems/data \
  -H "Authorization: Bearer sk_live_your_key_here"

{
  "data": {
    "ecosystems": [
      {
        "id": "ethereum",
        "name": "Ethereum",
        "slug": "ethereum",
        "marketCap": 420000000000,
        "volume24h": 18500000000,
        "change1h": 0.42,
        "change24h": 1.85,
        "change7d": 4.20,
        "change30d": 12.50,
        "change200d": 65.30,
        "change1y": 180.40,
        "median1h": 0.38,
        "median24h": 1.60,
        "median7d": 3.80,
        "median30d": 11.20,
        "median200d": 60.10,
        "median1y": 170.20,
        "openInterest": 8500000000,
        "fundingRate": 0.0038,
        "mcapFdvRatio": 0.85,
        "volMcapRatio": 0.044,
        "oiMcapRatio": 0.020,
        "tvl": 62000000000,
        "topCoin": {
          "symbol": "ETH",
          "image": "https://...",
          "price": 3420,
          "change24h": 1.38
        },
        "coinCount": 50,
        "dominance": 24.8,
        "momentum": 2.15,
        "sentimentPct": 0,
        "mindsharePct": 0,
        "watchlistUsers": 0,
        "telegramMembers": 0
      }
    ],
    "totalEcosystemMcap": 1690000000000,
    "basePrices": {
      "btc": { "usd": 95200 },
      "eth": { "usd": 3420 },
      "sol": { "usd": 185 }
    },
    "updatedAt": "2026-03-28T07:30:00Z"
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-28T07:45:00Z"
  }
}

Get ecosystem detail

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

Name
ecosystems
Type
array
Description
The full list of all ecosystems with aggregate metrics (same as list mode).
Name
totalEcosystemMcap
Type
number
Description
Sum of market caps across all ecosystems.
Name
basePrices
Type
object
Description
Reference prices for base currencies (BTC, ETH, SOL).
Name
coins
Type
array
Description
Constituent coins for the selected ecosystem. Each coin includes id, symbol, name, image, price, marketCap, fdv, volume24h, change1h, change24h, change7d, change30d, change200d, change1y, ath, athDistance, fundingRate, openInterest, sparkline7d.
Name
sparkline
Type
array
Description
Array of [timestamp, value] tuples representing the ecosystem's market cap over time.
Name
updatedAt
Type
string
Description
ISO 8601 timestamp of the last data refresh.

Request

GET

/v1/ecosystems/data?ecosystem=ethereum

curl -G https://www.sharpe.ai/api/v1/ecosystems/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d ecosystem=ethereum \
  -d excludeNative=true

{
  "data": {
    "ecosystems": ["...same as list mode..."],
    "totalEcosystemMcap": 1690000000000,
    "basePrices": {
      "btc": { "usd": 95200 },
      "eth": { "usd": 3420 },
      "sol": { "usd": 185 }
    },
    "coins": [
      {
        "id": "uniswap",
        "symbol": "UNI",
        "name": "Uniswap",
        "image": "https://...",
        "price": 12.45,
        "marketCap": 7500000000,
        "fdv": 12500000000,
        "volume24h": 320000000,
        "change1h": 0.45,
        "change24h": 3.20,
        "change7d": -0.85,
        "change30d": 12.40,
        "change200d": 85.20,
        "change1y": 210.50,
        "ath": 44.97,
        "athDistance": -72.32,
        "fundingRate": 0.0032,
        "openInterest": 180000000,
        "sparkline7d": [11.2, 11.8, 12.1, 12.45]
      }
    ],
    "sparkline": [
      [1711584000000, 410000000000],
      [1711670400000, 415000000000],
      [1711756800000, 420000000000]
    ],
    "updatedAt": "2026-03-28T07:30:00Z"
  },
  "meta": {
    "request_id": "req_def456ghi789jklm",
    "timestamp": "2026-03-28T07:45:00Z"
  }
}

Get ecosystem correlations

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

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

Response fields

Name
timeframe
Type
string
Description
The timeframe used for the correlation calculation.
Name
labels
Type
string[]
Description
Ordered list of ecosystem names corresponding to matrix rows and columns.
Name
matrix
Type
number[][]
Description
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].

Request

GET

/v1/ecosystems/data?correlation=true&timeframe=3M

curl -G https://www.sharpe.ai/api/v1/ecosystems/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d correlation=true \
  -d timeframe=3M

{
  "data": {
    "timeframe": "3M",
    "labels": ["Ethereum", "Solana", "Arbitrum", "Base"],
    "matrix": [
      [1.00, 0.78, 0.92, 0.88],
      [0.78, 1.00, 0.70, 0.74],
      [0.92, 0.70, 1.00, 0.85],
      [0.88, 0.74, 0.85, 1.00]
    ]
  },
  "meta": {
    "request_id": "req_ghi789jkl012mnop",
    "timestamp": "2026-03-28T07:45:00Z"
  }
}

Read the error reference