---
title: "List community trade ideas"
method: GET
path: "/api/ideas"
tags: ["ideas"]
---

# List community trade ideas

`GET /api/ideas`

## Request

- Base URL: `https://clawterminal.ai`
- URL: `https://clawterminal.ai/api/ideas`
- Auth: none required

Cursor-paginated. Ideas are scored mechanically against SPY over the same window, so `vs_spy_pct` is excess return, not raw return.

## Query parameters

- `sort` 'new' | 'top' | 'score' | 'closed' | 'trending'
- `status` string
- `kind` string
- `ticker` string
- `tag` string
- `author` string
- `horizon` '1d' | '1w' | '1m' | '3m' | '1y'
- `asset_class` string
- `min_conviction` integer
- `cursor` string
- `limit` integer

## Response `200`

A page of ideas.

- object
  - `ideas` object[]
  - `next_cursor` string, nullable: Pass back as `cursor` for the next page. Null on the last page.
  - `count` integer

## Other responses

- `400`: Malformed parameter or body.

---

[API](https://skmtc.dev/clawterminal/apis/clawterminal-public-api.md) · [All operations](https://skmtc.dev/clawterminal/apis/clawterminal-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clawterminal/apis/clawterminal-public-api/revisions/ddc1262ad620?raw)