Skip to content
These docs describe Tradr v0.17.0. Running an older release? Check the release notes for what changed.

List the user's positions.

GET
/api/positions
curl --request GET \
--url 'https://api.tradr.cloud/api/positions?status=draft&classification=winning'

Authed. Returns the user’s positions and multi-leg groups (newest first, one entry per group — no per-group query), each carrying its tags array ordered by category then case-insensitive name and its classification (winning, losing or breakeven for a closed position or group, null otherwise). A grouped entry carries kind: "group", its legs (each shaped like an ungrouped item), and group-level figures (label, detectedLabel, netEntry, maxLoss); an ungrouped entry carries no kind key. status, classification and tag filters match a group’s own derived fields, not any one leg’s. Optional filters may be combined.

status
string
Allowed values: draft open closed
accountId
string format: uuid
tag
string

Comma-separated tag UUIDs; positions must carry every listed tag (AND semantics). Elements that are not UUIDs are ignored; an unknown id matches nothing.

classification
string
Allowed values: winning losing breakeven

Keep only positions with this outcome (AND-combined with the other filters). Only closed positions carry a classification, so combining it with status=draft or status=open returns an empty list.

The user’s positions, each with a tags array.

Validation error (e.g. an invalid accountId).