TriportRPC
DashboardDocs

Get time-series metrics for a MEV cache host

GEThttps://api.triport.io/v1/sol/intel/mev-cache/host/198.13.137.184/series

Returns a time-ordered series of values for a single metric on one MEV cache host.

Solanasol_mev_intelbusiness

Fetches a historical time series for one metric on a single MEV cache host. Where the host snapshot gives you the host's current values, this endpoint gives you the same value sampled over a time window so you can chart trends, compute deltas, or feed a dashboard.

You name the host in the path and the metric in the metric query parameter (for example mev_cache_hits_total). The response is a flat list of { t, v } points ordered by time, where t is the sample timestamp and v is the metric's value at that moment.

Use since / until to bound the window and limit to cap how many points come back. This endpoint is part of the MEV intel surface and requires the sol_mev_intel scope on a business-tier key.

Parameters

Path parameters

hoststringrequired
Identifier of the MEV cache host to query (e.g. 198.13.137.184). Use a host returned by the hosts list / host snapshot endpoints.
Query parametersobject
metricstringrequired
Name of the metric to return, e.g. mev_cache_hits_total.
sincestring (date-time)optional
Lower bound of the window (RFC 3339). Only points at or after this time are returned.
untilstring (date-time)optional
Upper bound of the window (RFC 3339). Only points at or before this time are returned.
limitintegeroptional
Maximum number of points to return. Range 1–10000, default 1000.

Response

Response fields

FieldTypeDescription
hoststringThe host id that was queried (echoes the path parameter).
metricstringThe metric name that was queried (echoes the metric parameter).
pointsarrayTime-ordered samples for the metric.
points[].tstring (date-time)Timestamp of the sample (RFC 3339).
points[].vnumberValue of the metric at that timestamp.

Errors

CodeMeaningWhen it happens
401UnauthorizedMissing or invalid Authorization: Bearer key.
403ForbiddenKey lacks the sol_mev_intel scope or is not on the business tier.
429Too Many RequestsPer-tier request rate exceeded; retry after backing off.

See errors for the full error envelope.

Examples

JavaScript (fetch)

const params = new URLSearchParams({
  metric: "mev_cache_hits_total",
  since: "2026-05-28T00:00:00Z",
  until: "2026-05-29T00:00:00Z",
  limit: "1000",
});


const res = await fetch(
  `https://api.triport.io/v1/sol/intel/mev-cache/host/198.13.137.184/series?${params}`,
  { headers: { Authorization: `Bearer ${process.env.TRIPORT_API_KEY}` } }
);


if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { host, metric, points } = await res.json();
console.log(host, metric, points.length);

TypeScript SDK (@triport/sdk)

import { Triport } from "@triport/sdk";


const client = new Triport({ apiKey: process.env.TRIPORT_API_KEY! });


const series = await client.sol.mevCache.hostSeries("198.13.137.184", {
  metric: "mev_cache_hits_total",
  since: "2026-05-28T00:00:00Z",
  until: "2026-05-29T00:00:00Z",
  limit: 1000,
});


console.log(series.host, series.metric, series.points.length);

Python (triport-sdk)

import os
from triport import Triport


client = Triport(api_key=os.environ["TRIPORT_API_KEY"])


series = client.sol.mev_cache.host_series(
    "198.13.137.184",
    metric="mev_cache_hits_total",
    since="2026-05-28T00:00:00Z",
    until="2026-05-29T00:00:00Z",
    limit=1000,
)


print(series.host, series.metric, len(series.points))

Notes

  • limit caps the number of points returned (max 10000, default 1000). For wide windows that exceed the limit, narrow the range with since / until and page through successive windows.
  • Omitting since / until returns the most recent points up to limit.
  • Related endpoints in the MEV intel surface: the host snapshot for current values, the hosts list, and the leaderboard.