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

Add a fill to a position.

POST
/api/positions/{id}/fills
curl --request POST \
  --url https://api.tradr.cloud/api/positions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/fills \
  --header 'Content-Type: application/json' \
  --data '{ "fees": "0", "filledAt": "2026-04-15T12:00:00Z", "notes": "example", "price": "example", "quantity": "example", "type": "entry" }'

Authed. A position is a sequence of fills, not a single trade: add an entry fill to open or scale in, an exit fill to scale out or close. The position’s average price, open quantity, status, and realised P&L are all derived from its fills, so adding one recomputes them. Monetary and quantity fields are strings to preserve decimal precision.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

The position the fill belongs to.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
fees

Non-negative decimal.

string
default: 0
filledAt
required
string format: date-time
notes
string
nullable <= 10000 characters
price
required

Non-negative decimal.

string
quantity
required

Positive decimal.

string
type
required
string
Allowed values: entry exit

Responses

Section titled “Responses”

201

Section titled “201”

The created fill, plus positionClosed — true when this was the exit that balanced the entered quantity, which closes the position in the same transaction.

Media typeapplication/json
object
createdAt
string format: date-time
fees

Decimal.

string
filledAt
string format: date-time
id
string format: uuid
notes
string
nullable
positionClosed
boolean
positionId
string format: uuid
price

Decimal.

string
quantity

Decimal.

string
type
string
Allowed values: entry exit
Example
{
  "type": "entry"
}

400

Section titled “400”

Validation error: an exit quantity beyond the available entry quantity, or a fractional quantity on an options position.

404

Section titled “404”

No such position for this user.

409

Section titled “409”

The position is closed, or an exit fill was sent to a position that is still a draft.