Own Trades

Subscribe to real-time trade execution updates for the authenticated user

WSSws-auth.kraken.comownTrades

The ownTrades channel streams executions for the authenticated user. A snapshot of the last 50 trades is sent on subscription, followed by real-time updates for any new trades.

Subscribe

Request

event · string · required

Value: subscribe

subscription · object

Hide properties

name · string · required

Value: ownTrades

token · string · required

Session token from the GetWebSocketsToken REST endpoint.

snapshot · boolean

One of: false, true
Default: true

Includes initial snapshot of historical data.

consolidate_taker · boolean

One of: false, true
Default: true

If true, fills are consolidated by taker, otherwise all fills are shown.

rebased · boolean

One of: true, false
Default: true
Condition: Effective for viewing xstocks only

If true, display in terms of underlying equity, otherwise display in terms of SPV tokens.

reqid · string

Optional client originated request identifier sent as acknowledgment in the response.

Response

The subscription status is returned via the subscriptionStatus message.

Snapshot / Update

The snapshot and update responses share the same schema. The payload is a JSON array containing the trade data, the channel name, and feed detail.

[0] · object[]

A list of trade objects. Each object is keyed by the Kraken trade identifier.

Hide properties

<trade-id> · object

The key for each trade is the Kraken trade identifier.

Show properties

ordertxid · string

Order identifier.

postxid · integer

Position identifier.

pair · string

Asset pair.

time · string

Unix timestamp of trade.

type · string

Side of order (buy/sell).

ordertype · string

Order type.

price · string

Average price order was filled in quote currency.

cost · string

Total cost of order in the quote currency.

fee · string

Total fees in the quote currency.

vol · string

Volume of the trade in base currency.

margin · string

Initial margin (quote currency).

margin_borrow · boolean

Indicates if an execution is on margin, i.e. if the trade increased or reduced size of margin borrowing. On trade events only.

cl_ord_id · string

An optional, alphanumeric client identifier associated with this order. Available on update messages only.

ext_exec_id · string

Format: UUID

An optional, external partner execution identifier.

userref · integer

An optional, numeric identifier associated with one or more orders. Available on update messages only.

[1] · string

Value: ownTrades

[2] · object

Show properties

sequence · integer

Sequence number for this subscription.