---
title: "List trade signals"
method: GET
path: "/v1/signals"
tags: ["Signals"]
---

# List trade signals

`GET /v1/signals`

## Request

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

Paginated list of trade signals (entry/stop/take-profit setups). Each entry is enriched with `valid_for_minutes`, `time_to_exit_minutes` (entered signals only), and broker `actions` (deep links + order-payload URL). Requires both `read` and `signals` scopes. Opt-in `include_calibration=true` inlines the matching calibration bucket per signal; `include_risk_caveats=true` appends upcoming macro-event caveats.

## Query parameters

- `limit` integer
- `offset` integer
- `token` string
- `direction` 'long' | 'short'
- `timeframe` '15m' | '1H' | '4H'
- `status` 'queued' | 'live' | 'entered' | 'closed' | 'cancelled'
- `domain` 'crypto' | 'us_equities' | 'india_stocks'
- `since` string, date-time
- `include_calibration` 'true' | 'false'
- `include_risk_caveats` 'true' | 'false'

## Response `200`

Enriched trade signals

- object
  - `success` boolean
  - `data` object
    - `count` integer
    - `limit` integer
    - `offset` integer
    - `signals` object[]
      - `id` string
      - `token` string
      - `domain` string
      - `direction` 'long' | 'short'
      - `timeframe` '15m' | '1H' | '4H'
      - `entry_price` number
      - `stop_loss` number
      - `take_profits` number[]
      - `suggested_leverage` number
      - `status` 'queued' | 'live' | 'entered' | 'closed' | 'cancelled'
      - `valid_until` string, date-time
      - `valid_for_minutes` integer
      - `time_to_exit_minutes` integer, nullable
      - `actions` object: Broker deep links + order-payload URL.
      - `calibration_bucket` object, nullable: Present only when include_calibration=true.
      - `risk_caveats` object[]: Present only when include_risk_caveats=true.

---

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