portal_get_time_series
Aggregate blockchain metrics into time buckets for simple activity charts, with compare-previous and contract grouping features.
Instructions
Build simple activity charts and other time-series views across supported VMs, including compare-previous windows and grouped EVM contract trends.
COMMON USER ASKS:
Base transactions per 15m bucket
Compare two periods
FIRST CHOICE FOR:
activity over time, compare-current-vs-previous, grouped trends, and simple activity charts
WHEN TO USE:
You want chart-ready metric buckets over time.
You want a simple activity chart for a network, defaulting to a 6h interactive window unless a longer window is explicitly requested.
You want to compare the current period to the previous period.
DON'T USE:
You need raw record lists instead of aggregated buckets.
You need DEX pool candles or OHLC output.
EXAMPLES:
Base transactions per 15m bucket: {"network":"base-mainnet","metric":"transaction_count","duration":"6h","interval":"15m"}
Compare two periods: {"network":"solana-mainnet","metric":"transaction_count","duration":"1h","interval":"5m","compare_previous":true}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Execution depth. Defaults to complete requested-window analysis; the optional fast value is only for explicitly bounded previews. | deep |
| metric | Yes | Metric to aggregate over time | |
| address | No | Optional: Filter to specific contract address for contract-specific trends | |
| network | Yes | Network name (supports short names: 'ethereum', 'polygon', 'base', etc.) | |
| duration | No | Total time period to analyze. Defaults to "6h" for interactive use. Explicit longer windows like "24h" or "7d" are supported but can take longer. Accepts compact durations like "30m" or natural phrases like "past 30 minutes". | 6h |
| group_by | No | Optional grouping mode. contract is currently supported only for EVM transaction_count | none |
| interval | Yes | Time bucket interval (5m, 15m, 1h, 6h, 1d) | |
| group_limit | No | Maximum number of contract groups when group_by=contract | |
| to_timestamp | No | Ending timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "now". | |
| from_timestamp | No | Starting timestamp. Accepts Unix seconds, Unix milliseconds, ISO datetime, or relative input like "24h ago". | |
| compare_previous | No | Compare the selected window against the immediately previous window |