New Order Single

Authenticated channel. Connect to: wss://wss.prime.kraken.com/ws/v1

Command used to submit a new order either against any provided liquidity or an open RFQ. Results of this command will be visible in the ExecutionReport and Trade streams which will track the lifecycle of the order.

Request

Request Schema
Limit Example
SteadyPace Example
RFQ Example

number

required

Request ID.

string

required

Command type. Value: NewOrderSingle

array

required

Order data array.

Show properties

string

required

Symbol of the security to submit an order on (e.g. BTC-USD).

string

required

Unique Client Order ID for this request. Format: UUID

string

required

Side of the order. Possible values: Buy, Sell

string

required

Order quantity in units of Currency.

string

required

Order type. Possible values: Market, Limit, RFQ

string

Order limit price. Required when OrdType is Limit. Optional when OrdType is RFQ — include it only to validate against a limit price; if omitted, the order executes at the quoted price.

string

The currency that the quantity is specified in. If not specified, defaults to the base currency for the symbol.

string

required

Specifies how long the order remains in effect. Possible values: GoodTillCancel, FillAndKill, FillOrKill. RFQ orders are always executed as FillOrKill; you may omit this field and the platform applies that behavior.

string

Optional order strategy to use for algorithmic orders. Possible values: SteadyPace, StopLimit

string

Optional QuoteID to trade on. Must be specified when OrdType=RFQ.

string

Optional RFQID to trade on. Must be specified when OrdType=RFQ.

string

Optional allowed price slippage for Limit order placed against RFQ.

string

Transaction timestamp. Format: ISO-8601 UTC (e.g. 2019-02-13T05:17:32.000000Z)

object

Strategy-specific parameters. Required keys depend on Strategy — see Supported Order Strategies below. For SteadyPace, ClipSize and ClipInterval are required.

Use this for a standard resting limit order with no algorithmic strategy:

{
  "reqid": 12,
  "type": "NewOrderSingle",
  "data": [
    {
      "Symbol": "BTC-USD",
      "ClOrdID": "4d489920-15da-11ec-b5e7-7f4881f01b7d",
      "Side": "Buy",
      "TransactTime": "2021-09-15T04:06:28.530000Z",
      "OrderQty": "0.01",
      "OrdType": "Limit",
      "Price": "43000",
      "Currency": "BTC",
      "TimeInForce": "GoodTillCancel"
    }
  ]
}

When Strategy is SteadyPace, include the required clip parameters in Parameters. ErrorAction is optional and controls behavior when a clip fails.

{
  "reqid": 12,
  "type": "NewOrderSingle",
  "data": [
    {
      "Symbol": "BTC-USD",
      "ClOrdID": "4d489920-15da-11ec-b5e7-7f4881f01b7d",
      "Side": "Buy",
      "TransactTime": "2021-09-15T04:06:28.530000Z",
      "OrderQty": "0.01",
      "OrdType": "Limit",
      "Price": "43000",
      "Currency": "BTC",
      "TimeInForce": "GoodTillCancel",
      "Strategy": "SteadyPace",
      "Parameters": {
        "ClipSize": "0.001",
        "ClipInterval": "1m",
        "ErrorAction": "Pause"
      }
    }
  ]
}

Accept an open quote by sending NewOrderSingle with OrdType set to RFQ. Use QuoteID and RFQID from the latest Open update on the Quote stream. Price is optional — omit it to trade at the quoted price, or set it to enforce a limit.

{
  "reqid": 41,
  "type": "NewOrderSingle",
  "data": [
    {
      "Symbol": "BTC-USD",
      "ClOrdID": "4d489920-15da-11ec-b5e7-7f4881f01b7d",
      "Side": "Buy",
      "TransactTime": "2021-09-15T04:06:28.530000Z",
      "OrderQty": "0.30000000",
      "OrdType": "RFQ",
      "QuoteID": "20e240c5-9a82-4731-809e-91b3a2bf2f49",
      "RFQID": "8688ceab-ea67-416c-8ce1-9b63d6c0fe4e"
    }
  ]
}

Accepting a quote (RFQ)

To trade against an open RFQ:

Subscribe to Quote, Execution Report, and Trade.
Send a Quote Request and wait for QuoteStatus Open.
Send NewOrderSingle with OrdType RFQ, QuoteID and RFQID from the Open quote, matching Side/Symbol/OrderQty, and optional Price if you need limit validation. RFQ orders are always executed as FillOrKill — you may omit TimeInForce.
Monitor execution and trade streams for fill or reject. The quote moves to Filled when accepted.

Command requests do not return a direct ack; results arrive on the subscribed streams. Quotes expire at ValidUntilTime unless you accept them with NewOrderSingle or cancel the quote with Quote Cancel Request.

Supported Order Strategies

The Limit Example tab above omits Strategy entirely — suitable for a single resting limit order. Set Strategy when you need algorithmic execution; each strategy requires its own Parameters fields.

SteadyPace

A schedule-based algorithm that divides an order into suborders (clips) and submits them at equal, user-defined intervals. Required parameters:

Parameter	Type	Description
`ClipSize`	Qty	Quantity sent on each clip (must be less than total `OrderQty`).
`ClipInterval`	string	Interval between clips (e.g. `1m`, `30s`).

Optional parameters:

Parameter	Type	Description
`StartTime`	string	ISO-8601 UTC time when the schedule begins sending clips.
`EndTime`	string	ISO-8601 UTC expire time for the order.
`Variance`	decimal	Randomization factor applied to clip sizes.
`ErrorAction`	string	Behavior when a clip fails (e.g. `Pause`).

Omitting ClipSize or ClipInterval while Strategy is SteadyPace produces an incomplete request. Use the SteadyPace Example tab above for a copy-paste-ready payload.

StopLimit

This strategy will only place the order once the specified stop price has been met. Parameters:

TriggerPrice (Price, required): The price that must be met to trigger execution of the order.
EndTime (string, optional): Optional expire time for the order.

Connection

Subscription Management

Order Management

Market Data

Account

RFQ

Reference Data

Request

Accepting a quote (RFQ)

Supported Order Strategies

SteadyPace

StopLimit

​Request

​Accepting a quote (RFQ)

​Supported Order Strategies

​SteadyPace

​StopLimit

Request

Accepting a quote (RFQ)

Supported Order Strategies

SteadyPace

StopLimit