Ecosystems

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 23 ecosystems, detailed constituent coin breakdowns, sparkline time series, TVL data via DeFi Llama, and inter-ecosystem correlation matrices.

GET/v1/ecosystems/data

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.

Response fields

Name
ecosystems
Type
array
Description
Array of ecosystem objects. Each includes: id, name, slug, nullable market observations (marketCap, volume24h, price-change and median windows, openInterest, ratios, tvl, dominance, and momentum), fundingRate, topCoin (object with symbol, image, nullable price, and nullable change24h), coinCount, sentimentPct, mindsharePct, watchlistUsers, and telegramMembers. Missing upstream observations are null, never fabricated zeroes.
Name
totalEcosystemMcap
Type
number | null
Description
Deduplicated sum of observed constituent market caps, or null when no market-cap observations are available.
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"

Response

{
  "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",
    "elapsed_ms": 12
  }
}

GET/v1/ecosystems/data?ecosystem={id}

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 | null
Description
Deduplicated sum of observed constituent market caps, or null when unavailable.
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, nullable price, marketCap, fdv, volume24h, return windows, ath, and athDistance, plus nullable fundingRate and openInterest, and 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

Response

{
  "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",
    "elapsed_ms": 12
  }
}

GET/v1/ecosystems/data?correlation=true

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].
Name
coverage
Type
object
Description
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.
Name
availableTimeframes
Type
string[]
Description
Correlation windows with full boundary coverage. Short windows use 2-hour log returns; windows of 1M or longer use daily log returns.

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

Response

{
  "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",
    "elapsed_ms": 12
  }
}

Read the error reference