> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kraken.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Trades History
> Retrieve information about trades/fills. 50 results are returned at a time, the most recent by default.
* Unless otherwise stated, costs, fees, prices, and volumes are specified with the precision for the asset pair (`pair_decimals` and `lot_decimals`), not the individual assets' precision (`decimals`).
**API Key Permissions Required:** `Orders and trades - Query closed orders & trades`
## OpenAPI
````yaml /openapi/spot-rest.yaml post /private/TradesHistory
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/TradesHistory:
post:
tags:
- Account Data
summary: Get Trades History
description: >
Retrieve information about trades/fills. 50 results are returned at a
time, the most recent by default.
* Unless otherwise stated, costs, fees, prices, and volumes are
specified with the precision for the asset pair (`pair_decimals` and
`lot_decimals`), not the individual assets' precision (`decimals`).
**API Key Permissions Required:** `Orders and trades - Query closed
orders & trades`
operationId: getTradeHistory
requestBody:
$ref: '#/components/requestBodies/history'
responses:
'200':
description: Trade history retrieved.
content:
application/json:
schema:
$ref: '#/components/schemas/history-2'
example:
error: []
result:
trades:
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: 40274859
maker: true
TCWJEG-FL4SZ-3FKGH6:
ordertxid: OQCLML-BW3P3-BUCMWZ
postxid: TKH2SE-M7IF5-CFI7LT
pair: XXBTZUSD
time: 1688667769.6396
type: buy
ordertype: limit
price: '30010.00000'
cost: '300.10000'
fee: '0.00000'
vol: '0.01000000'
margin: '0.00000'
misc: ''
trade_id: 39482674
maker: true
components:
requestBodies:
history:
required: true
content:
application/json:
schema:
title: Get Trades History Request Body
required:
- nonce
type: object
properties:
nonce:
$ref: '#/components/schemas/nonce'
type:
description: Type of trade
type: string
default: all
enum:
- all
- any position
- closed position
- closing position
- no position
trades:
description: Whether or not to include trades related to position in output
type: boolean
default: false
start:
description: Starting unix timestamp or trade tx ID of results (exclusive)
type: integer
end:
description: Ending unix timestamp or trade tx ID of results (inclusive)
type: integer
ofs:
description: Result offset for pagination
type: integer
without_count:
description: >-
If true, does not retrieve count of ledger entries. Request
can be noticeably faster for users with many ledger entries as
this avoids an extra database query.
type: boolean
default: false
consolidate_taker:
description: >-
Whether or not to consolidate trades by individual taker
trades
type: boolean
default: true
ledgers:
description: >
Whether or not to include related ledger ids for given trade
Note that setting this to true will slow request
performance
type: boolean
default: false
rebase_multiplier:
$ref: '#/components/schemas/rebase_multiplier'
example:
nonce: 1695828490
type: all
trades: false
consolidate_taker: true
schemas:
history-2:
type: object
properties:
result:
$ref: '#/components/schemas/history'
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.
history:
title: TradeHistory
description: Trade History
type: object
properties:
count:
description: Amount of available trades matching criteria
type: integer
trades:
description: Trade info
type: object
additionalProperties:
$ref: '#/components/schemas/trade-2'
x-additionalPropertiesName: txid
error:
type: array
items:
description: Kraken API error
type: string
example: EGeneral:Invalid arguments
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
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
````