Universe Groups

The same group figures as the Macro Dataset, counting only one universe’s members — for example, the average trend score by sector within bytetrend. This route returns every group in all five dimensions (Region, Sector, Industry, Type, Country) at once.

Dimensions are global, so every universe is grouped the same way.

Request

# All dimensions for the ByteTrend universe
curl https://api.bytetree.io/api/universes/bytetrend

# All dimensions for ByteFolio
curl https://api.bytetree.io/api/universes/bytefolio

# Time series
curl "https://api.bytetree.io/api/universes/bytetrend?from=2026-01-01&to=2026-03-01"

Path Parameters

Query Parameters

Response

Each group metric object contains:

Identification

ByteTrend Score Aggregates

Each of the four ByteTrend scores (see Latest Metrics) has a matching set of group-level aggregates. Window suffixes map to UI labels: 200w = Weekly, 30d = Daily.

ByteTrend Score Bins

Per-variant histograms of the assets in the group, bucketed by their ByteTrend score (0–5) — the shape of the distribution rather than its average, which a mean alone hides. Each variant’s array is the bin count vector; bins[0] counts assets at score 0, bins[5] counts assets at score 5.

The byteTrendBins object:

For each variant, sum(bins) ≤ assetCount — the sum equals assetCount minus the number of group members whose score for that variant is null (e.g. asset hasn’t accumulated enough history for the long window).

"byteTrendBins": {
  "local200w": [4, 7, 27, 3, 17, 47],
  "local30d":  [11, 15, 16, 17, 10, 37],
  "capr200w":  [23, 16, 15, 16, 13, 22],
  "capr30d":   [40, 10, 18, 11, 4, 23]
}

(Sample: /api/macro/region/North America, assetCount = 106 — sums of 105 / 106 / 105 / 106 reflect 1, 0, 1, 0 null-score members respectively.)

Trend Distribution

Returns

Risk

{
  "universe": "bytetrend",
  "count": 132,
  "data": {
    "region": [
      {
        "dimension": "bytetrend/region",
        "group": "Americas",
        "date": "2026-09-09T00:00:00.000Z",
        "assetCount": 80,
        "avgByteTrendLocal200w": 3.2,
        "avgByteTrendLocal30d": 2.9,
        "avgByteTrendCapr200w": 2.8,
        "avgByteTrendCapr30d": 2.4,
        "medianByteTrendLocal200w": 4,
        "pctScore5Local200w": 0.4,
        "pctScore0Local200w": 0.05,
        "totalMarketCapUsd": 45000000000000,
        "dominantTrend": "Neutral",
        "byteTrendBins": {
          "local200w": [4, 7, 27, 3, 17, 47],
          "local30d":  [11, 15, 16, 17, 10, 37],
          "capr200w":  [23, 16, 15, 16, 13, 22],
          "capr30d":   [40, 10, 18, 11, 4, 23]
        },
        "..." : "..."
      }
    ],
    "sector": [
      { "dimension": "bytetrend/sector", "group": "Technology", "assetCount": 41, "..." : "..." }
    ],
    "industry": [ "..." ],
    "type": [ "..." ]
  }
}

Errors

An empty universe is not an error: GET /api/universes/<slug> on a universe with no members returns { "universe": "<slug>", "count": 0, "data": {} }. The same statuses apply on Dimension Groups and Group History.