Skip to main content

NewOrderSingle (35=D)

Creates a new order to buy or sell a digital asset on Bitvavo.

Rate limit weight points: 1

Structure

Requires:

Message body

Required column values:

  • Y = Required
  • N = Not required
  • C = Conditionally required (depends on another parameter)
TagNameTypeRequiredDescription
2422OrderRequestIDIntNYour unique identifier of the request.
60TransactTimeUTCTimestampYThe UTC timestamp in nanoseconds when the order was created. Must be in the format YYYYMMDD-HH:MM:SS.sssssssss, for example 20260115-10:05:54.794327000.
1AccountStringNThe unique identifier of the account.
If not specified, the SenderCompID is used.
55SymbolStringYThe market in which the order was created, for example BTC-EUR.
11ClOrdIDStringYYour identifier of the order. Must be a valid UUID, for example 1be6d0df-d5dc-4b53-a250-3376f3b393e6.
54SideCharYIndicates whether the order is to buy or sell the asset.
Can be:
  • 1: Buy
  • 2: Sell
40OrdTypeCharYThe type of order you create.
Can be:
  • 1: Market
  • 2: Limit
  • 3: Stop
  • 4: Stop Limit
38OrderQtyQtyCThe quantity of the base currency (for example BTC) to buy or sell.
Required if CashOrderQty is not provided.
152CashOrderQtyQtyCThe quantity of the quote currency (for example EUR) to buy or sell for the market, stop, or stop limit order types.
Required if OrderQty is not provided.
44PricePriceCThe price in quote currency.
Must be a multiple of the tickSize value for the market.
99StopPxPriceCThe trigger price in quote currency. Required for stop and stop limit orders.
1107TriggerPriceTypeCharCThe price which triggers the order to be filled.
Can be:
  • 1: Best Offer
  • 2: Last Trade
  • 3: Best Bid
  • 6: Best Mid
59TimeInForceCharNHow long an order stays active for.
Can be:
  • 1: Good Till Cancel (GTC)
  • 3: Immediate Or Cancel (IOC)
  • 4: Fill Or Kill (FOK)
18ExecInstMultipleCharValueNSet to 6 to mark the order as postOnly (adds liquidity to the order book).
2964SelfMatchPreventionInstructionCharNPrevents self-trading for conflicting orders.
Can be:
  • 1: Cancel aggressive (newest)
  • 2: Cancel passive (oldest)
  • 3:Cancel both
  • 4: Decrement and cancel (Custom Bitvavo value)
5002OperatorIDIntYCustom Bitvavo tag
Your identifier for the trader or the bot within your account that made the request.

See also