---
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

---

[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)