Group History

The day-by-day history of one group within a universe — for example, how the average trend score of the technology stocks in bytetrend has moved this year.

Request

# Americas region time series (ByteTrend)
curl "https://api.bytetree.io/api/universes/bytetrend/region/Americas?from=2026-01-01"

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

# Banking & Lending industry (ByteFolio)
curl "https://api.bytetree.io/api/universes/bytefolio/industry/Banking%20%26%20Lending?from=2026-01-01"

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

Path Parameters

Name	Type	Required	Description
`universe`	`string`	Yes	Universe slug (e.g. `bytetrend`, `bytefolio`) — see Universes for the roster. Unknown slugs return `404`; `macro` returns `400` (the macro dataset is at `/api/macro`).
`category`	`string`	Yes	One of the five global dimensions: `region`, `sector`, `industry`, `type`, or `country`
`group`	`string`	Yes	Group label (e.g. `Europe`, `Americas`, `Technology`, `Banking & Lending`)

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": "bytetrend/region",
  "group": "Americas",
  "count": 60,
  "data": [
    {
      "dimension": "bytetrend/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.

Errors

As Universe Groups: unknown universe 404, macro 400. A group with nothing computed returns count: 0 with an empty data array.