---
title: "List Custom Orders"
method: GET
path: "/v1/kraken_embed/custom_orders"
tags: ["Kraken Embed"]
---

# List Custom Orders

`GET /v1/kraken_embed/custom_orders`

Get a list of custom orders that were previously submitted.

## Query parameters

- `user_id` string, required — The ID of the Privy user.
- `statuses` string — Status filter. Possible values: active, paused, cancelled, completed.
- `cursor` string — Pagination cursor for fetching the next set of results.

## Headers

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

## Response `200`

List of custom orders.

- object
  - `data` KrakenEmbedListCustomOrdersResponse, required — Response body for listing custom orders.
    - `error` unknown[]
      - unknown
    - `errors` unknown[]
      - unknown
    - `result` KrakenEmbedListCustomOrdersResult, required — Result payload for list custom orders response.
      - `orders` KrakenEmbedCustomOrder[], required
        - `action` KrakenEmbedCustomOrderAction, required — Trade action for a custom order.
          - `amount` KrakenEmbedCustomOrderAmount, required — Asset amount for custom order actions.
            - `amount` string, required
            - `asset` string, required
            - `asset_class` 'currency'
          - `fee_bps` string, required
          - `quote` KrakenEmbedCustomOrderQuoteAsset, required — Target asset for the other side of the custom order trade.
            - `asset` string, required
          - `spread_bps` string, required
          - `type` 'receive' | 'spend', required — Whether the quote amount refers to the asset being received or spent.
        - `created_at` string, date-time, required
        - `id` string, required
        - `name` string, required
        - `status` KrakenEmbedCustomOrderStatus, required — Custom order status with optional reason for cancelled or paused states.
          - `reason` unknown
          - `status` 'active' | 'completed' | 'cancelled' | 'paused', required — The lifecycle state of a custom order.
        - `trigger` KrakenEmbedCustomOrderTrigger, required — Price trigger for a custom order. The order executes when base_asset/quote_asset rate meets the condition against target_price.
          - `base_asset` string, required
          - `condition` 'gte' | 'lte', required — Comparison operator for a custom order price trigger.
          - `quote_asset` string, required
          - `target_price` string, required
          - `type` 'price', required
        - `updated_at` string, date-time, required

## Changes

- **2026-06-09** `02e9839a74d4` — 2 info
  - removed `#/components/schemas/KrakenEmbedListCustomOrdersResult, subschema #2` from the `data/result` response property `allOf` list for the response status `200`
  - added `#/components/schemas/KrakenEmbedListCustomOrdersResult, subschema #2` to the `data/result` response property `anyOf` list for the response status `200`
- **2026-05-14** `44a41e66b2cf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/privy-io/apis/privy-api/changes/v1/kraken_embed/custom_orders/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-service-production.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)