---
title: "Get Portfolio Transactions"
method: GET
path: "/v1/kraken_embed/users/{user_id}/transactions"
tags: ["Kraken Embed"]
---

# Get Portfolio Transactions

`GET /v1/kraken_embed/users/{user_id}/transactions`

Get transaction history for a user's portfolio with filtering and pagination options.

## Path parameters

- `user_id` string, required — The ID of the Privy user.

## 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[]
  - `ref_id` string, required
  - `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.

## Headers

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

## Response `200`

Transaction history retrieved successfully.

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

---

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