Get an exit fill's in-kind transfer link and eligible candidates.
GET
/api/positions/{id}/fills/{fillId}/transfer-link
const url = 'https://api.tradr.cloud/api/positions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/fills/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/transfer-link';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.tradr.cloud/api/positions/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/fills/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/transfer-linkAuthed. 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.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”id
required
string format: uuid
fillId
required
string format: uuid
Must be an exit fill of this position.
Responses
Section titled “ Responses ”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