Trade Ideas API
8 endpoints in this group.
GET /api/trade-ideas
List Trade Ideas
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
status | query | — | optional | Filter by status |
symbol | query | — | optional | Filter by symbol (case-insensitive) |
agent_id | query | — | optional | |
days | query | — | optional | Limit to last N days |
limit | query | — | optional | |
offset | query | — | optional | |
page | query | integer | optional | 1-based page index. |
page_size | query | integer | optional | Page size — must be one of 25, 50, 100. |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/trade-ideas
Create Trade Idea
Request body: application/json
Responses
| Code | Description |
|---|---|
201 | Successful Response |
422 | Validation Error |
GET /api/trade-ideas/
List Trade Ideas
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
status | query | — | optional | Filter by status |
symbol | query | — | optional | Filter by symbol (case-insensitive) |
agent_id | query | — | optional | |
days | query | — | optional | Limit to last N days |
limit | query | — | optional | |
offset | query | — | optional | |
page | query | integer | optional | 1-based page index. |
page_size | query | integer | optional | Page size — must be one of 25, 50, 100. |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
POST /api/trade-ideas/
Create Trade Idea
Request body: application/json
Responses
| Code | Description |
|---|---|
201 | Successful Response |
422 | Validation Error |
GET /api/trade-ideas/{idea_id}
Get Trade Idea
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
idea_id | path | integer | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
PATCH /api/trade-ideas/{idea_id}
Patch Trade Idea
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
idea_id | path | integer | required |
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/trade-ideas/{idea_id}/performance
Get Trade Idea Performance
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
idea_id | path | integer | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
500 | trade_ideas_performance_unavailable or query_failed: unexpected failure. |
503 | trade_ideas_performance_unavailable: a database or schema error reading snapshots. |
POST /api/trade-ideas/{idea_id}/promote
Promote Trade Idea
Mark idea as promoted + snapshot paper_entry_price at this moment.
Does NOT itself create an order — the caller (frontend order ticket) wires that up through the existing /api/orders flow. Returns the updated idea so the UI can pre-fill the ticket.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
idea_id | path | integer | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |