Skip to main content

UsageLatency

Grouped latency analytics (GET /v1/usage/latency), built from pre-aggregated latency histograms. Only measured values are returned. Percentile members are null when a group has fewer than 20 samples, because a percentile of a handful of points says little.

accountAddressrequired

MultiversX bech32 address.

Possible values: Value must match regular expression ^erd1[02-9ac-hj-np-z]{58}$

Example: erd1mf4u0jr6786wtz7s7dj6gmpyfafg8e0exh5wvye5cygvvxyyxhpsmj8q0e
windowstringrequired

Possible values: [1h, 24h, 7d, 30d]

groupBystringrequired

Possible values: [shard, relayer, sender, gateway]

fromMsinteger<int64>required

Unix time in milliseconds.

Possible values: >= 0

toMsinteger<int64>required

Unix time in milliseconds.

Possible values: >= 0

sloTargetInclusionP99Msinteger | nullnullable

Published SLO target, when one is published; else null.

groups object[]required
  • Array [
  • keystringrequired

    Shard number, relayer address, sender address, or gateway id (G1, G2, G2b, G3) = the gateway of the first acknowledgement.

    labelstring

    Display label (relayer brand name, shard name). Text, never HTML.

    countintegerrequired
    inclusion objectrequired
    p50Msinteger | nullnullable
    p95Msinteger | nullnullable
    p99Msinteger | nullnullable
    added objectrequired
    p50Msinteger | nullnullable
    p95Msinteger | nullnullable
    p99Msinteger | nullnullable
    bins object[]required

    Server-side histogram of inclusionMs; count = samples with inclusionMs <= leMs and above the previous bin. The last bin has leMs = null (overflow).

  • Array [
  • leMsinteger | nullnullablerequired
    countintegerrequired
  • ]
  • samples object[]required

    Sampled points for the strip plot (reservoir sample kept in the rollup; at most 48 per group).

    Possible values: <= 48

  • Array [
  • atMsinteger<int64>required

    Unix time in milliseconds.

    Possible values: >= 0

    inclusionMsintegerrequired
    txHashTxHashrequired

    Possible values: Value must match regular expression ^[0-9a-f]{64}$

  • ]
  • ]
  • UsageLatency
    {
    "account": "erd1mf4u0jr6786wtz7s7dj6gmpyfafg8e0exh5wvye5cygvvxyyxhpsmj8q0e",
    "window": "1h",
    "groupBy": "shard",
    "fromMs": 0,
    "toMs": 0,
    "sloTargetInclusionP99Ms": 0,
    "groups": [
    {
    "key": "string",
    "label": "string",
    "count": 0,
    "inclusion": {
    "p50Ms": 0,
    "p95Ms": 0,
    "p99Ms": 0
    },
    "added": {
    "p50Ms": 0,
    "p95Ms": 0,
    "p99Ms": 0
    },
    "bins": [
    {
    "leMs": 0,
    "count": 0
    }
    ],
    "samples": [
    {
    "atMs": 0,
    "inclusionMs": 0,
    "txHash": "string"
    }
    ]
    }
    ]
    }