Skip to content
These docs describe Tradr v0.14.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'

Authed. Returns the user’s positions (newest first), each carrying its tags array ordered by category then case-insensitive name. 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.

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

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