---
title: "Calibration buckets"
method: GET
path: "/v1/signals/calibration"
tags: ["Signals"]
---

# Calibration buckets

`GET /v1/signals/calibration`

## Request

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

Per-bucket realized win rate + sample size for the calibration table. With `aggregate=platform` the dimensions collapse to a single rolled-up view keyed by confidence bucket (used by the public track-record page). Requires `read` and `signals` scopes.

## Query parameters

- `aggregate` 'platform'
- `token` string
- `timeframe` '15m' | '1H' | '4H'
- `direction` 'long' | 'short'

## Response `200`

Calibration buckets

- object
  - `success` boolean
  - `data` object
    - `aggregate` 'platform'
    - `count` integer
    - `buckets` object[]
      - `conf_bucket` string
      - `sample_n` integer
      - `wr` number
      - `avg_pnl` number

---

[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)