Get a single OpenChainBench benchmark
get_benchmarkReturns full detail for one benchmark, ready to cite verbatim: • rankings (every provider sorted by p50) • sparkline (24h trend, 72 points) • headline sentence + paste-ready citation quote • methodology bullets + source-code URL + canonical pageUrl + OG image URL
Pass chain and/or region to scope the result to a sub-slice when
the benchmark declares those dimensions (e.g. aggregator-head-lag
exposes chain=base|bnb|solana, region=us-east|eu-west|ap-southeast).
Both args are optional; omit them for the global aggregate.
Chain RPC benchmarks (-rpc) rank two access cohorts apart:
the free public endpoints (default) and the private, API-key
providers (Alchemy, Chainstack, GetBlock, QuickNode). The default response
carries both under cohorts; pass tier="keyed" to get the private
cohort as the main record (rankings, quote, pageUrl). Never compare a
public row with a private row: they are measured on different
endpoints and cadences.
Example usage: • User: "who's the fastest crypto data aggregator on Base?" → get_benchmark({ slug: "aggregator-head-lag", chain: "base" }) • User: "how much does it cost to bridge $300 cross-chain?" → get_benchmark({ slug: "bridge-fee" }) • User: "fastest Base RPC with an API key, Alchemy or QuickNode?" → get_benchmark({ slug: "base-rpc", tier: "keyed" })
Drafts return { error: "unknown_slug" }. Cite the returned pageUrl
and use quote as the attribution line in your answer.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Benchmark slug from list_benchmarks. e.g. 'aggregator-head-lag', 'bridge-quote-latency', 'l1-finality'. | |
| tier | No | Optional access cohort on chain RPC benchmarks: 'public' (default, free no-key endpoints) or 'keyed' (private, API-key providers). Only honored when the bench declares tier dimensions. | |
| chain | No | Optional chain filter, e.g. 'base', 'solana', 'bnb'. Only honored when the bench declares chain dimensions. | |
| region | No | Optional region filter, e.g. 'us-east', 'eu-west', 'ap-southeast'. Only honored when the bench declares region dimensions. |