> ## 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.
# Query Trades Info
> Retrieve information about specific trades/fills.
**API Key Permissions Required:** `Orders and trades - Query closed orders & trades`
## OpenAPI
````yaml /openapi/spot-rest.yaml post /private/QueryTrades
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/QueryTrades:
post:
tags:
- Account Data
summary: Query Trades Info
description: >
Retrieve information about specific trades/fills.
**API Key Permissions Required:** `Orders and trades - Query closed
orders & trades`
operationId: getTradesInfo
requestBody:
$ref: '#/components/requestBodies/query'
responses:
'200':
description: Trades info retrieved.
content:
application/json:
schema:
type: object
properties:
result:
description: Trade info
type: object
additionalProperties:
$ref: '#/components/schemas/trade-2'
error:
type: array
items:
$ref: '#/components/schemas/error'
example:
error: []
result:
THVRQM-33VKH-UCI7BS:
ordertxid: OQCLML-BW3P3-BUCMWZ
postxid: TKH2SE-M7IF5-CFI7LT
pair: XXBTZUSD
time: 1688667796.8802
type: buy
ordertype: limit
price: '30010.00000'
cost: '600.20000'
fee: '0.00000'
vol: '0.02000000'
margin: '0.00000'
misc: ''
trade_id: 93748276
maker: true
TTEUX3-HDAAA-RC2RUO:
ordertxid: OH76VO-UKWAD-PSBDX6
postxid: TKH2SE-M7IF5-CFI7LT
pair: XXBTZEUR
time: 1688082549.3138
type: buy
ordertype: limit
price: '27732.00000'
cost: '0.20020'
fee: '0.00000'
vol: '0.00020000'
margin: '0.00000'
misc: ''
trade_id: 74625834
maker: true
components:
requestBodies:
query:
required: true
content:
application/json:
schema:
title: Get Trades Info Request Body
required:
- nonce
- txid
type: object
properties:
nonce:
$ref: '#/components/schemas/nonce'
txid:
description: >-
Comma delimited list of transaction IDs to query info about
(20 maximum)
type: string
trades:
description: Whether or not to include trades related to position in output
type: boolean
default: false
rebase_multiplier:
$ref: '#/components/schemas/rebase_multiplier'
example:
nonce: 1695828490
txid: L2QE42-IGSZ3-WEVTLK, STMH53C-C54CG-4SO42I
trades: false
schemas:
trade-2:
title: Trade
description: Trade Info
type: object
properties:
ordertxid:
description: Order responsible for execution of trade
type: string
postxid:
description: Position responsible for execution of trade
type: string
pair:
description: Asset pair
type: string
time:
description: Unix timestamp of trade
type: number
type:
description: Type of order (buy/sell)
type: string
ordertype:
description: Order type
type: string
price:
description: Average price order was executed at (quote currency)
type: string
cost:
description: Total cost of order (quote currency)
type: string
fee:
description: Total fee (quote currency)
type: string
vol:
description: Volume (base currency)
type: string
margin:
description: Initial margin (quote currency)
type: string
leverage:
description: Amount of leverage used in trade
type: string
misc:
description: |
Comma delimited list of miscellaneous info:
* `closing` — Trade closes all or part of a position
type: string
ledgers:
description: |
List of ledger ids for entries associated with trade
type: array
items:
type: string
trade_id:
description: Unique identifier of trade executed
type: integer
maker:
description: >
`true` if trade was executed with user as the maker, `false` if
taker
type: boolean
aclass:
description: Asset class of the traded pair
type: string
tradeordertype:
description: >-
Order type of the trade (e.g. `market`, `limit`). May differ from
`ordertype` when the order type was converted on execution.
type: string
posstatus:
description: |
Position status (open/closed)
Only present if trade opened a position
type: string
cprice:
description: |
Average price of closed portion of position (quote currency)
Only present if trade opened a position
type: number
ccost:
description: |
Total cost of closed portion of position (quote currency)
Only present if trade opened a position
type: number
cfee:
description: |
Total fee of closed portion of position (quote currency)
Only present if trade opened a position
type: number
cvol:
description: |
Total fee of closed portion of position (quote currency)
Only present if trade opened a position
type: number
cmargin:
description: |
Total margin freed in closed portion of position (quote currency)
Only present if trade opened a position
type: number
net:
description: >
Net profit/loss of closed portion of position (quote currency, quote
currency scale)
Only present if trade opened a position
type: number
trades:
description: |
List of closing trades for position (if available)
Only present if trade opened a position
type: array
items:
type: string
error:
type: array
items:
description: Kraken API error
type: string
example: EGeneral:Invalid arguments
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.
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
````