Get orders

REQUEST wss://ws.bitvavo.com/v2 privateGetOrders

Returns information about multiple orders.

info

Authentication required. To send messages, you need to authenticate connection.

Rate limit weight points: 5

Request

Schema

Body

actionstring

Set value to privateGetOrders.

Example: privateGetOrders

requestIdinteger

Your identifier for the request.

Example: 1

marketstringrequired

The market for which to return the orders.

Example: BTC-EUR

limitinteger

The maximum number of orders to return.

Possible values: >= 1 and <= 1000

Default value: 500

startinteger

The Unix timestamp in milliseconds starting from which to return orders.

Example: 1751541801000

endinteger

The Unix timestamp in milliseconds until which to return orders.


Cannot be more than 24 hours after the start timestamp.

Example: 1751548920000

orderIdstring<UUID>deprecated

Deprecated: orderId is interpreted as orderIdTo. If used, returns all orders up to this orderId.

orderIdFromstring<UUID>

The unique identifier of the order starting from which to return the trades.

orderIdTostring<UUID>

The unique identifier of the order up to which to return the trades.

Example (body)

{
  "action": "privateGetOrders",
  "requestId": 1,
  "market": "BTC-EUR",
  "limit": 500,
  "start": 1751541801000,
  "end": 1751548920000,
  "orderId": "string",
  "orderIdFrom": "string",
  "orderIdTo": "string"
}

Response

Schema

Schema

actionstring
The action performed.
requestIdinteger
Your identifier for the request.
Example: 1
response object
orderIdstring<UUID>
Bitvavo identifier of the order. An orderId is unique per market. Different markets can use the same orderId values.
Example: 1be6d0df-d5dc-4b53-a250-3376f3b393e6
clientOrderIdstring<UUID>
Your identifier of the order. Only returned if specified in the request.
Example: 2be7d0df-d8dc-7b93-a550-8876f3b393e9
marketstring
The market where you created an order.
Example: BTC-EUR
createdinteger
The Unix timestamp in milliseconds when the order was created.
Example: 1706100650751
updatedinteger
The Unix timestamp in milliseconds when the order was last updated.
Example: 1706100650751
statusstring
The status of an order. Possible values:
• new: the orderId has been added to the order book and has not been filled.
• awaitingTrigger: the conditions to fill an order haven't been met.
• canceled: the orderId has been removed from the order book.
• expired: the market order expires because there is no match, enough liquidity in the order book, or enough balance in your account.
• filled: all trades necessary to complete the order have been filled.
• partiallyFilled: the order is still active. Bitvavo needs to receive more matching orders to completely fill the order.
Possible values: [new, awaitingTrigger, canceled, expired, filled, partiallyFilled]
sidestring
Indicates whether the order is to buy or sell the asset.
Possible values: [buy, sell]
orderTypestring
The type of order you created.
Possible values: [limit, market]
amountstring
The quantity of the base currency to buy or sell. If you set amountQuote in your order, amount is not returned.
Example: 10
amountRemainingstring
The quantity of the base currency remaining after the sum of fills is subtracted from the amount. If you set amountQuote in your order, amountRemaining is not returned.
Example: 10
pricestring
The price you set for a limit, stopLossLimit, takeProfit, or a takeProfitLimit order. For other types of orders, the price is not returned.
Example: 7000
amountQuotestring
The quantity of the quote currency to buy or sell for the market, stopLoss, or takeProfit types of order. If you set amount in your order, amountQuote is not returned.
Example: 5000
amountQuoteRemainingstring
The quantity of the quote currency remaining after the sum of all fills is subtracted from amountQuote.
If you set amount in the order, amountQuoteRemaining is not returned.
Example: 5000
onHoldstring
The amount of onHoldCurrency locked while an order is not yet settled after an order is filled. All funds are released when order is filled.
Example: 9109.61
onHoldCurrencystring
The currency that is onHold while the order is processed. This depends on the side you set for the orderId.
Example: BTC
triggerPricestring
The price calculated using triggerAmount and triggerType for the stopLoss, stopLossLimit, takeProfit, or takeProfitLimit types of orders.
For example, when you set triggerAmount to 4000 and triggerType to price, your order is placed in a market when the triggerReference price in quote currency reaches 4000.
Example: 4000
triggerAmountstring
The trigger price in quote currency for which you want to buy or sell 1 unit of the base currency.
This value and triggerType are used to calculate triggerPrice.
Example: 4000
triggerTypestring
The type of trigger you set to fill the order when the condition is met. This value and triggerAmount are used to calculate triggerPrice.
Possible values: [price]
triggerReferencestring
The price you set to trigger the order to be filled for the stopLoss, stopLossLimit, takeProfit, or takeProfitLimit types of orders.
Possible values: [lastTrade, bestBid, bestAsk, midPrice]
filledAmountstring
The total amount bought or sold in base currency.
Example: 0
filledAmountQuotestring
The total amount bought or sold in quote currency.
Example: 0
feePaidstring
The amount you pay Bitvavo to process the order. This value is negative for rebates. For more information, see GET /account/fees.
Example: 0
feeCurrencystring
The currency of the feePaid.
Example: EUR
fills object[]
A JSON object containing all fills for orderId.
Array [
idstring
The identifier of this fill.
Example: 371c6bd3-d06d-4573-9f15-18697cd210e5
timestampinteger
The Unix timestamp in milliseconds when Bitvavo processed the fill.
Example: 1542967486256
amountstring
The amount of base currency exchanged in the fill.
Example: 0.005
pricestring
The price of the fill in quote currency.
Example: 5000.1
takerboolean
Returns true when you are the taker for the fill.
Example: true
feestring
The amount you pay Bitvavo in feeCurrency to process the fill. For more information about your fees, see GET /account/fees. This value is negative for rebates.
If settled is false, this parameter is not included in the return parameters.
Example: 0.03
feeCurrencystring
The currency that the fee is paid in.
If settled is false, this object is not returned.
Example: EUR
settledboolean
On Bitvavo, trade settlement happens after an order is filled. When the fill is complete and the fee is not yet paid, settled is false.
]
selfTradePreventionstring
Self-trading is not allowed on Bitvavo.
Indicates how to prevent self-trading for conflicting orders of any type.
Possible values:
• decrementAndCancel: (default) decreases the amount in the conflicting order by the difference between the buy and sell orders in the same market. Cancels the lower order. For example, if a sell order is for 500 BTC and a buy order is for 300 BTC, it cancels the buy order and adjusts the sell order to 200 BTC.
• cancelOldest: cancels the older conflicting order in the same market.
• cancelNewest: cancels the later conflicting order in the same market.
• cancelBoth: cancels both conflicting orders in the same market.
Possible values: [decrementAndCancel, cancelOldest, cancelNewest, cancelBoth]
visibleboolean
Returns true when the orderId is visible in the order book for a market.
timeInForcestring
The value you set for how long an order stays active.
Possible values: [GTC, IOC, FOK]
postOnlyboolean
If true, cancels limit orders that match immediately. This ensures you pay the maker fee and not the taker fee.
disableMarketProtectionbooleandeprecated
Must be false because market protection can no longer be disabled.
operatorIdinteger<int64>
Your identifier for the trader or the bot within your account.
Example: 543462
restatementReasonstring
Specifies the reason why the status of the order was changed. For example, when an order is canceled by the Price protection checks.
Possible values: [decrementOnSelfTradePrevention, cancelOnSelfTradePrevention, cancelOnPlacementPriceProtection, cancelOnExecutionPriceProtection, cancelOnSpreadProtection, cancelOnReferencePriceProtection, cancelPostOnlyOnAuctionMatching, cancelOnMaintenance, cancelOnDisconnect, cancelOnDelisting, cancelOnLockPlaced, cancelOnAdminRequest, cancelPostOnly]
createdNsinteger
The Unix timestamp in nanoseconds when the order was created.
Example: 1752139200000000000
updatedNsinteger
The Unix timestamp in nanoseconds when the order was last updated.
Example: 1752139200000000000
codGroupIdinteger
Your identifier for a group of orders.
Example: 1

Example (body)

{
  "action": "string",
  "requestId": 1,
  "response": {
    "orderId": "1be6d0df-d5dc-4b53-a250-3376f3b393e6",
    "clientOrderId": "2be7d0df-d8dc-7b93-a550-8876f3b393e9",
    "market": "BTC-EUR",
    "created": 1706100650751,
    "updated": 1706100650751,
    "status": "new",
    "side": "buy",
    "orderType": "limit",
    "amount": "10",
    "amountRemaining": "10",
    "price": "7000",
    "amountQuote": "5000",
    "amountQuoteRemaining": "5000",
    "onHold": "9109.61",
    "onHoldCurrency": "BTC",
    "triggerPrice": "4000",
    "triggerAmount": "4000",
    "triggerType": "price",
    "triggerReference": "lastTrade",
    "filledAmount": "0",
    "filledAmountQuote": "0",
    "feePaid": "0",
    "feeCurrency": "EUR",
    "fills": [
      {
        "id": "371c6bd3-d06d-4573-9f15-18697cd210e5",
        "timestamp": 1542967486256,
        "amount": "0.005",
        "price": "5000.1",
        "taker": true,
        "fee": "0.03",
        "feeCurrency": "EUR",
        "settled": false
      }
    ],
    "selfTradePrevention": "decrementAndCancel",
    "visible": false,
    "timeInForce": "GTC",
    "postOnly": false,
    "disableMarketProtection": false,
    "operatorId": 543462,
    "restatementReason": "decrementOnSelfTradePrevention",
    "createdNs": 1752139200000000000,
    "updatedNs": 1752139200000000000,
    "codGroupId": 1
  }
}