> ## Documentation Index > Fetch the complete documentation index at: https://kraken-sandbox.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get Closed Orders > Retrieve information about orders that have been closed (filled or cancelled). 50 results are returned at a time, the most recent by default. **Note:** If an order's tx ID is given for `start` or `end` time, the order's opening time (`opentm`) is used **API Key Permissions Required:** `Orders and trades - Query closed orders & trades` ## OpenAPI ````yaml /openapi/spot-rest.yaml post /private/ClosedOrders openapi: 3.0.0 info: title: REST API version: 1.1.0 description: '' servers: - url: https://api.kraken.com/0 description: Production Server security: - API-Key: [] API-Sign: [] tags: - name: Market Data - name: Account Data - name: Trading - name: Funding - name: Subaccounts description: >- Subaccounts are currently only available to institutional clients. Please contact your Account Manager for more details. - name: Earn description: > The earn API allows interacting with all of Kraken's yield generating products. It replaces the old `/staking` part of the API. The different available earn products are represented by earn strategies. This corresponds to the legacy `Staking/Assets`. `Stake`/`Unstake` are replaced by `Allocate`/`Deallocate`. ### Overview of the available endpoints under `/Earn`: - `Strategies` - list all earn strategies for which you are eligible or have a balance. - `Allocations` - lists the balance in your earn account for each strategy. Requires the `Query Funds` API key permission. - `Allocate`/`Deallocate` - allocate/deallocate to an earn strategy through an async operation. Requires the `Earn Funds` API key permission. - `AllocateStatus`/`DeallocateStatus` - verifies the state of the last allocation/deallocation. Requires the `Earn Funds` or `Query Funds` API key permission. ### Example usage: ### Determine which funds are earning rewards: 1. Call `Strategies` to obtain information about the relevant strategy. The `lock_type` field shows whether bonding/unbonding funds are earning yield. The relevant fields are `bonding_rewards`/`unbonding_rewards`. 2. Call `Allocations` for the relevant strategy. From the previous step, for strategies where bonding/unbonding does not earn yield, substract these balances from `amount_allocated.total` to determine which balances are currently earning. ### Get allocatable balance: Call `/0/private/BalanceEx`, subtract `hold_trading` amount. Remaining balance is available for allocation to a strategy. ### Geo restrictions: Some earn strategies are not available in all geographic regions. `Strategies` will return only strategies available to the caller. - name: Transparency paths: /private/ClosedOrders: post: tags: - Account Data summary: Get Closed Orders description: > Retrieve information about orders that have been closed (filled or cancelled). 50 results are returned at a time, the most recent by default. **Note:** If an order's tx ID is given for `start` or `end` time, the order's opening time (`opentm`) is used **API Key Permissions Required:** `Orders and trades - Query closed orders & trades` operationId: getClosedOrders requestBody: $ref: '#/components/requestBodies/closedOrders' responses: '200': description: Closed orders info retrieved. content: application/json: schema: $ref: '#/components/schemas/closed-2' example: error: [] result: closed: O37652-RJWRT-IMO74O: refid: None userref: 1 status: canceled reason: User requested opentm: 1688148493.7708 closetm: 1688148610.0482 starttm: 0 expiretm: 0 descr: pair: XBTGBP type: buy ordertype: stop-loss-limit price: '23667.0' price2: '0' leverage: none order: buy 0.00100000 XBTGBP @ limit 23667.0 close: '' vol: '0.00100000' vol_exec: '0.00000000' cost: '0.00000' fee: '0.00000' price: '0.00000' stopprice: '0.00000' limitprice: '0.00000' misc: '' oflags: fciq trigger: index O6YDQ5-LOMWU-37YKEE: refid: None userref: 36493663 status: canceled reason: User requested opentm: 1688148493.7708 closetm: 1688148610.0477 starttm: 0 expiretm: 0 descr: pair: XBTEUR type: buy ordertype: take-profit-limit price: '27743.0' price2: '0' leverage: none order: buy 0.00100000 XBTEUR @ limit 27743.0 close: '' vol: '0.00100000' vol_exec: '0.00000000' cost: '0.00000' fee: '0.00000' price: '0.00000' stopprice: '0.00000' limitprice: '0.00000' misc: '' oflags: fciq trigger: index count: 2 components: requestBodies: closedOrders: required: true content: application/json: schema: title: Get Closed Orders Request Body required: - nonce type: object properties: nonce: $ref: '#/components/schemas/nonce' trades: description: Whether or not to include trades related to position in output type: boolean default: false userref: description: Restrict results to given user reference type: integer format: int32 cl_ord_id: description: Restrict results to given client order id type: string start: description: Starting unix timestamp or order tx ID of results (exclusive) type: integer end: description: Ending unix timestamp or order tx ID of results (inclusive) type: integer ofs: description: Result offset for pagination type: integer closetime: description: Which time to use to search type: string enum: - open - close - both default: both consolidate_taker: description: >- Whether or not to consolidate trades by individual taker trades type: boolean default: true without_count: description: >- Whether or not to include page count in result (`true` is much faster for users with many closed orders) type: boolean default: false rebase_multiplier: $ref: '#/components/schemas/rebase_multiplier' example: nonce: 1234567 trades: true cl_ord_id: 9cc788d8-9c00-4b25-94d3-26d93603948d start: 1695728276 end: 1695828276 closetime: open schemas: closed-2: type: object properties: result: title: ClosedOrders description: Closed Orders type: object properties: closed: type: object additionalProperties: $ref: '#/components/schemas/closed' x-additionalPropertiesName: txid count: description: Amount of available order info matching criteria type: integer error: $ref: '#/components/schemas/error' nonce: description: Nonce used in construction of `API-Sign` header type: integer format: int64 rebase_multiplier: type: string enum: - rebased - base default: rebased nullable: true description: | Optional parameter for viewing xstocks data. - `rebased`: Display in terms of underlying equity. - `base`: Display in terms of SPV tokens. closed: title: txid description: Closed Order type: object properties: refid: description: Referral order transaction ID that created this order type: string nullable: true userref: description: >- Optional numeric, client identifier associated with one or more orders. type: integer nullable: true cl_ord_id: description: Optional alphanumeric, client identifier associated with the order. type: string nullable: true status: description: | Status of order * pending = order pending book entry * open = open order * closed = closed order * canceled = order canceled * expired = order expired type: string enum: - pending - open - closed - canceled - expired opentm: description: Unix timestamp of when order was placed type: number starttm: description: Unix timestamp of order start time (or 0 if not set) type: number expiretm: description: Unix timestamp of order end time (or 0 if not set) type: number descr: title: OrderDescription description: Order description info type: object properties: pair: description: Asset pair type: string type: description: Type of order (buy/sell) type: string enum: - buy - sell ordertype: description: | Order type type: string enum: - market - limit - iceberg - stop-loss - take-profit - trailing-stop - stop-loss-limit - take-profit-limit - trailing-stop-limit - settle-position price: description: primary price type: string price2: description: Secondary price type: string leverage: description: Amount of leverage type: string order: description: Order description type: string close: description: Conditional close order description (if conditional close set) type: string aclass: description: Asset class of the pair type: string time_in_force: description: | Time-in-force of the order: * `gtc` = good till cancelled * `ioc` = immediate or cancel * `gtd` = good till date * `fok` = fill or kill type: string enum: - gtc - ioc - gtd - fok vol: description: Volume of order (base currency) type: string vol_exec: description: Volume executed (base currency) type: string cost: description: Total cost (quote currency unless) type: string fee: description: Total fee (quote currency) type: string price: description: Average price (quote currency) type: string stopprice: description: Stop price (quote currency) type: string limitprice: description: >- Triggered limit price (quote currency, when limit based order type triggered) type: string trigger: description: > Price signal used to trigger "stop-loss" "take-profit" "stop-loss-limit" "take-profit-limit" orders. * `last` is the implied trigger if this field is not set. type: string enum: - last - index default: last margin: description: Indicates if the order is funded on margin. type: boolean misc: description: | Comma delimited list of miscellaneous info: * `stopped` triggered by stop price * `touched` triggered by touch price * `liquidated` liquidation * `partial` partial fill * `amended` order parameters modified type: string oflags: description: | Comma delimited list of order flags: * `post` post-only order (available when ordertype = limit) * `fcib` prefer fee in base currency (default if selling) * `fciq` prefer fee in quote currency (default if buying, mutually exclusive with `fcib`) * `nompp` disable [market price protection](https://support.kraken.com/hc/en-us/articles/201648183-Market-Price-Protection) for market orders * `viqc` order volumes expressed in quote currency. type: string trades: description: >- List of trade IDs related to order (if trades info requested and data available) type: array items: type: string sender_sub_id: description: >- For institutional accounts, identifies underlying sub-account/trader for Self Trade Prevention (STP). type: string nullable: true closetm: description: Unix timestamp of when order was closed type: number reason: description: Additional info on status (if any) type: string error: type: array items: description: Kraken API error type: string example: EGeneral:Invalid arguments securitySchemes: API-Key: type: apiKey description: The "API-Key" header should contain your API key. name: API-Key in: header API-Sign: type: apiKey description: >- Authenticated requests should be signed with the "API-Sign" header, using a signature generated with your private key, nonce, encoded payload, and URI path. name: API-Sign in: header ````