@upbit-official/upbit-sdk 0.9.0

package/src/resources/orders.ts

@@ -0,0 +1,1102 @@
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PageNumberPage, type PageNumberPageParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+
+export class Orders extends APIResource {
+  /**
+   * Create Order
+   *
+   * POST /v1/orders
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/new-order
+   * - docs(global): https://global-docs.upbit.com/reference/new-order
+   *
+   * Order parameter rules by `ord_type`:
+   *
+   * - `limit`: requires both `price` and `volume`. Optional: `time_in_force` (`ioc`,
+   *   `fok`, `post_only`) and `smp_type`. Note: `post_only` cannot be used with
+   *   `smp_type`.
+   *
+   * - `price` (market buy): requires `price`, and `volume` must be omitted.
+   *
+   * - `market` (market sell): requires `volume`, and `price` must be omitted.
+   *
+   * - `best`: `time_in_force` is required (`ioc` or `fok`).
+   *   - `side=bid`: requires `price`, and `volume` must be omitted.
+   *   - `side=ask`: requires `volume`, and `price` must be omitted.
+   *
+   * @example
+   * ```ts
+   * const order = await client.orders.create({
+   *   market: 'KRW-BTC',
+   *   ord_type: 'limit',
+   *   side: 'bid',
+   *   price: '14000000',
+   *   volume: '1',
+   * });
+   * ```
+   */
+  create(body: OrderCreateParams, options?: RequestOptions): APIPromise<Order> {
+    return this._client.post('/v1/orders', { body, ...options });
+  }
+
+  /**
+   * Get Order
+   *
+   * GET /v1/order
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/get-order
+   * - docs(global): https://global-docs.upbit.com/reference/get-order
+   *
+   * **Required (one of):** `uuid` or `identifier` must be provided.
+   *
+   * @example
+   * ```ts
+   * const order = await client.orders.retrieve();
+   * ```
+   */
+  retrieve(query: OrderRetrieveParams | null | undefined = {}, options?: RequestOptions): APIPromise<Order> {
+    return this._client.get('/v1/order', { query, ...options });
+  }
+
+  /**
+   * Cancel Order
+   *
+   * DELETE /v1/order
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/cancel-order
+   * - docs(global): https://global-docs.upbit.com/reference/cancel-order
+   *
+   * **Required (one of):** `uuid` or `identifier` must be provided.
+   *
+   * @example
+   * ```ts
+   * const order = await client.orders.cancel();
+   * ```
+   */
+  cancel(params: OrderCancelParams | null | undefined = {}, options?: RequestOptions): APIPromise<Order> {
+    const { identifier, uuid } = params ?? {};
+    return this._client.delete('/v1/order', { query: { identifier, uuid }, ...options });
+  }
+
+  /**
+   * Cancel and New Order
+   *
+   * POST /v1/orders/cancel_and_new
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/cancel-and-new-order
+   * - docs(global): https://global-docs.upbit.com/reference/cancel-and-new-order
+   *
+   * @example
+   * ```ts
+   * const order = await client.orders.cancelAndNew({
+   *   new_ord_type: 'limit',
+   *   new_price: '100000000',
+   *   prev_order_uuid: 'ad217e24-ed02-469c-9b30-c08dbbda6908',
+   * });
+   * ```
+   */
+  cancelAndNew(body: OrderCancelAndNewParams, options?: RequestOptions): APIPromise<Order> {
+    return this._client.post('/v1/orders/cancel_and_new', { body, ...options });
+  }
+
+  /**
+   * Cancel Orders by IDs
+   *
+   * DELETE /v1/orders/uuids
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/cancel-orders-by-ids
+   * - docs(global): https://global-docs.upbit.com/reference/cancel-orders-by-ids
+   *
+   * **Required (one of):** `uuids` or `identifiers` must be provided.
+   *
+   * @example
+   * ```ts
+   * const batchCancelResult =
+   *   await client.orders.cancelByUuids();
+   * ```
+   */
+  cancelByUuids(
+    params: OrderCancelByUuidsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BatchCancelResult> {
+    const { identifiers, uuids } = params ?? {};
+    return this._client.delete('/v1/orders/uuids', { query: { identifiers, uuids }, ...options });
+  }
+
+  /**
+   * Batch Cancel Orders
+   *
+   * DELETE /v1/orders/open
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/batch-cancel-orders
+   * - docs(global): https://global-docs.upbit.com/reference/batch-cancel-orders
+   *
+   * @example
+   * ```ts
+   * const batchCancelResult = await client.orders.cancelOpen();
+   * ```
+   */
+  cancelOpen(
+    params: OrderCancelOpenParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BatchCancelResult> {
+    const { cancel_side, count, excluded_pairs, order_by, pairs, quote_currencies } = params ?? {};
+    return this._client.delete('/v1/orders/open', {
+      query: { cancel_side, count, excluded_pairs, order_by, pairs, quote_currencies },
+      ...options,
+    });
+  }
+
+  /**
+   * List Orders by IDs
+   *
+   * GET /v1/orders/uuids
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/list-orders-by-ids
+   * - docs(global): https://global-docs.upbit.com/reference/list-orders-by-ids
+   *
+   * **Required (one of):** `uuids` or `identifiers` must be provided.
+   *
+   * @example
+   * ```ts
+   * const orders = await client.orders.listByUuids();
+   * ```
+   */
+  listByUuids(
+    query: OrderListByUuidsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<OrderListByUuidsResponse> {
+    return this._client.get('/v1/orders/uuids', { query, ...options });
+  }
+
+  /**
+   * List Closed Orders
+   *
+   * GET /v1/orders/closed
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/list-closed-orders
+   * - docs(global): https://global-docs.upbit.com/reference/list-closed-orders
+   *
+   * @example
+   * ```ts
+   * const orders = await client.orders.listClosed();
+   * ```
+   */
+  listClosed(
+    query: OrderListClosedParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<OrderListClosedResponse> {
+    return this._client.get('/v1/orders/closed', { query, ...options });
+  }
+
+  /**
+   * List Open Orders
+   *
+   * GET /v1/orders/open
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/list-open-orders
+   * - docs(global): https://global-docs.upbit.com/reference/list-open-orders
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const order of client.orders.listOpen()) {
+   *   // ...
+   * }
+   * ```
+   */
+  listOpen(
+    query: OrderListOpenParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<OrdersPageNumberPage, Order> {
+    return this._client.getAPIList('/v1/orders/open', PageNumberPage<Order>, { query, ...options });
+  }
+
+  /**
+   * Get Available Order Info
+   *
+   * GET /v1/orders/chance
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/available-order-information
+   * - docs(global):
+   *   https://global-docs.upbit.com/reference/available-order-information
+   *
+   * @example
+   * ```ts
+   * const response = await client.orders.retrieveChance({
+   *   market: 'KRW-BTC',
+   * });
+   * ```
+   */
+  retrieveChance(
+    query: OrderRetrieveChanceParams,
+    options?: RequestOptions,
+  ): APIPromise<OrderRetrieveChanceResponse> {
+    return this._client.get('/v1/orders/chance', { query, ...options });
+  }
+
+  /**
+   * Test Order Creation
+   *
+   * POST /v1/orders/test
+   *
+   * - docs(kr): https://docs.upbit.com/kr/reference/test-order
+   * - docs(global): https://global-docs.upbit.com/reference/test-order
+   *
+   * Order parameter rules by `ord_type`:
+   *
+   * - `limit`: requires both `price` and `volume`. Optional: `time_in_force` (`ioc`,
+   *   `fok`, `post_only`) and `smp_type`. Note: `post_only` cannot be used with
+   *   `smp_type`.
+   *
+   * - `price` (market buy): requires `price`, and `volume` must be omitted.
+   *
+   * - `market` (market sell): requires `volume`, and `price` must be omitted.
+   *
+   * - `best`: `time_in_force` is required (`ioc` or `fok`).
+   *   - `side=bid`: requires `price`, and `volume` must be omitted.
+   *   - `side=ask`: requires `volume`, and `price` must be omitted.
+   *
+   * @example
+   * ```ts
+   * const order = await client.orders.testCreate({
+   *   market: 'KRW-BTC',
+   *   side: 'bid',
+   *   ord_type: 'limit',
+   *   price: '14000000',
+   *   volume: '1',
+   * });
+   * ```
+   */
+  testCreate(body: OrderTestCreateParams, options?: RequestOptions): APIPromise<Order> {
+    return this._client.post('/v1/orders/test', { body, ...options });
+  }
+}
+
+export type OrdersPageNumberPage = PageNumberPage<Order>;
+
+export interface BatchCancelResult {
+  /**
+   * Information about orders that failed to cancel.
+   */
+  failed: BatchCancelResult.Failed;
+
+  /**
+   * Information about successfully cancelled orders.
+   */
+  success: BatchCancelResult.Success;
+}
+
+export namespace BatchCancelResult {
+  /**
+   * Information about orders that failed to cancel.
+   */
+  export interface Failed {
+    /**
+     * Number of orders that failed to cancel.
+     */
+    count: number;
+
+    /**
+     * List of orders that failed to cancel.
+     */
+    orders: Array<Failed.Order>;
+  }
+
+  export namespace Failed {
+    export interface Order {
+      /**
+       * Trading pair code.
+       */
+      market: string;
+
+      /**
+       * Unique identifier of the order.
+       */
+      uuid: string;
+
+      /**
+       * Client-assigned order identifier.
+       *
+       * - Only available for orders created after October 18, 2024.
+       */
+      identifier?: string;
+    }
+  }
+
+  /**
+   * Information about successfully cancelled orders.
+   */
+  export interface Success {
+    /**
+     * Number of successfully cancelled orders.
+     */
+    count: number;
+
+    /**
+     * List of successfully cancelled orders.
+     */
+    orders: Array<Success.Order>;
+  }
+
+  export namespace Success {
+    export interface Order {
+      /**
+       * Trading pair code.
+       */
+      market: string;
+
+      /**
+       * Unique identifier of the order.
+       */
+      uuid: string;
+
+      /**
+       * Client-assigned order identifier.
+       *
+       * - Only available for orders created after October 18, 2024.
+       */
+      identifier?: string;
+    }
+  }
+}
+
+/**
+ * Closed order state
+ */
+export type ClosedOrderState = 'done' | 'cancel';
+
+/**
+ * Open order state
+ */
+export type OpenOrderState = 'wait' | 'watch';
+
+/**
+ * Order type
+ */
+export type OrdTypeEnum = 'limit' | 'price' | 'market' | 'best';
+
+export interface Order {
+  /**
+   * Timestamp when the order was created.
+   *
+   * [Format] yyyy-MM-ddTHH:mm:ss+00:00
+   */
+  created_at: string;
+
+  /**
+   * Executed volume.
+   */
+  executed_volume: string;
+
+  /**
+   * Amount locked for this order.
+   */
+  locked: string;
+
+  /**
+   * Trading pair code.
+   */
+  market: string;
+
+  /**
+   * Order type.
+   */
+  ord_type: 'limit' | 'price' | 'market' | 'best';
+
+  /**
+   * Fee paid so far.
+   */
+  paid_fee: string;
+
+  /**
+   * Asset unlocked due to Self-Match Prevention cancellation.
+   *
+   * - For buy orders: cancelled amount
+   * - For sell orders: cancelled volume
+   */
+  prevented_locked: string;
+
+  /**
+   * Volume cancelled due to Self-Match Prevention.
+   */
+  prevented_volume: string;
+
+  /**
+   * Remaining fee.
+   */
+  remaining_fee: string;
+
+  /**
+   * Remaining volume after execution.
+   */
+  remaining_volume: string;
+
+  /**
+   * Fee reserved for this order.
+   */
+  reserved_fee: string;
+
+  /**
+   * Order direction (ask=sell, bid=buy).
+   */
+  side: 'ask' | 'bid';
+
+  /**
+   * Order state.
+   *
+   * - `wait`: Pending execution
+   * - `watch`: Waiting for reservation order
+   * - `done`: Fully executed
+   * - `cancel`: Cancelled
+   */
+  state: 'wait' | 'watch' | 'done' | 'cancel';
+
+  /**
+   * Number of trades executed for this order.
+   */
+  trades_count: number;
+
+  /**
+   * Unique identifier of the order.
+   */
+  uuid: string;
+
+  /**
+   * Client-assigned order identifier specified at order creation.
+   *
+   * - The identifier field is only available for orders created after October
+   *   18, 2024.
+   */
+  identifier?: string;
+
+  /**
+   * Order price or total amount. For limit orders, this is the unit price. For
+   * market buy orders, this is the total buy amount.
+   */
+  price?: string;
+
+  /**
+   * Self-Match Prevention (SMP) mode.
+   */
+  smp_type?: 'reduce' | 'cancel_maker' | 'cancel_taker';
+
+  /**
+   * Time in force condition.
+   */
+  time_in_force?: 'fok' | 'ioc' | 'post_only';
+
+  /**
+   * List of trades executed for this order (returned in individual order query).
+   */
+  trades?: Array<Order.Trade>;
+
+  /**
+   * Requested order volume.
+   */
+  volume?: string;
+}
+
+export namespace Order {
+  export interface Trade {
+    /**
+     * Timestamp of the trade.
+     */
+    created_at?: string;
+
+    /**
+     * Trade funds (price × volume).
+     */
+    funds?: string;
+
+    /**
+     * Trading pair code.
+     */
+    market?: string;
+
+    /**
+     * Trade price.
+     */
+    price?: string;
+
+    /**
+     * Order side of the trade.
+     */
+    side?: string;
+
+    /**
+     * Price trend of the trade.
+     */
+    trend?: string;
+
+    /**
+     * Unique identifier of the trade.
+     */
+    uuid?: string;
+
+    /**
+     * Trade volume.
+     */
+    volume?: string;
+  }
+}
+
+/**
+ * Order direction (ask=sell, bid=buy)
+ */
+export type SideEnum = 'ask' | 'bid';
+
+/**
+ * Self-Match Prevention (SMP) mode
+ */
+export type SmpTypeEnum = 'cancel_maker' | 'cancel_taker' | 'reduce';
+
+/**
+ * Time in force condition
+ */
+export type TimeInForceEnum = 'fok' | 'ioc' | 'post_only';
+
+export type OrderListByUuidsResponse = Array<Order>;
+
+export type OrderListClosedResponse = Array<Order>;
+
+export interface OrderRetrieveChanceResponse {
+  /**
+   * Base asset account information.
+   */
+  ask_account: OrderRetrieveChanceResponse.AskAccount;
+
+  /**
+   * Fee rate applied when placing a sell order.
+   */
+  ask_fee: string;
+
+  /**
+   * Quote asset account information.
+   */
+  bid_account: OrderRetrieveChanceResponse.BidAccount;
+
+  /**
+   * Fee rate applied when placing a buy order.
+   */
+  bid_fee: string;
+
+  /**
+   * Maker fee rate for sell orders.
+   */
+  maker_ask_fee: string;
+
+  /**
+   * Maker fee rate for buy orders.
+   */
+  maker_bid_fee: string;
+
+  market: OrderRetrieveChanceResponse.Market;
+}
+
+export namespace OrderRetrieveChanceResponse {
+  /**
+   * Base asset account information.
+   */
+  export interface AskAccount {
+    /**
+     * Average buy price of the asset.
+     */
+    avg_buy_price: string;
+
+    /**
+     * Indicates whether the average buy price has been modified.
+     */
+    avg_buy_price_modified: boolean;
+
+    /**
+     * Available amount or volume for orders.
+     */
+    balance: string;
+
+    /**
+     * Currency code to be queried.
+     */
+    currency: string;
+
+    /**
+     * Amount or quantity locked by pending orders or withdrawals.
+     */
+    locked: string;
+
+    /**
+     * Currency unit used as the basis for avg_buy_price.
+     */
+    unit_currency?: string;
+  }
+
+  /**
+   * Quote asset account information.
+   */
+  export interface BidAccount {
+    /**
+     * Average buy price of the asset.
+     */
+    avg_buy_price: string;
+
+    /**
+     * Indicates whether the average buy price has been modified.
+     */
+    avg_buy_price_modified: boolean;
+
+    /**
+     * Available amount or volume for orders.
+     */
+    balance: string;
+
+    /**
+     * Currency code to be queried.
+     */
+    currency: string;
+
+    /**
+     * Amount or quantity locked by pending orders or withdrawals.
+     */
+    locked: string;
+
+    /**
+     * Currency unit used as the basis for avg_buy_price.
+     */
+    unit_currency?: string;
+  }
+
+  export interface Market {
+    /**
+     * Trading pair code.
+     */
+    id: string;
+
+    /**
+     * Sell order constraints.
+     */
+    ask: Market.Ask;
+
+    /**
+     * Supported sell order types.
+     *
+     * [Example] ["market", "limit", "best_fok", ...]
+     */
+    ask_types: Array<string>;
+
+    /**
+     * Buy order constraints.
+     */
+    bid: Market.Bid;
+
+    /**
+     * Supported buy order types.
+     *
+     * [Example] ["limit", "price", "best_fok", ...]
+     */
+    bid_types: Array<string>;
+
+    /**
+     * Maximum order amount.
+     */
+    max_total: string;
+
+    /**
+     * Trading pair name (base asset / quote currency).
+     */
+    name: string;
+
+    /**
+     * Supported order sides.
+     */
+    order_sides: Array<string>;
+
+    /**
+     * Market operation state.
+     */
+    state: 'active';
+  }
+
+  export namespace Market {
+    /**
+     * Sell order constraints.
+     */
+    export interface Ask {
+      /**
+       * Currency of the asset being sold.
+       *
+       * [Example] "BTC", "ETH"
+       */
+      currency: string;
+
+      /**
+       * Minimum order amount for sell orders (in quote currency).
+       */
+      min_total: string;
+    }
+
+    /**
+     * Buy order constraints.
+     */
+    export interface Bid {
+      /**
+       * Quote currency used to purchase digital assets (SGD, BTC, USDT).
+       */
+      currency: string;
+
+      /**
+       * Minimum order amount for buy orders (in quote currency).
+       */
+      min_total: string;
+    }
+  }
+}
+
+export interface OrderCreateParams {
+  /**
+   * Target trading pair for the order.
+   */
+  market: string;
+
+  /**
+   * Order type
+   */
+  ord_type: OrdTypeEnum;
+
+  /**
+   * Order direction (ask=sell, bid=buy)
+   */
+  side: SideEnum;
+
+  /**
+   * Client-assigned order identifier.
+   */
+  identifier?: string;
+
+  /**
+   * Order price or total amount.
+   */
+  price?: string;
+
+  /**
+   * Self-Match Prevention (SMP) mode
+   */
+  smp_type?: SmpTypeEnum;
+
+  /**
+   * Time in force condition
+   */
+  time_in_force?: TimeInForceEnum;
+
+  /**
+   * Order volume.
+   */
+  volume?: string;
+}
+
+export interface OrderRetrieveParams {
+  /**
+   * Client-assigned identifier of the order to query.
+   *
+   * Used when querying by the identifier assigned at order creation.
+   */
+  identifier?: string;
+
+  /**
+   * UUID of the order to query.
+   */
+  uuid?: string;
+}
+
+export interface OrderCancelParams {
+  /**
+   * Client-assigned identifier of the order to cancel.
+   *
+   * Used when cancelling by the identifier assigned at order creation.
+   */
+  identifier?: string;
+
+  /**
+   * UUID of the order to cancel.
+   */
+  uuid?: string;
+}
+
+export interface OrderCancelAndNewParams {
+  /**
+   * Order type
+   */
+  new_ord_type: OrdTypeEnum;
+
+  /**
+   * Client-assigned identifier for the new order.
+   */
+  new_identifier?: string;
+
+  /**
+   * Price or total amount for the new order.
+   */
+  new_price?: string;
+
+  /**
+   * Self-Match Prevention (SMP) mode
+   */
+  new_smp_type?: SmpTypeEnum;
+
+  /**
+   * Time in force condition
+   */
+  new_time_in_force?: TimeInForceEnum;
+
+  /**
+   * Volume for the new order.
+   */
+  new_volume?: string;
+
+  /**
+   * Client-assigned identifier of the order to cancel.
+   */
+  prev_order_identifier?: string;
+
+  /**
+   * UUID of the order to cancel.
+   */
+  prev_order_uuid?: string;
+}
+
+export interface OrderCancelByUuidsParams {
+  /**
+   * List of client-assigned identifiers of orders to cancel. Maximum 20 orders.
+   *
+   * [Example] identifiers[]=id1&identifiers[]=id2…
+   */
+  identifiers?: Array<string>;
+
+  /**
+   * List of UUIDs of orders to cancel. Maximum 20 orders.
+   *
+   * [Example] uuids[]=uuid1&uuids[]=uuid2…
+   */
+  uuids?: Array<string>;
+}
+
+export interface OrderCancelOpenParams {
+  /**
+   * Side filter. "all" (both), "ask" (sell only), "bid" (buy only).
+   */
+  cancel_side?: 'bid' | 'ask' | 'all';
+
+  /**
+   * Maximum number of orders to cancel. Max 300, default 20.
+   */
+  count?: number;
+
+  /**
+   * Trading pair exclusion filter. Cancels all open orders except those for the
+   * specified pairs. Up to 20 pairs, comma-separated.
+   *
+   * [Example] excluded_pairs=KRW-BTC,KRW-ETH
+   */
+  excluded_pairs?: string;
+
+  /**
+   * Sort order for determining which orders to cancel. "desc" (newest first) or
+   * "asc" (oldest first). Default is "desc".
+   */
+  order_by?: 'asc' | 'desc';
+
+  /**
+   * Trading pair filter. Cancels open orders only for the specified pairs. Up to 20
+   * pairs, comma-separated.
+   *
+   * [Example] pairs=KRW-BTC,KRW-ETH
+   */
+  pairs?: string;
+
+  /**
+   * Quote currency filter (KRW, BTC, USDT). Cancels all open orders in markets with
+   * the specified quote currency.
+   *
+   * [Example] "KRW" cancels all open orders in the KRW market.
+   */
+  quote_currencies?: string;
+}
+
+export interface OrderListByUuidsParams {
+  /**
+   * List of client-assigned identifiers of orders to query. Maximum 100 orders.
+   *
+   * [Example] identifiers[]=id1&identifiers[]=id2…
+   */
+  identifiers?: Array<string>;
+
+  /**
+   * Trading pair to filter by.
+   */
+  market?: string;
+
+  /**
+   * Sort order. "desc" (newest first) or "asc" (oldest first). Default is "desc".
+   */
+  order_by?: 'asc' | 'desc';
+
+  /**
+   * List of UUIDs of orders to query. Maximum 100 orders.
+   *
+   * [Example] uuids[]=uuid1&uuids[]=uuid2…
+   */
+  uuids?: Array<string>;
+}
+
+export interface OrderListClosedParams {
+  /**
+   * End time of the query range. Max range is 7 days.
+   *
+   * - If only "end_time" is given, the range is 7 days before it.
+   *
+   * Format: ISO 8601 (2025-06-24T13:56:53+09:00) or millisecond timestamp
+   * (1750741013000)
+   */
+  end_time?: string;
+
+  /**
+   * Number of results per request (default: 100, max: 1,000).
+   */
+  limit?: number;
+
+  /**
+   * Trading pair to filter by.
+   */
+  market?: string;
+
+  /**
+   * Sort order. "desc" (newest first) or "asc" (oldest first). Default is "desc".
+   */
+  order_by?: 'asc' | 'desc';
+
+  /**
+   * Start time of the query range. Max range is 7 days.
+   *
+   * - If only "start_time" is given, the range is 7 days after it.
+   * - If neither is given, the default is the past 7 days.
+   *
+   * Format: ISO 8601 (2025-06-24T13:56:53+09:00) or millisecond timestamp
+   * (1750741013000)
+   */
+  start_time?: string;
+
+  /**
+   * Closed order state
+   */
+  state?: ClosedOrderState;
+
+  /**
+   * Order state filter (array form). "done" or "cancel". Default returns all states.
+   *
+   * [Example] states[]=done&states[]=cancel
+   */
+  states?: Array<ClosedOrderState>;
+}
+
+export interface OrderListOpenParams extends PageNumberPageParams {
+  /**
+   * Trading pair to filter by.
+   */
+  market?: string;
+
+  /**
+   * Sort order. "desc" (newest first) or "asc" (oldest first). Default is "desc".
+   */
+  order_by?: 'asc' | 'desc';
+
+  /**
+   * Open order state
+   */
+  state?: OpenOrderState;
+
+  /**
+   * Order state filter (array form). "wait" or "watch". Default is ["wait"].
+   *
+   * [Example] states[]=wait&states[]=watch
+   */
+  states?: Array<OpenOrderState>;
+}
+
+export interface OrderRetrieveChanceParams {
+  /**
+   * Trading pair to query.
+   */
+  market: string;
+}
+
+export interface OrderTestCreateParams {
+  /**
+   * Target trading pair for the order.
+   */
+  market: string;
+
+  /**
+   * Order direction (ask=sell, bid=buy)
+   */
+  side: SideEnum;
+
+  /**
+   * Client-assigned order identifier.
+   */
+  identifier?: string;
+
+  /**
+   * Order type
+   */
+  ord_type?: OrdTypeEnum;
+
+  /**
+   * Order price or total amount.
+   */
+  price?: string;
+
+  /**
+   * Self-Match Prevention (SMP) mode
+   */
+  smp_type?: SmpTypeEnum;
+
+  /**
+   * Time in force condition
+   */
+  time_in_force?: TimeInForceEnum;
+
+  /**
+   * Order volume.
+   */
+  volume?: string;
+}
+
+export declare namespace Orders {
+  export {
+    type BatchCancelResult as BatchCancelResult,
+    type ClosedOrderState as ClosedOrderState,
+    type OpenOrderState as OpenOrderState,
+    type OrdTypeEnum as OrdTypeEnum,
+    type Order as Order,
+    type SideEnum as SideEnum,
+    type SmpTypeEnum as SmpTypeEnum,
+    type TimeInForceEnum as TimeInForceEnum,
+    type OrderListByUuidsResponse as OrderListByUuidsResponse,
+    type OrderListClosedResponse as OrderListClosedResponse,
+    type OrderRetrieveChanceResponse as OrderRetrieveChanceResponse,
+    type OrdersPageNumberPage as OrdersPageNumberPage,
+    type OrderCreateParams as OrderCreateParams,
+    type OrderRetrieveParams as OrderRetrieveParams,
+    type OrderCancelParams as OrderCancelParams,
+    type OrderCancelAndNewParams as OrderCancelAndNewParams,
+    type OrderCancelByUuidsParams as OrderCancelByUuidsParams,
+    type OrderCancelOpenParams as OrderCancelOpenParams,
+    type OrderListByUuidsParams as OrderListByUuidsParams,
+    type OrderListClosedParams as OrderListClosedParams,
+    type OrderListOpenParams as OrderListOpenParams,
+    type OrderRetrieveChanceParams as OrderRetrieveChanceParams,
+    type OrderTestCreateParams as OrderTestCreateParams,
+  };
+}