Groups
Dimension Groups
GET /api/universes/:universe/:dimension Every group in one dimension of a universe — all its sectors, say, or all its regions. Without dates you get the latest day; add from and to for a history.
Example
Groups in one dimension
curl https://api.bytetree.io/api/universes/bytetrend/region \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.bytetree.io/api/universes/bytetrend/region", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
const body = await res.json();import requests
res = requests.get(
"https://api.bytetree.io/api/universes/bytetrend/region",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
body = res.json()
Response
200 {
"count": 7,
"smallOmitted": 0,
"dimension": "bytetrend/region",
"data": [
{
"dimension": "bytetrend/region",
"group": "North America",
"date": "2026-10-09T00:00:00.000Z",
"assetCount": 3039,
"avgByteTrendLocal200w": 3.315,
"avgByteTrendLocal30d": 2.0566,
"avgByteTrendCapr200w": 1.7271,
"avgByteTrendCapr30d": 1.5745,
"totalMarketCapUsd": 96864038677949.31,
"byteTrendBins": {
"local200w": [217, 205, 467, 438, 504, 950],
"local30d": [709, 551, 747, 279, 238, 461],
"capr200w": [1027, 452, 371, 397, 252, 282],
"capr30d": [1285, 522, 351, 216, 227, 384]
},
"...": "..."
}
]
}More requests
ByteTrend sectors time series
curl "https://api.bytetree.io/api/universes/bytetrend/sector?from=2026-01-01&to=2026-03-01" \
-H "Authorization: Bearer YOUR_API_KEY"Selective fields
curl "https://api.bytetree.io/api/universes/bytetrend/region?fields=avgByteTrendLocal200w%2CavgByteTrendCapr30d%2CtotalMarketCapUsd" \
-H "Authorization: Bearer YOUR_API_KEY"Industry groups
curl https://api.bytetree.io/api/universes/bytefolio/industry \
-H "Authorization: Bearer YOUR_API_KEY"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). |
dimension |
string |
Yes | One of the five global dimensions: region, sector, industry, type, or country. Any other value returns 400 |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
from |
string |
No | Start date YYYY-MM-DD. Returns a time series when provided (with or without to) |
to |
string |
No | End date YYYY-MM-DD |
fields |
string |
No | Comma-separated list of metric fields to include |
includeSmall |
boolean |
No | true to include groups with fewer than 5 assets, hidden from listings by default — see Small-group floor. Only the exact value true is recognised |
Response
| Field | Type | Description |
|---|---|---|
count |
number |
Number of records returned |
smallOmitted |
number |
Groups hidden by the small-group floor (0 when includeSmall=true) |
dimension |
string |
The universe and dimension, as universe/dimension (e.g. bytetrend/region) |
data |
array |
Array of group metric objects (same schema as Universe Groups, including the per-variant byteTrendBins score histogram) |
Errors
As Universe Groups: unknown universe 404, macro 400. A :dimension that isn’t one of the five returns 400, naming the five. A valid dimension with nothing computed yet returns count: 0 with an empty data array.