Latency analytics of an account - percentiles, server-side histogram bins and sampled points per group (shard, relayer, sender or gateway).

GET 
/v1/usage/latency

Served from pre-aggregated per-minute and per-hour latency histograms, grouped by relayer, sender or first_ack_gateway. samples[] holds at most 48 sampled points per group, for a strip plot. Only measured values are returned: a group without data is absent, never estimated. Synthetic probes are excluded.

Request

Responses

200

Grouped latency.

400

MALFORMED_REQUEST, VARIANTS_NOT_SUPPORTED, RELAYER_SIGNATURE_PRESENT, CHAIN_ID_MISMATCH, TX_VERSION_UNSUPPORTED, TX_OPTIONS_UNSUPPORTED, LEASE_MISSING, CURSOR_INVALID.

Response Headers

CoRelayer-Request-Id

Request id, also the instance of a problem document and the log correlation id.

401

UNAUTHENTICATED, TOKEN_INVALID (details.expectedShard = 1 when the native-auth block hash is not a shard-1 block), TOKEN_EXPIRED, CHALLENGE_INVALID, API_KEY_INVALID, STREAM_TICKET_INVALID, ASSIGN_PROOF_REQUIRED, ASSIGN_PROOF_INVALID.

403

FORBIDDEN, ORIGIN_NOT_ALLOWED, API_KEY_SCOPE, ACCOUNT_SUSPENDED, LEASE_INVALID, RECEIVER_NOT_ALLOWED, SENDER_NOT_AUTHORIZED, DEPLOY_NOT_ALLOWED, FREE_FLOW_BARRED.

429

RATE_LIMITED, GAS_BUDGET_EXCEEDED, HOURLY_BURN_EXCEEDED, TOO_MANY_IN_FLIGHT, QUOTA_EXHAUSTED (the latter without Retry-After; details.reason = CAP_REACHED_PAYG_OFF | PAYG_ESCROW_EMPTY).

Response Headers

Retry-After

Seconds (HTTP standard). Millisecond precision is in details.retryAfterMs of the problem body.

RateLimit-Limit

Requests (or RU on the relay path) allowed in the current window.

RateLimit-Remaining

Remaining units in the current window.

RateLimit-Reset

Seconds until the window resets (IETF RateLimit header fields).