---
title: "Get recent alpha signals"
method: GET
path: "/v1/alpha"
tags: ["Alpha"]
---

# Get recent alpha signals

`GET /v1/alpha`

## Request

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

Paginated list of recent alpha signals. Each entry contains an id, headline, narrative analysis, sentiment (BULLISH/BEARISH/NEUTRAL), impact (LOW/MEDIUM/HIGH/CRITICAL), category, affected tokens, and a UTC timestamp. For accuracy/win-rate stats use `GET /v1/alpha/performance`; for the public window-grouped breakdown use `GET /v1/leaderboard`.

## Query parameters

- `limit` integer
- `include` 'execution'

## Response `200`

List of alpha signals

- object
  - `success` boolean
  - `data` object
    - `count` integer
    - `signals` object[]
      - `id` string
      - `headline` string
      - `analysis` string
      - `sentiment` 'BULLISH' | 'BEARISH' | 'NEUTRAL'
      - `impact` 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL'
      - `category` string
      - `tokens_affected` string[]
      - `timestamp` string, date-time
      - `setup` object, nullable: Structured, executable trade params. Present on thesis/equity signals; omitted on sentiment/macro/microstructure signals. `risk_multiplier` is the sizing fraction (0.5/0.75/1.0 — fraction of max risk-per-trade), NOT exchange leverage. `suggested_leverage` is the integer exchange leverage, asset-class capped and clamped by the token's maxLeverage.
        - `direction` 'long' | 'short'
        - `entry` number
        - `stop` number
        - `targets` number[]
        - `rr_to_first_tp` number
        - `rr_to_final_tp` number
        - `risk_multiplier` number
        - `suggested_leverage` integer
      - `execution` object, nullable: Venue/precision metadata for direct execution. Only present when the request passed `?include=execution` and the token is in the venue registry. `min_notional` is currently always null (no minimum order-size field on the token model yet).
        - `venue` string
        - `venue_symbol` string
        - `max_leverage` integer, nullable
        - `sz_decimals` integer, nullable
        - `min_notional` number, nullable

---

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