TriportRPC

Get current metrics snapshot for a MEV cache host

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

Returns the latest value of every known MEV-cache metric observed on a single host, captured at the most recent slot.

Solanasol_mev_intelbusiness — sustained RPS per the sol_mev_intel category, with burst up to 2× sustained

This endpoint returns a point-in-time snapshot of all MEV-cache metrics currently tracked for one host. Use it to inspect a single operator in detail after you have located it via the leaderboard or the hosts list — for example to read its current blockhash and address-lookup-table cache-hit counters.

The response is a flat map of metric name → numeric value, reflecting the most recently captured slot for that host. Counter-style metrics (e.g. mev_cache_hits_total) are cumulative; to compute a rate over time, query the time-series endpoint instead.

If the host has never been observed (or all of its samples have aged out of retention), the endpoint returns 404. Pass the host exactly as it appears in the hosts list — it is matched verbatim, not normalized.

Parameters

Path parameters

hoststringrequired
Host identifier (IP address) of the MEV-cache operator, e.g. 198.13.137.184. Must match a known host.

Response

Response fields

FieldTypeDescription
hoststringThe host the snapshot is for (echoes the path parameter).
metricsobject (map)Map of metric name → numeric value. Each key is a known MEV-cache counter or gauge; each value is its latest captured value for the current slot. Keys present depend on what the host exposes; treat the set as open-ended.

Errors

CodeMeaningWhen it happens
401unauthorized / trial_expired / subscription_expiredMissing, invalid, or expired credentials.
403tier_insufficient / method_unknownValid key but below the business tier, or lacking the sol_mev_intel scope.
404resource not foundNo data exists for the requested host (unknown, or aged out of retention).
429rate_limitedSustained RPS for the sol_mev_intel category exceeded; honor the Retry-After header.

All errors share the standard envelope (error, message, request_id). See errors.md for the full envelope and per-code fields.

Examples

JavaScript (fetch)

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


if (res.status === 404) {
  throw new Error(`no data for host ${host}`);
}
if (!res.ok) {
  throw new Error(`request failed: ${res.status}`);
}


const snapshot = await res.json();
console.log(snapshot.host, snapshot.metrics);

TypeScript SDK (@triport/sdk)

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


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


const snapshot = await client.sol.mevIntel.hostSnapshot("198.13.137.184");
console.log(snapshot.host);
for (const [metric, value] of Object.entries(snapshot.metrics)) {
  console.log(`${metric} = ${value}`);
}

Python (triport-sdk)

import os
from triport import TriportClient


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


snapshot = client.sol.mev_intel.host_snapshot("198.13.137.184")
print(snapshot["host"])
for metric, value in snapshot["metrics"].items():
    print(f"{metric} = {value}")

Notes

  • Snapshot, not history. Values are the latest captured per metric. For trends or rates, use GET /v1/sol/intel/mev-cache/host/{host}/series, which accepts a metric, since/until, and limit.
  • Discovering hosts. Enumerate observable hosts with GET /v1/sol/intel/mev-cache/hosts, or rank them by throughput with GET /v1/sol/intel/mev-cache/leaderboard.
  • Counter semantics. Metrics ending in _total are monotonic counters that reset to zero if the underlying source restarts; do not assume monotonicity across long gaps.
  • No daily cap. Rate limiting is RPS-per-tier with burst; there is no daily quota.