---
title: "GET /v4/user/accounts/{server}/{accountId}/portfolio/transactions"
method: GET
path: "/v4/user/accounts/{server}/{accountId}/portfolio/transactions"
tags: ["Portfolio (v4)"]
---

# GET /v4/user/accounts/{server}/{accountId}/portfolio/transactions

`GET /v4/user/accounts/{server}/{accountId}/portfolio/transactions`

## Request

- Base URL: `https://trading-api.oanda.com` (the document declares no server; this is the origin it was published from)
- URL: `https://trading-api.oanda.com/v4/user/accounts/{server}/{accountId}/portfolio/transactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/oanda/apis/up-gateway-v1/docs/v4/user/accounts/:server/:accountId/portfolio/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `accountId` string, required
- `server` 'oanda' | 'oanda-demo' | 'otms' | 'v20' | 'v20-demo' | 'oj' | 'oj-demo' | 'opt' | 'ftmo-1', required

## Query parameters

- `limit` number
- `offset` number
- `type` union[]
  - union
    - 'MARKET_OPEN' | 'MARKET_CLOSE' | 'STOP_LOSS' | 'TAKE_PROFIT' | 'STOP_OUT' | 'SPLIT'
    - 'INDEX_DIVIDEND' | 'DEPOSIT' | 'WITHDRAWAL' | 'DIVIDEND' | 'SPINOFF_ADJ' | 'TAX' | 'TAX_EQUIVALENT' | 'RIGHTS_ADJ' | 'ACQ_MERG_ADJ' | 'BONUS_ADJ' | 'STOCKDIV_ADJ' | 'CREDIT' | 'CORRECTION' | 'BONUS' | 'COMMISSION' | 'FINANCING' | 'SPLIT_ADJ'
- `orderId` string
- `instrument` string

## Response `200`

response

- object
  - `count` number, required
  - `limit` number, required
  - `offset` number, required
  - `data` union[]
    - union
      - object
        - `accountId` string, required
        - `id` string, required
        - `creationTime` number, required
        - `orderId` string
        - `tradeId` string
        - `ref` string
        - `instrument` string, required
        - `type` 'MARKET_OPEN' | 'MARKET_CLOSE' | 'STOP_LOSS' | 'TAKE_PROFIT' | 'STOP_OUT' | 'SPLIT', required
        - `quantity` number
        - `profit` number
        - `direction` 'LONG' | 'SHORT', required
        - `price` number
        - `pricePosition` number
        - `stopLoss` number: Stop Loss price
        - `takeProfit` number: Take profit price
        - `trailingStop` number: Trailing Stop distance value
        - `guaranteedStopLoss` number
        - `accountBallance` number
        - `halfSpreadCost` number
        - `commission` number
        - `guaranteedExecutionFee` number
        - `swap` number
      - object
        - `accountId` string, required
        - `id` string, required
        - `creationTime` number, required
        - `type` 'INDEX_DIVIDEND' | 'DEPOSIT' | 'WITHDRAWAL' | 'DIVIDEND' | 'SPINOFF_ADJ' | 'TAX' | 'TAX_EQUIVALENT' | 'RIGHTS_ADJ' | 'ACQ_MERG_ADJ' | 'BONUS_ADJ' | 'STOCKDIV_ADJ' | 'CREDIT' | 'CORRECTION' | 'BONUS' | 'COMMISSION' | 'FINANCING' | 'SPLIT_ADJ'
        - `accountBallanceChange` number
        - `accountBallance` number, required
        - `externalId` string, nullable: External transaction reference from payment gateway (MT5 ExternalID)
        - `gateway` string, nullable: Payment method name — populated for DEPOSIT/WITHDRAWAL (MT5 Gateway)
        - `comment` string, nullable: Free-text description from MT5 (MT5 Comment)
        - `symbol` string, nullable: Instrument symbol — populated for DIVIDEND, FINANCING, COMMISSION, etc. (MT5 Symbol)
        - `fee` number, nullable: Separate fee amount in account currency, distinct from commission (MT5 Fee)
        - `ref` string

---

[API](https://skmtc.dev/oanda/apis/up-gateway-v1.md) - [All operations](https://skmtc.dev/oanda/apis/up-gateway-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oanda/apis/up-gateway-v1/revisions/395d645513bf?raw)