---
title: "Forward-benchmark for one metric"
method: GET
path: "/v1/signals/benchmark"
tags: ["Signals"]
---

# Forward-benchmark for one metric

`GET /v1/signals/benchmark`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/signals/benchmark`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Latest snapshot plus history for a single forward-benchmark metric at a given window. Requires `read` and `signals` scopes.

## Query parameters

- `metric` string, required
- `window_days` integer
- `history` integer

## Response `200`

Metric snapshot + history

- object
  - `success` boolean
  - `data` object
    - `metric` string
    - `window_days` integer
    - `latest` object, nullable
    - `history` object[]

## Other responses

- `400`: Unknown or missing metric

---

[API](https://skmtc.dev/marketintell/apis/marketintell-api.md) · [All operations](https://skmtc.dev/marketintell/apis/marketintell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marketintell/apis/marketintell-api/revisions/f3ef87afc41f?raw)