---
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`

## Request

- Base URL: `https://developers.bitgo.com`
- URL: `https://developers.bitgo.com/api/prime/trading/v1/accounts/{accountId}/margin/positions/activity`
- Auth: none declared

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.dev/bitgo/apis/bitgo-api.md) - [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/6b6e050a7f84?raw)