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

Get an exit fill's in-kind transfer link and eligible candidates.

GET
/api/positions/{id}/fills/{fillId}/transfer-link
curl --request GET \
--url https://api.tradr.cloud/api/positions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/fills/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/transfer-link

Authed. fillId must be an exit fill of this position. link is the stored link, or null if none. candidates are the caller’s entry fills eligible to link against it — in another account, same symbol and side, equal quantity, and in no link of their own.

id
required
string format: uuid
fillId
required
string format: uuid

Must be an exit fill of this position.

The fill’s link (or null) and its eligible candidates.

Media typeapplication/json
object
candidates
Array<object>
object
accountId
string format: uuid
accountName
string
entryFillId
string format: uuid
filledAt
string format: date-time
positionId
string format: uuid
price

Decimal.

string
quantity

Decimal.

string
link
object
createdAt
string format: date-time
entryAccountId
string format: uuid
entryAccountName
string
entryFillId
string format: uuid
entryPositionId
string format: uuid
exitFillId
string format: uuid
id
string format: uuid
Examplegenerated
{
"candidates": [
{
"accountId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"accountName": "example",
"entryFillId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"filledAt": "2026-04-15T12:00:00Z",
"positionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"price": "example",
"quantity": "example"
}
],
"link": {
"createdAt": "2026-04-15T12:00:00Z",
"entryAccountId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"entryAccountName": "example",
"entryFillId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"entryPositionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"exitFillId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}
}

No such position for this user