Dimension Groups

Returns all groups within a specific dimension of a universe. Without date filters, returns the latest date only. With from/to, returns a time series.

Request

# Latest groups for Global Trends regions
curl https://api.bytetree.io/api/universes/global-trends-200/region

# Macro sectors time series
curl "https://api.bytetree.io/api/universes/macro/sector?from=2026-01-01&to=2026-03-01"

# Selective fields
curl "https://api.bytetree.io/api/universes/macro/region?fields=avgByteTrendLocal200w,avgByteTrendCapr30d,totalMarketCapUsd"

# Industry groups
curl https://api.bytetree.io/api/universes/global-trends-200/industry

Path Parameters

Name	Type	Required	Description
`universe`	`string`	Yes	Universe slug (e.g. `macro`, `global-trends-200`) — see Universes for the vocabulary. Out-of-scope slugs return `403`.
`category`	`string`	Yes	Dimension: `region`, `sector`, `industry`, `type`, or `country`

Query Parameters

Name	Type	Required	Description
`from`	`string`	No	Start date `YYYY-MM-DD`. When provided with `to`, returns time series.
`to`	`string`	No	End date `YYYY-MM-DD`
`fields`	`string`	No	Comma-separated list of metric fields to include

Response

Field	Type	Description
`count`	`number`	Number of records returned
`dimension`	`string`	The dimension slug (`universe/category`)
`data`	`array`	Array of group metric objects (same schema as Universe Groups, including the per-variant `byteTrendBins` score histogram)

{
  "count": 4,
  "dimension": "global-trends-200/region",
  "data": [
    {
      "dimension": "global-trends-200/region",
      "group": "Americas",
      "date": "2026-03-23T00:00:00.000Z",
      "assetCount": 80,
      "avgByteTrendLocal200w": 3.2,
      "avgByteTrendLocal30d": 2.9,
      "avgByteTrendCapr200w": 2.8,
      "avgByteTrendCapr30d": 2.4,
      "totalMarketCapUsd": 45000000000000,
      "byteTrendBins": {
        "local200w": [3, 5, 21, 2, 13, 35],
        "local30d":  [8, 11, 12, 13, 8, 28],
        "capr200w":  [17, 12, 11, 12, 10, 17],
        "capr30d":   [30, 8, 13, 8, 3, 18]
      },
      "..."
    }
  ]
}