---
title: "Get Master Account Portfolio Transactions"
method: GET
path: "/v1/kraken_embed/master_account/transactions"
tags: ["Kraken Embed"]
---

# Get Master Account Portfolio Transactions

`GET /v1/kraken_embed/master_account/transactions`

## Request

- Base URL: `https://api.privy.io`
- URL: `https://api.privy.io/v1/kraken_embed/master_account/transactions`
- Auth: HTTP basic

Get transaction history for the master account's portfolio with filtering and pagination options.

## Query parameters

- `cursor` string
- `types` KrakenEmbedTransactionType[]
- `page_size` integer
- `assets` string[]
- `from_time` string, date-time
- `until_time` string, date-time
- `statuses` KrakenEmbedTransactionStatus[]
- `ids` string[]
- `sorting` 'descending' | 'ascending': Sort direction for paginated transaction lists.
- `quote` string
- `ref_ids` KrakenEmbedPortfolioTransactionRefId[]
  - `type` 'simple_order_quote' | 'simple_order_quote_failed', required: The type of reference ID used to filter portfolio transactions by quote or failed quote references.
  - `ref_id` string, required

## Headers

- `privy-app-id` string, required: ID of your Privy app.

## Response `200`

Transaction history retrieved successfully.

- object
  - `errors` unknown[]
    - unknown
  - `error` unknown[]
    - unknown
  - `result` object, nullable, required
    - `transactions` object[], required
      - `id` string, required
      - `time` string, date-time, required
      - `type` 'simple_order' | 'simple_order_failed' | 'earn_reward', required: Type of portfolio transaction in the transaction history.
      - `status` 'unspecified' | 'in_progress' | 'successful' | 'failed': Lifecycle status of a portfolio transaction.
      - `ref_id` string, required
      - `ref_id2` string, nullable
      - `spend` object, nullable, required
        - `ledger_id` string, nullable
        - `time` string, date-time, nullable
        - `amount` object, required
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `quoted_amount` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `fee` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `quoted_fee` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `total` object, required
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `quoted_total` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `balance` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
      - `receive` object, nullable, required
        - `ledger_id` string, nullable
        - `time` string, date-time, nullable
        - `amount` object, required
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `quoted_amount` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `fee` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `quoted_fee` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `total` object, required
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `quoted_total` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
        - `balance` object, nullable
          - `asset` string, required
          - `asset_class` 'currency', nullable, required
          - `amount` string, required
      - `details` union, required
        - object
          - `type` 'simple_order', required
          - `quote_id` string, required
          - `trade_type` 'unspecified' | 'buy' | 'sell' | 'convert', required
          - `parent_transaction` string, nullable, required
        - object
          - `type` 'simple_order_failed', required
          - `receive_asset` object, required
            - `asset` string, required
            - `class` 'currency', required
          - `spend_asset` object, required
            - `asset` string, required
            - `class` 'currency', required
          - `trade_type` 'unspecified' | 'buy' | 'sell' | 'convert', required
          - `failure_reason` 'other' | 'insufficient_funds' | 'card_issue' | 'user_account_issue', required
        - object
          - `type` 'earn_reward', required
    - `stats` object, nullable, required
      - `transactions_seen` integer, nullable, required
    - `next_cursor` string, nullable, required

## Changes

- **2026-06-26** `c10a42ebeddb`: 1 breaking, 5 info
  - the `result/transactions/items/status` response's property type changed from `string, null` to no type for status `200`
  - added `#/components/schemas/KrakenEmbedTransactionStatus, subschema #2` to the `result/transactions/items/status` response property `anyOf` list for the response status `200`
  - removed the `failed` enum value from the `result/transactions/items/status` response property for the response status `200`
  - removed the `in_progress` enum value from the `result/transactions/items/status` response property for the response status `200`
  - …2 more

[Operation history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/kraken_embed/master_account/transactions/get.md)

---

[API](https://skmtc.dev/privy-io/apis/privy-api.md) - [All operations](https://skmtc.dev/privy-io/apis/privy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/privy-io/apis/privy-api/revisions/3a2288470053?raw)