---
title: "List trade intents"
method: GET
path: "/v1/trades"
tags: ["Trades"]
---

# List trade intents

`GET /v1/trades`

## Request

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

Paginated list of the calling key's trade intents (proposed orders awaiting approval/execution). Owner-scoped. Requires `read` scope.

## Query parameters

- `status` string
- `limit` integer

## Response `200`

Trade intents

- object
  - `success` boolean
  - `data` object
    - `intents` object[]
    - `total` integer

---

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