---
title: "Get positions activity"
method: GET
path: "/api/prime/trading/v1/accounts/{accountId}/margin/positions/activity"
tags: ["Margin"]
---

# 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

- `accountId` string, required

## Query parameters

- `transactionDateGte` string, date-time
- `transactionDateLt` string, date-time
- `currency` string[]
- `type` string[]
- `offset` integer
- `limit` integer

## Response `200`

Positions activity

- MarginGetPositionsActivityResponse
  - `positionsActivity` PositionActivityEntry[], required
    - `type` 'fill-base-leg' | 'fill-quote-leg' | 'position-transfer', required — The type of activity
    - `id` string, required — The unique identifier of the fill or position transfer
    - `currency` string, required — The currency symbol for this activity
    - `quantity` string, required — The quantity contribution to the open position. Negative values indicate short positions, positive values indicate long positions.
    - `enterpriseId` string, required — The enterprise ID for the activity
    - `accountId` string, required — The trading account ID for the activity
    - `transactionDate` string, date-time, required — The date and time when the activity occurred

## Other responses

- `400` — Bad request - Invalid query parameters
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - Insufficient permissions
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)