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

# Get net open positions snapshot

`GET /api/prime/trading/v1/accounts/{accountId}/margin/netopenpositions/snapshot`

## Request

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

Returns the net open positions snapshot as of a given time for the specified account.

## Path parameters

- `accountId` string, required

## Query parameters

- `transactionDateLt` string, date-time, required
- `currency` string[]
- `useFutureTransfers` boolean

## Response `200`

Net open positions snapshot

- MarginGetNetOpenPositionsSnapshotResponse
  - `netOpenPositions` MarginNetOpenPositionSnapshot[], required
    - `currency` string, required: The currency symbol for this position
    - `enterpriseId` string, required: The enterprise ID associated with this position
    - `accountId` string, required: The trading account ID
    - `netOpenPosition` string, required: The net position quantity at the snapshot time. Negative values indicate short positions (borrowed/owed), positive values indicate long positions (owned).
    - `appliedFutureTransfers` string, required: The total amount of pending transfers (after cutoff) applied to cover this position (only when useFutureTransfers=true). Always zero for long positions. For short positions, shows how much of the position will be covered by pending incoming transfers.
    - `earliestTransactionDate` string, date-time, required: Timestamp of the earliest transaction that contributed to this position
    - `latestTransactionDate` string, date-time, required: Timestamp of the most recent transaction that contributed to this position (before the cutoff)
    - `latestFutureTransferDate` string, date-time, nullable: Timestamp of the most recent pending transfer applied to this position. Only present when useFutureTransfers=true and pending transfers were applied. Null otherwise.

## Other responses

- `400`: Bad request - Invalid or missing 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)