Get markets

REQUEST wss://ws-mdpro.bitvavo.com/v2 getMarkets

Returns the information about one or all markets on Bitvavo.

Rate limit weight points: 1

Request

Schema

Body

actionstring
Set value to getMarkets.
Example: getMarkets
requestIdinteger
Your identifier for the request.
Example: 1
marketstring
The market for which to return information.
Example: BTC-EUR

Example (body)

{
  "action": "getMarkets",
  "requestId": 1,
  "market": "BTC-EUR"
}

Response

Schema

Schema

Array [
actionstring
The action performed.
Example: getMarkets
requestIdinteger
Your identifier for the request.
Example: 1
response object
marketstring
The market for which you requested information.
Example: BTC-EUR
statusstring
The status of the market for which you requested information. To learn how markets in different statuses work, see Trading Rules.
Possible values: [trading, halted, auction, auctionMatching, cancelOnly]
Example: trading
basestring
The base currency of the specified market.
Example: BTC
quotestring
The quote currency of the specified market.
Example: EUR
pricePrecisionintegerdeprecated
The number of digits allowed in the price when the order was created.
Example: 5
minOrderInBaseAssetstring
The minimum amount of base currency for an order.
Example: 0.00006100
minOrderInQuoteAssetstring
The minimum amount of quote currency for an order.
Example: 5.00
maxOrderInBaseAssetstring
The maximum amount of base currency for an order.
Example: 1000000000.00000000
maxOrderInQuoteAssetstring
The maximum amount of quote currency for an order.
Example: 1000000000.00
quantityDecimalsinteger
The maximum number of decimals in the amount of an order.
Example: 8
notionalDecimalsinteger
The maximum number of decimals in the amountQuote of a market, stopLoss, or takeProfit order.
Example: 2
tickSizestring
The minimum price increment of the market.
Example: 0.00001
maxOpenOrdersinteger
The maximum number of open orders allowed in a market per account.
Example: 100
feeCategorystring
The fee category of the specified market.
Possible values: [A, B, C]
Example: A
orderTypesstring[]
The types of orders that can be placed in the specified market.
Possible values: [market, limit, stopLoss, stopLossLimit, takeProfit, takeProfitLimit]
Example: ["market","limit","stopLoss","stopLossLimit","takeProfit","takeProfitLimit"]
]

Example (body)

[
  {
    "action": "getMarkets",
    "requestId": 1,
    "response": {
      "market": "BTC-EUR",
      "status": "trading",
      "base": "BTC",
      "quote": "EUR",
      "pricePrecision": 5,
      "minOrderInBaseAsset": "0.00006100",
      "minOrderInQuoteAsset": "5.00",
      "maxOrderInBaseAsset": "1000000000.00000000",
      "maxOrderInQuoteAsset": "1000000000.00",
      "quantityDecimals": 8,
      "notionalDecimals": 2,
      "tickSize": "0.00001",
      "maxOpenOrders": 100,
      "feeCategory": "A",
      "orderTypes": [
        "market",
        "limit",
        "stopLoss",
        "stopLossLimit",
        "takeProfit",
        "takeProfitLimit"
      ]
    }
  }
]