Group Time Series

Returns the time series for a single group within a dimension of a universe.

Request

# Americas region time series (Global Trends)
curl "https://api.bytetree.io/api/universes/global-trends-200/region/Americas?from=2026-01-01"

# Technology sector (macro)
curl "https://api.bytetree.io/api/universes/macro/sector/Technology?from=2026-01-01"

# Banking & Lending industry (Global Trends)
curl "https://api.bytetree.io/api/universes/global-trends-200/industry/Banking%20%26%20Lending?from=2026-01-01"

# Selective fields
curl "https://api.bytetree.io/api/universes/macro/region/Europe?from=2026-01-01&fields=avgByteTrendLocal200w,avgReturnUsd1M"

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`
`group`	`string`	Yes	Group label (e.g. `Europe`, `Americas`, `Technology`, `Banking & Lending`)

Note: The special value config is reserved — GET /api/universes/:universe/:category/config returns the GroupingConfig for that dimension instead of group metrics. See Universes.

Query Parameters

Name	Type	Required	Description
`from`	`string`	No	Start date `YYYY-MM-DD`
`to`	`string`	No	End date `YYYY-MM-DD`
`fields`	`string`	No	Comma-separated list of metric fields to include

Response

Field	Type	Description
`dimension`	`string`	The dimension slug
`group`	`string`	The group label
`count`	`number`	Number of date records
`data`	`array`	Array of group metric objects sorted by date ascending (same schema as Universe Groups, including the per-variant `byteTrendBins` score histogram)

{
  "dimension": "global-trends-200/region",
  "group": "Americas",
  "count": 60,
  "data": [
    {
      "dimension": "global-trends-200/region",
      "group": "Americas",
      "date": "2026-01-02T00:00:00.000Z",
      "assetCount": 80,
      "avgByteTrendLocal200w": 2.5,
      "avgByteTrendLocal30d": 2.3,
      "avgByteTrendCapr200w": 3.1,
      "avgByteTrendCapr30d": 2.8,
      "totalMarketCapUsd": 42000000000000,
      "byteTrendBins": {
        "local200w": [2, 4, 18, 1, 9, 31],
        "local30d":  [6, 9, 11, 10, 7, 22],
        "capr200w":  [14, 10, 9, 11, 8, 13],
        "capr30d":   [25, 6, 11, 7, 2, 14]
      },
      "..."
    }
  ]
}

Forward-only. byteTrendBins is omitted on rows aggregated before 2026-05-02 — historical date-ranged responses on this endpoint will have byteTrendBins: undefined for early dates and populated bins only from the cutover forward. See the Changelog.