---
title: "Win-rate / PnL stats breakdown"
method: GET
path: "/v1/signals/stats"
tags: ["Signals"]
---

# Win-rate / PnL stats breakdown

`GET /v1/signals/stats`

## Request

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

Aggregate signal performance broken down by direction, token, and timeframe, plus rolled-up totals (win rate, avg PnL). Optional `token` narrows all breakdowns to a single token. Requires `read` and `signals` scopes.

## Query parameters

- `since` string, date-time
- `domain` 'crypto' | 'us_equities' | 'india_stocks'
- `token` string

## Response `200`

Stats breakdown

- object
  - `success` boolean
  - `data` object
    - `since` string
    - `totals` object
      - `n` integer
      - `wins` integer
      - `losses` integer
      - `wr` number
      - `avg_pnl` number
    - `by_direction` object
    - `by_token` object
    - `by_timeframe` object

---

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