ByteTrend Monitor

A daily health check of one asset type in the bytetrend universe, in one response: stocks (the default), ETFs, crypto or commodities. It shows how many members are in each trend regime, which ones moved to a top or bottom score today, how the type’s groups compare (for stocks: sectors, countries and industries), and, for stocks, where the strongest and weakest sit. You also get a table with all four scores for every member.

The Monitor is computed once a day, after the daily run, and this endpoint returns the latest one. To see how any of its group figures has moved over time, use Monitor History.

curl --compressed https://api.bytetree.io/api/monitor \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://api.bytetree.io/api/monitor", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
const body = await res.json();

import requests

res = requests.get(
    "https://api.bytetree.io/api/monitor",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
body = res.json()

{
  "contractVersion": 3,
  "asOf": "2026-10-07",
  "generatedAt": "2026-10-08T10:20:22.769Z",
  "universe": "bytetrend",
  "type": "stock",
  "meta": { "candidates": 4093, "members": 4004, "stale": 313, "dropped": 89, "livenessDays": 7, "intradaySkipped": 0 },
  "variants": {
    "capr200w": {
      "summary": {
        "n": 3832, "avg": 1.6863, "bins": [1357, 679, 578, 588, 287, 343],
        "p5": 0.0895, "p0": 0.3541,
        "leading": 19, "emerging": 21, "weakening": 117, "bear": 340,
        "highs": 40, "lows": 457, "ups": 108, "downs": 234
      },
      "highs": {
        "count": 40,
        "rows": [
          {
            "symbol": "MSFT", "name": "Microsoft Corporation",
            "country": "United States", "sector": "Technology",
            "industry": "Software - Infrastructure", "mktCapUsd": 3935587040000,
            "return1D": 0.0009, "score": 4, "regime": "Emerging Trend", "change": 0, "asOf": "2026-10-07"
          }
        ]
      },
      "lows": { "count": 457, "rows": ["..."] },
      "new5": { "count": 14, "rows": ["..."] },
      "new0": { "count": 51, "rows": ["..."] },
      "dims": [
        { "key": "sector", "label": "Sector", "minN": 1 },
        { "key": "country", "label": "Country", "minN": 20 },
        { "key": "industry", "label": "Industry", "minN": 10 }
      ],
      "groups": {
        "sector": [
          { "key": "Financial Services", "n": 659, "n5": 98, "n0": 175, "p5": 0.1487, "p0": 0.2656, "avg": 2.0728, "avgChg": -0.0926 }
        ],
        "country": [
          { "key": "United States", "n": 1506, "n5": 130, "n0": 516, "p5": 0.0863, "p0": 0.3426, "avg": 1.6919, "avgChg": -0.0392 }
        ],
        "industry": [
          { "key": "Banks - Regional", "sector": "Financial Services", "n": 265, "n5": 42, "n0": 74, "p5": 0.1585, "p0": 0.2792, "avg": 2.0943, "avgChg": -0.1358 }
        ]
      },
      "sizeVol": {
        "cuts": [0.2933, 0.4402],
        "cells": {
          "All|All": { "n": 3832, "avg": 1.6863 },
          "All|High": { "n": 1220, "avg": 2.0877 },
          "All|Low": { "n": 1312, "avg": 1.314 },
          "...": "..."
        }
      },
      "sunburst": {
        "5": [
          {
            "country": "United States", "n": 130, "base": 1506,
            "sectors": [
              { "sector": "Healthcare", "n": 35, "base": 294 },
              { "sector": "Technology", "n": 32, "base": 208 }
            ]
          }
        ],
        "0": ["..."]
      },
      "regimes": { "Leading": ["..."], "Bear": ["..."] },
      "extremes": {
        "scored": 3832,
        "regions": [
          {
            "region": "North America", "n5": 141, "n0": 571, "base": 1688,
            "sectors": [
              { "sector": "Healthcare", "n5": 38, "n0": 96, "base": 318 },
              { "sector": "Technology", "n5": 34, "n0": 71, "base": 236 }
            ]
          }
        ],
        "sectors": [
          { "sector": "Financial Services", "n5": 98, "n0": 175, "base": 659 }
        ]
      },
      "sectors": "… deprecated copy of groups.sector",
      "countries": "… deprecated copy of groups.country",
      "industries": "… deprecated copy of groups.industry"
    },
    "capr30d": "...",
    "local200w": "...",
    "local30d": "..."
  },
  "stocks": [
    {
      "symbol": "000001.SZ", "name": "Ping An Bank Co., Ltd.", "country": "China",
      "sector": "Financial Services", "industry": "Banks - Regional",
      "mktCapUsd": 33438727364.75, "volatility30w": 0.1748, "return1D": 0.0177,
      "return3M": 0.1386, "return12M": 0.0753,
      "asOf": "2026-09-30", "stale": true,
      "capr200w": { "score": 3, "regime": "Neutral", "change": 0, "consec5": 0, "consec0": 0, "extLong": -0.1714, "extShort": 0.0183 },
      "capr30d": { "score": 3, "regime": "Neutral", "change": 0, "consec5": 0, "consec0": 0, "extLong": 0.0073, "extShort": 0.0031 },
      "local200w": { "score": 5, "regime": "Neutral", "change": 0, "consec5": 24, "consec0": 0, "extLong": 0.101, "extShort": 0.043 },
      "local30d": { "score": 3, "regime": "Neutral", "change": 0, "consec5": 0, "consec0": 0, "extLong": 0.0387, "extShort": -0.0067 }
    }
  ]
}

curl --compressed "https://api.bytetree.io/api/monitor?type=crypto" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl --compressed "https://api.bytetree.io/api/monitor?type=commodity&format=toon" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Any parameter not listed here returns 400.

Size and caching

The response is large: about 2.4 MB for the stock Monitor, which covers around 4,000 stocks. Send Accept-Encoding: gzip (the --compressed flag in the examples), which shrinks it about seven times, to roughly 340 KB. The Monitor changes once a day, so responses are sent with Cache-Control: private, max-age=300. There is no need to poll it more often than that.

Asset types

Every type returns the same response shape. What differs is which groupings the type has, how its stock lists are ordered, and whether the size × volatility grid, the sunburst, the regime map and the winners and losers matrix are filled in.

On bytetrend.io, crypto is labelled Digital and commodity is labelled Futures. The parameter values are always crypto and commodity.

A member with no value for a grouping (an unclassified ETF, a crypto asset with no market cap, a commodity with no futures group) is left out of that grouping’s groups, but still counts in the summary and the member lists.

A type’s snapshot appears once it has been computed. Until then, asking for that type returns 404 (see Errors).

Who is in it

Members are the active assets of the requested type in the bytetrend universe, with complete data from within the last 7 days, measured back from the latest close. An asset with nothing in that window is left out. A data row dated the same day the Monitor is computed may be incomplete, so it is skipped and the previous complete row is used. Crypto has no row dated the UTC day the Monitor is computed, so its asOf is normally the day before (UTC); other types’ asOf is their latest close, which can be earlier (a stock snapshot computed on a Sunday covers Friday). meta shows how the membership was counted.

A stale member is one whose market did not trade on asOf, for example because of a local holiday. It keeps its latest scores, but its change is 0, so it never counts towards ups, downs, new5 or new0.

Response

Top level

asOf, generatedAt and universe are null only if the published snapshot is damaged. The rest of the response is still served.

The four variant keys are the four ByteTrend scores. 200w is Weekly and 30d is Daily. capr is CAPR (scored against the world stock market) and local is Local (scored on the asset’s own price). For example, capr200w is Weekly CAPR. See Key Concepts.

meta

Variant blocks

Each of variants.capr200w, variants.capr30d, variants.local200w and variants.local30d has the same fields:

Regimes are the standard trend regimes: Leading Trend, Emerging Trend, Weakening Trend, Bear Trend, Neutral.

Summary

Member lists

highs, lows, new5 and new0 have the same shape:

Each row:

country, sector and industry are filled in where the asset has them. For types other than stock they are often null.

Group rows

Entries in each groups list:

Size × volatility grid

Stocks only. For other types sizeVol is null. sizeVol splits the members by market cap and by volatility, and gives the average score of each cell.

Size is Mega (market cap of $200B or more), Large ($10B to $200B) or Mid (under $10B). Volatility is Low, Mid or High. Either half can also be All, which gives the row and column totals, for example "Mega|All", "All|High" or "All|All". When cuts is null, only the "<size>|All" cells are present. A stock with no market cap is not placed in a size band.

Sunburst

Stocks only. For other types sunburst is null. sunburst shows where the score-5 and score-0 stocks are, by country and then by sector, for a ring or sunburst chart. It has two keys: "5" and "0".

Countries are ordered by n, largest first. A country with no stocks at that score is left out. A member with no country is listed under a country of "Unclassified", and one with no sector under a sector of "Unclassified", so the country n values add up to the number of members at that score.

Regime map

Stocks only. For other types regimes is null. It can also be null on snapshots computed before this field was added.

regimes has the same country-then-sector shape as the sunburst, but keyed by trend regime instead of score. It has two keys, Leading and Bear, and uses this variant’s regime: a Weekly variant’s regime for capr200w, a Daily one for capr30d, and so on.

Countries are ordered by n, largest first. The country n values under Leading add up to summary.leading, and those under Bear to summary.bear.

Winners and losers

Stocks only. For other types extremes is null. It is also null on snapshots computed before this field was added.

extremes counts the score-5 stocks (winners) and score-0 stocks (losers) by region and then by sector. Unlike the sunburst, every cell also gives how many stocks are scored there, and a region or sector with no stocks at either score is still listed, so you can read each count as a share.

In each region or sector entry:

The region is the same one the asset’s region field and /api/macro/region use. Every list is ordered by base, largest first, then by name. The counts add up exactly at every level: the base values add up to scored (across regions, and across sectors), the n5 values to summary.bins[5], the n0 values to summary.bins[0], and a region’s sectors add up to the region’s own figures.

Member table

stocks has one row for each member, ordered by symbol, with all four scores side by side. It keeps the name stocks for every type.

Per-variant figures

Each of a row’s capr200w, capr30d, local200w and local30d objects has these fields:

For extLong and extShort, the series and averages depend on the variant:

The Local close is the adjusted close, or the unadjusted close on a day with no adjusted figure. It is always in the asset’s own currency, never in US dollars, because that is the series the Local averages are built on. extLong or extShort is null when the series value or the average is missing, or the average is zero or negative.

The two counters count trading days on every variant, Weekly included: they are not converted to weeks. A counter goes back to 0 on the first day the score is something else. On a day with no score at all (a gap in the data), it keeps its previous value rather than resetting, so consec5 can be above 0 while score is null. A counter is null when the member’s data has none. A stale member keeps the values from its own latest close, like its scores.

Example

The first row of stocks here is stale: its market last traded on 2026-09-30, so its change values are 0.

A crypto snapshot (?type=crypto) has the same shape. It groups by cap tier, has no size × volatility grid or sunburst, and has no deprecated lists. Abridged, Daily CAPR shown:

{
  "contractVersion": 3,
  "asOf": "2026-10-07",
  "type": "crypto",
  "meta": { "candidates": 178, "members": 175, "stale": 1, "dropped": 3, "livenessDays": 7, "intradaySkipped": 0 },
  "variants": {
    "capr30d": {
      "summary": { "n": 175, "avg": 2.9543, "bins": [14, 13, 19, 69, 41, 19], "p5": 0.1086, "p0": 0.08, "...": "..." },
      "highs": {
        "count": 1,
        "rows": [
          {
            "symbol": "KCSUSD", "name": "KuCoin Token USD", "country": null, "sector": "Cryptocurrency", "industry": null,
            "mktCapUsd": 1008472345.04, "return1D": -0.0027, "score": 3, "regime": "Emerging Trend", "change": 0, "asOf": "2026-10-07"
          }
        ]
      },
      "dims": [{ "key": "capTier", "label": "Market-cap tier", "minN": 1 }],
      "groups": {
        "capTier": [
          { "key": "Micro", "n": 70, "n5": 2, "n0": 14, "p5": 0.0286, "p0": 0.2, "avg": 2.2, "avgChg": -0.2571 },
          { "key": "Small", "n": 62, "n5": 9, "n0": 0, "p5": 0.1452, "p0": 0, "avg": 3.3387, "avgChg": -0.371 },
          { "key": "Mid", "n": 32, "n5": 8, "n0": 0, "p5": 0.25, "p0": 0, "avg": 3.7188, "avgChg": -0.2188 },
          { "key": "Large", "n": 11, "n5": 0, "n0": 0, "p5": 0, "p0": 0, "avg": 3.3636, "avgChg": -0.5455 }
        ]
      },
      "sizeVol": null,
      "sunburst": null,
      "...": "..."
    },
    "...": "..."
  },
  "stocks": ["..."]
}

Errors