Ctrl+K

Get positions activity

get/api/prime/trading/v1/accounts/{accountId}/margin/positions/activity

Returns unsettled fill legs and position transfers that make up the unsettled position as of a specified historical time range.

Path Parameters

  • accountIdstringRequired
    The ID of the account

Query Parameters

  • transactionDateGtestring<date-time>
    Return activity with transactionDate greater than or equal to this timestamp.
  • transactionDateLtstring<date-time>
    Return activity with transactionDate less than this timestamp.
  • currencyarray[string]
    Filter by currencies. If omitted, returns activity for all currencies.
  • typearray[string]
    Filter by activity type.
    Enum: fill-base-leg fill-quote-leg position-transfer
  • offsetintegerDefault: 0
    Pagination offset.
  • limitintegerDefault: 500
    Number of items per page.
    Maximum: <= 500

200 Response

positionsActivity array[object] required
Example: {"type":"fill-base-leg","id":"0d674606-431b-428f-83d1-b9199a6feb7d","currency":"BTC","quantity":"-2.5","enterpriseId":"63925f940c259a00061853808ffea830","accountId":"669e42a3c3fa7a17bf8483e7296373e1","transactionDate":"2025-07-29T21:13:09+00:00"}
type string required
The type of activity
Allowed values: fill-base-leg fill-quote-leg position-transfer
Example: fill-base-leg
id string required
The unique identifier of the fill or position transfer
Example: 0d674606-431b-428f-83d1-b9199a6feb7d
currency string required
The currency symbol for this activity
Example: BTC
quantity string required
The quantity contribution to the open position. Negative values indicate short positions, positive values indicate long positions.
Example: -2.5
Match pattern: ^-?[0-9]+(\.[0-9]+)?$
enterpriseId string required
The enterprise ID for the activity
Example: 63925f940c259a00061853808ffea830
accountId string required
The trading account ID for the activity
Example: 669e42a3c3fa7a17bf8483e7296373e1
transactionDate string <date-time>required
The date and time when the activity occurred
Example: 2025-07-29T21:13:09+00:00