v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Kraken Embed

Get Portfolio Transactions

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

get/v1/kraken_embed/users/{user_id}/transactions

Path parameters

user_idstring required

The ID of the Privy user.

Query parameters

cursorstring
typesKrakenEmbedTransactionType[]
page_sizeinteger
assetsstring[]
from_timestring date-time
until_timestring date-time
statusesKrakenEmbedTransactionStatus[]
idsstring[]
sorting'descending' | 'ascending'

Sort direction for paginated transaction lists.

quotestring
ref_idstring 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-idstring required

ID of your Privy app.

Response

Transaction history retrieved successfully.

Example response

{
  "data": {
    "result": {
      "next_cursor": "next_page_token_xyz",
      "stats": {
        "transactions_seen": 1
      },
      "transactions": [
        {
          "details": {
            "parent_transaction": null,
            "quote_id": "QTE-12345-ABCDE",
            "trade_type": "buy",
            "type": "simple_order"
          },
          "id": "TXN-12345",
          "receive": {
            "amount": {
              "amount": "0.00150000",
              "asset": "BTC",
              "asset_class": "currency"
            },
            "balance": {
              "amount": "0.00149850",
              "asset": "BTC",
              "asset_class": "currency"
            },
            "fee": {
              "amount": "0.00000150",
              "asset": "BTC",
              "asset_class": "currency"
            },
            "ledger_id": "LED-002",
            "quoted_amount": null,
            "quoted_fee": null,
            "quoted_total": null,
            "time": "2024-04-15T11:00:00Z",
            "total": {
              "amount": "0.00149850",
              "asset": "BTC",
              "asset_class": "currency"
            }
          },
          "ref_id": "REF-12345",
          "ref_id2": "QTE-12345-ABCDE",
          "spend": {
            "amount": {
              "amount": "100.00",
              "asset": "USD",
              "asset_class": "currency"
            },
            "balance": {
              "amount": "899.00",
              "asset": "USD",
              "asset_class": "currency"
            },
            "fee": {
              "amount": "1.00",
              "asset": "USD",
              "asset_class": "currency"
            },
            "ledger_id": "LED-001",
            "quoted_amount": null,
            "quoted_fee": null,
            "quoted_total": null,
            "time": "2024-04-15T11:00:00Z",
            "total": {
              "amount": "101.00",
              "asset": "USD",
              "asset_class": "currency"
            }
          },
          "status": "successful",
          "time": "2024-04-15T11:00:00Z",
          "type": "simple_order"
        }
      ]
    }
  }
}