22 October 2026
Endpoints for Corporate perps:
Brokerage endpoints let a partner place perps orders for their end-users and earn a fee per trade. After registering a subaccount with a fee rate and fee-receiving account, brokered orders deduct the fee from
the user's payment, trade with the rest, and settle the fee to the broker on fill.
-
/v1/perps/brokerage/registration- Registers a subaccount for brokered trading. -
/v1/perps/brokerage/registration- Returns the current brokerage terms for the called subaccount. -
/v1/perps/brokerage/instructions- Returns brokerage instructions (opens, increases, reduces) placed on behalf of the subaccount. -
/v1/perps/brokerage/orders- Places an order on behalf of an end-user from a registered brokerage subaccount. -
/v1/perps/brokerage/positions/reduce- Reduces an open brokered position by quantity, or closes it in full. -
/v1/perps/brokerage/registration- Removes the brokerage registration for the called subaccount.
21 October 2026
Borrowing Fee - A fee may be charged when a client borrows from VALR, the latest fee can be seen here
13 October 2026
Added an optional includeBorrowRates query parameter to the average lending rate endpoint. When set to true, each currency in the response includes an averageBorrowerRate field representing the average borrower-side rate over the requested window. Defaults to false, preserving existing behaviour for all current consumers.
/v1/loans/rates/history/average
1 October 2026
Add fiat withdrawal tracking
-
GET /v1/wallet/fiat/{currencyCode}/withdrawalsreturns a page of fiat withdrawals, filterable by status. -
GET /v1/wallet/fiat/{currencyCode}/withdrawals/{id}returns a single withdrawal with the bank account it was paid to. - New
FIAT_WITHDRAWAL_STATUS_UPDATEevent on theAccountWebSocket.
16 September 2026
The Perps v1 API provides access to perpetual futures trading and related account and market data. It supports position management and access to market data, positions, and trading history.
Endpoints for Perps:
- POST
/v1/perps/orders/simple- Allows users to open a new trade or increase an existing trade. - POST
/v1/perps/orders/tp-sl/add- Adds a take profit and/or a stop loss to an open position. - POST
/v1/perps/orders/tp-sl/modify- Changes the trigger price of an existing take profit or stop loss order. - POST
/v1/perps/orders/tp-sl/cancel- Cancel a take profit or stop loss. - POST
/v1/perps/positions/reduce- Reduce or Close a Position. - POST
/v1/perps/positions/margin/increase- Increase Position Margin. - POST
/v1/perps/terms/accept- Accept terms of service agreement. - GET
/v1/perps/positions- Returns your open positions. - GET
/v1/perps/orders- Returns your current resting orders. - GET
/v1/perps/positions/history- Returns closed and partially-reduced positions. - GET
/v1/perps/orders/history- Returns order history. - GET
/v1/perps/trade-history- Returns trade history (individual fills) over a time window. - GET
/v1/perps/funding-history- Returns funding charged or received on your positions. - GET
/v1/perps/pairs- Returns the trading rules for every enabled pair. - GET
/v1/perps/market-summary- Returns mark price, mid price, prior-day price, 24h volume, open interest, and funding per pair. - GET
/v1/perps/mark-prices- Returns mark price for pairs. - GET
/v1/perps/orderbook/:currencypair- Returns the top 5 levels of bids and asks for the pair. - GET
/v1/perps/status- Returns whether writes are currently accepted and the server's clock.
10 September 2026
Added an optional addBorrowExcludedCurrencies query parameter to the average lending rate endpoint. When set to true, currencies excluded from the simple borrow product (e.g. ZAR) are included in the response, useful for earn product use cases. Defaults to false, preserving existing behaviour for all current consumers.
/v1/loans/rates/history/average
17 August 2026
Added a new endpoint to retrieve the average lending rate for one or more currencies over a given time window, computed server-side, rather than requiring clients to page through (https://api.valr.com/v1/loans/rates/history) and average client-side.
/v1/loans/rates/history/average
10 July 2026
- Added a new xStock Terms endpoint that facilitates account-wide acceptance of xStock terms and conditions. Acceptance enables trading across all supported xStock trading pairs.
/v1/account/xstock-terms
18 May 2026
Add virtual accounts for fiat deposits
/v1/fiat/virtual-account/onboarding/v1/fiat/virtual-account/details/v1/fiat/virtual-account/transactions
04 May 2026
- Updated
Current API Key Infodescription to includeLink Bank Accountpermission - Removed Beta warning message for LIMIT Post Only Reprice
/v1/orders/limits
- Added ONE-TIME TOKEN (OTT) FOR THIRD-PARTY INTEGRATIONS to generate a One-Time Token (OTT) from your VALR account and provide it to a third-party service. The third party uses this token to request an API key by calling
POST /v1/partner/exchangewith the body{ "ottToken": "your-token-here" }. In response, they receive an API key and secret. The OTT is single-use and becomes invalid immediately after it is exchanged. /v1/partner/exchange- Addition of TWAP Feature
TWAP order — splits a large order into smaller sub-orders executed at regular intervals over a set duration.
New TWAP feature API Endpoints
-
POST
/v1/twap– Place a TWAP order. - GET /v1/twap/active – This API returns all active and pending trigger TWAP orders.
-
GET
/v1/twap/historic– This API returns all completed and cancelled TWAP orders. -
GET
/v1/twap/suborder/:currencyPair/:orderId/history– Returns the execution history of individual sub-orders for a specific TWAP order. Supports pagination and time filtering. -
GET
/v1/twap/:currencyPair/:orderId– Cancels the remaining suborders of an active/untriggered TWAP order.
21 April 2026
- The default limit for subaccounts is now 50. Please contact us at business@valr.com if you require a higher limit.
19 Mar 2026
- Whitelisted withdrawal address book now supports universal address book entries.
06 Mar 2026
- Market Orders now support 'FOK' and 'IOC' Time In Force options.
19 Feb 2026
Update support for withdrawal decimal places to reflect the actual decimal places that will be used for the on-chain transaction. Updates the following routes:
- /v1/public/currencies
- /v1/wallet/crypto/:currencyCode/withdraw
Previous behaviour: Withdrawals with arbitrarily scaled values were always truncated to 2 decimal places for stablecoins.
New behaviour: values that are specified during withdrawals will be used for the on-chain transaction. Values with a larger scale than withdrawDecimalPlaces will be rounded down to withdrawDecimalPlaces for the appropriate network configuration.
12 Feb 2026
Release Type: Feature Enhancement
- Spot trading now supports conditional orders using the following endpoints:
- /v1/orders/conditionals
- /v1/orders/conditionals/conditional/:currencyPair/orderid/:orderId
- /v1/orders/conditionals/:currencyPair/history
- /v1/orders/conditionals/modify
- /v1/orders/conditionals/:currencyPair
- /v1/orders/conditionals/conditional
These endpoints support OCO (One-Cancels-the-Other) and OTOCO (One-Triggers-One-Cancels-the-Other) order types. Users can submit take profit or stop loss conditions independently, with no requirement to include both in a single conditional order.
The existing Stop Limit routes will be deprecated in a future release in favour of these Conditional Order routes.
- Required Fields:
- "allowMargin"
- "side"
- "quantity"
- "triggerType"
- "pair"
- "stopLossTriggerPrice"
- "stopLossOrderPrice"
- "takeProfitTriggerPrice"
- "takeProfitOrderPrice"
- "customerOrderId"
Features:
Create, modify, query, and retrieve the history of Spot conditional orders.
Fully backward-compatible with existing Spot trading operations.
17 Nov 2025
-
Addition of Bundles Feature:
Bundles is a cryptocurrency investment feature that allows users to invest in pre-configured portfolios of multiple cryptocurrencies, providing a passive, index-style investment approach with diversified exposure. Bundles are pre-configured and rebalanced automatically based on parameters set by the fund manager (e.g., monthly).
New API Endpoints
-
POST
/v1/bundles/buy– Purchase a bundle on the primary market -
POST
/v1/bundles/sell– Sell a bundle on the primary market -
GET
/v1/bundles/transactions?bundleSymbol=– List primary market transactions for a specific bundle -
GET
/v1/bundles/all– Retrieve all bundles and their current market details
30 October 2025
- Users are now able to unsubscribe from these Account WebSocket events:
BALANCE_UPDATEOPEN_ORDERS_UPDATEMARGIN_INFO
12 August 2025
- Added suggestions for alternate methods on the public API description
24 July 2025
REST API Changes
- Update to GET route
GET /v1/positions/open, will now contain a new fieldleverageTierwhich indicates the leverage tier for each open position.
WebSocket Messages
- Update to the existing WS
OPEN_POSITION_UPDATE, will now contain a new fieldleverageTierwhich indicates the leverage tier for each open position. - New WS
PNL_RUN_COMPLETED, sent when a PNL (Profit and Loss) run is completed for subscribed currency pairs. - New WS
FUNDING_RUN_COMPLETED, sent when a funding run is completed for subscribed currency pairs. - New WS
LEVERAGE_UPDATED, while subscribed to this, the user will receive real time updates when the leverage is changed for a currency pair.
8 July 2025
- Added a new GET Price Buckets for a currency pair endpoint (
https://api.valr.com/v1/public/:currencyPair/buckets). This API provides historical market data aggregated into time-based "buckets" (candles) for a specified currency pair and bucket period. - Each bucket returned includes
open,high,low,close,volume, andquoteVolumefor the defined time interval. - The
periodSecondsquery parameter supports values of 60 (default), 300, 900, 1800, 3600, 21600, and 86400 (maximum). - Introduced an optional
includeEmptyquery parameter (defaulting tofalse) to include buckets where no trading activity occurred. For such buckets,open,high,low, andcloseprices will be identical (reflecting the last traded price), andvolumeandquoteVolumewill be zero.
3 July 2025
- Added detail about the automatic pruning of unauthenticated WebSocket connections.
29 May 2025
- Updated the documentation for the GET route
/v1/account/transactionhistory?skip=0&limit=100&transactionTypes=SIMPLE_BUY,LIMIT_BUY,MARKET_BUY¤cy=ZAR&startTime=2020-02-29T22:00:00.000Z&endTime=2021-04-30T21:59:59.999Zto include the following transaction types:FUNDFIAT_WITHDRAWAL_FEE_REVERSALCREDIT_CARD_DEPOSITSPOT_BORROW_INTEREST_CHARGESPOT_LEND_INTEREST_PAYMENTLIQUIDATION_LIMIT_BUYLIQUIDATION_LIMIT_SELLLIQUIDATION_TAKEOVER_ASSET_TRANSFERLIQUIDATION_TAKEOVER_DEBT_TRANSFERFUTURES_FUNDING_EARNEDFUTURES_FUNDING_PAIDFUTURES_PNL_PROFITFUTURES_PNL_LOSSFUTURES_TRADE_FEECOLLATERAL_CONVERSION_LIMIT_BUYCOLLATERAL_CONVERSION_LIMIT_SELL
- Added a GET and PUT route
/v1/margin/leverage/:currencypairto theFuturesfolder. This route already exist inMarginfolder and has been duplicated to theFuturesfolder for convenience.
20 May 2025
-
Modified the following routes to include
allowBorrow:/v1/account/subaccounts/transfer/v1/wallet/crypto/:currencyCode/withdraw/v1/wallet/fiat/:currencyCode/withdraw
15 May 2025
- Added a new GET route
/v1/loans/rates/history?currencySymbol=which returns the rate history and loan book utilisation from previous auctions.
27 March 2025
- Added a GET public route
/v1/public/risklimit/:currencypairwhich provides the available leverage options for a requested currency pair. - Added a GET to Margin route
/v1/margin/leverage/:currencypairwhich returns the leverage information for a requested subaccount. - Added a PUT to the route
/v1/margin/leverage/:currencypairwhich allows the user to update the maximum leverage for a subaccount.
05 March 2025
- Added a new public route
/v1/public/loans/inforeturning loan info per currency supporting lending - Added support for
clientMsgIdparameter to Account Web Sockets to correlate requests and responses
13 February 2025
- Added the V2 API / Brokerage Instructions API
- Added a new MARGIN_INFO event (beta) on the ACCOUNT websocket
5 February 2025
- Added a new route /v1/wallet/crypto/withdraw/history to retrieve an account's withdrawal history with currency as an optional query parameter. startTime and endTime (ISO 8601) can be used for additional time-based filtering. The existing route /v1/wallet/crypto/:currencyCode/withdraw/history remains functional but is now deprecated.
- Added a new route /v1/wallet/crypto/deposit/history to retrieve an account's deposit history with currency as an optional query parameter. startTime and endTime (ISO 8601) can be used for additional time-based filtering. The existing route /v1/wallet/crypto/:currencyCode/deposit/history remains functional but is now deprecated.
27 January 2025
- PUT /v1/orders/modify Modify REPRICE has been added.
21 January 2025
- GET /v1/orders/history now returns totalExecutedQuantity
- GET /v1/orders/history/summary/orderid/:orderId now returns totalExecutedQuantity
- GET /v1/orders/history/summary/customerorderid/:customerOrderId now returns totalExecutedQuantity
6 January 2025
- Add a new route /v1/account/tradehistory to get an account's trading history without specifying a currency pair.
9 December 2024
- POST /v1/account/subaccounts/transfer now returns the transfer ID
- Transaction history items of type INTERNAL_TRANSFER now includes a transferId field
25 October 2024
- Add a new route /v1/loans to create a new loan.
- Add a new route /v1/loans/open to view your open loans.
- Add a new route /v1/loans/credit-history?currencySymbol=symbol to view previous loans.
- Add a new route /v1/loans/increase to increase loan amount.
- Add a new route /v1/loans/rate to update your loan's rate.
- Add a new route /v1/loans/update-history?currencySymbol=symbol to view the history of your loan updates.
- Add a new route /v1/loans/unlock to request an unlock and to cancel a request to unlock a loaned amount.
- Futures limit and market orders now support conditionalOrderData which can be used to add Stop Loss and/or Take Profit orders.
- Add a new route /v1/orders/conditionals/:currencyPair/history to fetch conditional orders by pair.
- Add a new route /v1/orders/conditionals/conditional/:currencyPair/orderid/:orderId to fetch conditional orders by pair and an order ID.
- Add a new route /v1/orders/conditionals/modify to modify conditional orders.
23 October 2024
- Added Performance Guidelines
18 September 2024
- Add reduceOnly flag information to limit and market orders.
30 August 2024
- Order Types route /v1/public/ordertypes now supports the includeInactivePairs query parameter to allow excluding inactive pairs from the result
- Add rate-limited sample messages to websockets
16 August 2024
- Order history route /v1/orders/history now includes statuses filter.
- Trade history route /v1/account/:currencyPair/tradehistory now includes skip param.
- Increased rate limits for websocket write requests to match current http rate limits.
07 August 2024
- Add new websocket order type BATCH_ORDERS
22 July 2024
- Split Account websocket section into Read and Write.
18 July 2024
- Add a new route /v1/account/subaccount to rename subaccount labels.
15 July 2024
- Increased rate limits for Post, Batch and Delete orders.
02 July 2024
Added a new route
/v1/account/transactionhistory/subaccountsto expose subaccount transaction history.Add a new route
/v1/account/subaccountto DELETE subaccounts
26 June 2024
Remove wire withdrawals. These are currently not supported.
04 June 2024
- Added the
/v1/conditionalsroute to enableGET,POSTandDELETEtake profit and stop loss (conditional) orders for futures positions. - Added the following new events on the ACCOUNT websocket for futures trades:
ADD_CONDITIONAL_ORDER,REMOVE_CONDITIONAL_ORDER,OPEN_POSITION_UPDATE,REDUCE_POSITIONandPOSITION_CLOSED - Added the ability to place, modify and cancel orders on the
ACCOUNTwebsocket. - Added the
CANCEL_ON_DISCONNECTevent on theACCOUNTSwebsocket. - Open Orders call now includes
allowMarginflag to easily identify open margin orders. - Added the currency pair by type public endpoint
/v1/public/pairs/:type- to list currency pairs by eitherFuturesorSpot. - Exposed the wallet send costs and minimum withdraw amounts for currencies on the public route
/v1/public/currencies - Refined the descriptions and examples for Limit Only Reprice, Margin Information.
- Refined the authentication Requirements in Getting Started section.
12 February 2024
- Added stricter input validation of
sideandTimeInForcefor Limit Orders and Stop Limit Orders.
06 December 2023
- Added a new public route
/v1/public/futures/funding/historyto expose the Futures funding rate history.
05 December 2023
- Updated per-second rate limits to reflect new limits.
- Added the
positionIdfield for Futures positions. - Added V2 API requests
- Modify Limit Order (Beta) -
/v2/orders/modify - Account Margin Information -
/v2/margin/status - Updated V1 Order History API -
v1/orders/history - Optional
startTimeandendTimedate filters can now be used.
27 November 2023
-
/v1/public/currenciesresponses now include the supported and default blockchain network types for deposits and withdrawals, per currency. The network type can also be supplied when creating an address book address. - NOTE: Due to the sensitive nature of withdrawals and deposits, providing the network type will become mandatory for all currencies that support more than one network for withdrawals and deposits from 1 April 2024.
- Updated API's:
/v1/public/currencies/v1/wallet/crypto/:currencyCode/deposit/address/v1/wallet/crypto/:currencyCode/deposit/history/v1/wallet/crypto/address-book/v1/wallet/crypto/address-book/:currencyCode/v1/wallet/crypto/:currencyCode/withdraw/v1/wallet/crypto/:currencyCode/withdraw/:withdrawId/v1/wallet/crypto/:currencyCode/withdraw/history
15 November 2023
-
/v1/public/futures/info- which returns contract details of perpetual futures contracts -
/v1/positions/open- which returns open futures contracts for an account -
/v1/positions/closed/summary- which returns a summary of closed futures contracts -
/v1/positions/closed?currencyPair- which returns a detailed view of closed futures contracts per futures pair -
/v1/positions/history?currencyPair- which returns a history of futures contracts held by an account -
/v1/positions/funding/history?currencyPair- a history of funding -
/v1/margin/account/status- to enable an account for Futures trading using the endpoint - Added an example of the
MARK_PRICE_UPDATEevent on the TRADE websocket
09 November 2023
- Added the
/v1/orders/modifyto modify open and partially filled Limit Orders. - Added
MODIFY_ORDER_OUTCOMEevent to the Account Websocket. - Updated the
OPEN_ORDERS_UPDATEWebSocket event to include the Order Modified status. - Added Margin trading to the
/v1/orders/limitand/v1/orders/market. - Added
/v1/public/:currencyPair/markprice/buckets, which returns Mark Price buckets for a given currency pair. - Added Limit Order Reprice to
/v1/orders/limit. - Updated Trade History
/v1/account/:currencyPair/tradehistory?limit=10to include fees and rewards
10 October 2023
- Added per-second rate-limit to
/v1/account/subaccounts/transfer
18 September 2023
- Added sequence number calculation to
FULL_ORDERBOOK_UPDATEweb socket documentation.
18 August 2023
- Added V2 Exchange Buy/Sell API in Alpha.
28 July 2023
- Updated per second rate limits to reflect new limits.
14 July 2023
- Added Staking API
15 May 2023
- Documented new websocket connections rate limit
- Updated the
/v1/balancesrequest with query parameterexcludeZeroBalancesto return non-zero balances only - Updated the
BALANCE_UPDATEWebSocket event to include the following fields:totalInReference,totalInReferenceWeightedandreferenceCurrency
Updated pre-request script and documentation to support the yourSubAccountId environment variable. This allows impersonating an account with every request.
06 March 2023
- Added a request to link a new fiat bank account
- Added a request for linked fiat bank account details
- Added a request to delete a linked fiat bank account
- Added a request to list all banks supported for fiat withdrawals per currency
- Added a request to get an auto-buy reference for buying a currency with a fiat deposit
Added a request to list all currencies supported for auto-buy per fiat currency
03 March 2023
- Removed Deposit Instructions for Wire Transfers
25 November 2022
- Updated rate limits for
/v1/batch/ordersand/v1/orders.
17 November 2022
- Added the Caching section.
- Added the
collateralandcollateralWeightfields to -v1/public/currencieswhich are reserved for future use. - Added
marginTradingAllowedto the/v1/public/pairsendpoint, reserved for future use. - Added the
MARK_PRICE_UPDATEevent to theTradeWebsocket - Updated the
BALANCE_UPDATEWebsocket event to include the following fields that are reserved for future use:collateral,collateralWeight,lendReserved,borrowCollateralReserved,borrowedAmount - Updated the
NEW_ACCOUNT_HISTORY_RECORDWebsocket event to include the following fields that are reserved for future use:collateral,collateralWeight
19 August 2022
- Clarify that per minute and per second rate limits do not interact.
- Add examples for stop orders to the Exchange Buy/Sell API.
- Increase subaccount limit to 2000 per main account.
18 August 2022
- Added `/v1/orders` request to cancel all open orders.
- Added `/v1/orders/:currencyPair` to cancel all open orders for the given currency pair.
04 August 2022
- Increased per second rate limits for
/v1/batch/ordersand/v1/orders
20 July 2022
- Updated VALR Pay documentation to reflect new ability to send and receive cryptocurrencies in addition to ZAR.
11 July 2022
- Updated per second rate limits to reflect new limits
27 June 2022
- Added per second rate limits to
/v1/batch/ordersand/v1/orders
12 June 2022
- The Market Summary APIs
/v1/public/marketsummaryand/v1/public/:currencyPair/marketsummarynow return amarkPricefield, which is reserved for future use. - The Balances API
/v1/account/balancesnow returns the following additional fields, which are reserved for future use.lendReservedborrowReservedborrowedAmount
- The Simple Buy/Sell Quote API
v1/simple/:currencyPair/quotenow returns an array ofordersToMatch,which includespriceandquantity; if they exist.
9 May 2022
- The FULL_ORDERBOOK_UPDATE Trade WebSocket stream now returns a
Checksumfield.
8 February 2022
- Added the FULL_ORDERBOOK_UPDATE Trade WebSocket stream. Please note that this is an alpha feature and may change in ways that are not backwards-compatible. We value any feedback! Please send your feedback to support@valr.com
- The following APIs now include a
"SequenceNumber"field on the returned order book:/public/:currencyPair/orderbook/public/:currencyPair/orderbook/full/marketdata/:currencyPair/orderbook/marketdata/:currencyPair/orderbook/full
14 December 2021
- Added the Wire Transfers API to facilitate USD wire bank accounts deposits and withdrawals. (
/v1/wire) - Added the VALR Pay API (
/v1/pay) for initiating payments, getting payment details and history. - Added the Deposit Reference API to enable retrieval of Deposit reference by subaccount.(
/v1/fiat/:currencyCode/deposit/reference)
31 October 2021
- Added the following APIs for interaction with subaccounts:
- (
account/balances/all) - returns all non zero balances for the portfolio. - (
account/subaccounts) - returns all subaccounts that belong to a primary account. - (
account/subaccount) - register a new subaccount. - (
account/subaccounts/transfer) - transfer between subaccounts.
- (
- Updated the
Authenticationsection to include theX-VALR-SUB-ACCOUNT-IDheader for subaccount impersonation. - Updated the rate limit for authenticated API calls.
15 September 2021
Added the Current API Key Information API (/account/api-keys/current) which returns the currently authorised API key's information and permissions.
23 August 2021
- Batch Orders API (Alpha) is now available to batch multiple exchange orders.
- Added additional transaction types to transaction history.
-
VALR Pay
PAYMENTtransaction types including:PAYMENT_SENT,PAYMENT_RECEIVED,PAYMENT_REVERSEDandPAYMENT_REWARD; -
Off-chain transaction types including:
OFF_CHAIN_BLOCKCHAIN_WITHDRAWandOFF_CHAIN_BLOCKCHAIN_DEPOSIT; -
Auto-buy
AUTO_BUYtransaction type.
-
VALR Pay
- A Stop Limits API (
/orders/stop/limit) is now available to placeSTOP_LOSS_LIMITandTAKE _PROFIT_LIMITorders. - Limit Orders (
/orders/limit)POSTrequest now acceptstimeInForceas an optional parameter (GTC,FOK,IOC) - Time in Force (
GTC,FOK,IOC) field is now included inGETresponses of the following APIs:- Open Order (
/orders/open) - Order History (
/orders/history) - Order Status (
/orders/history/detail/*)
- Open Order (
- New order types of:
STOP_LOSS_LIMITandTAKE_ PROFIT_LIMITadded to applicable Currency Pairs (currently BTCZAR, ETHZAR and XRPZAR) for the following Public APIs:- Public Order Types (
/public/ordertypes) - Public Currency Pairs (
/public/:currencyPair/ ordertypes)\
- Public Order Types (
- Updated example for Public Currency pairs (
/public/pairs) API with fieldstickSizeandbaseDecimal Placesfor each traded currency pair. - Updated example for for all TransactionId API requests (
/account/transactionhistory) with theidfield in the response - Updated documentation for Trade History API (
/account/:currencyPair/ tradehistory) - Updated example for MarketData Trade History API (
/marketdata/:currencyPair/ tradehistory) with thequoteVolumefield.
02 February 2021
- The Order API (/orders/open) now includes the following fields in GET responses:
updatedAt, status, type - Updated the Order History APIs (/orders/history) to include the feeCurrency field
- Updated documentation: Updated the examples for Order History Detail APIs (/orders/history/detail/*) to include the fields:
executedFee
executedQuantity
executedPrice
- Crypto withdrawals created (/wallet/crypto/:currencyCode/withdraw) with more decimals than the number of decimals supported by the currency will be truncated
- The Currencies list (/public/currencies) now include the following new fields:
- decimalPlaces
- withdrawalDecimalPlaces
- Withdrawal Info (/wallet/crypto/:currencyCode/withdraw) now includes the following new field:
- withdrawalDecimalPlaces
- Trade History for a currency pair (/account/:currencyPair/tradehistory) can now be filtered by the skip, limit, startTime, endTime and beforeId parameters. This is similar to Transaction History filtering.
- Asks & Bids on ZAR Orderbooks: The number of Asks and Bids sent via our Order Book APIs has been increased from 20 each to 40 each.
- Order History Detail APIs (`/orders/history/detail/*`) now include the following new fields:
- executedFee
- executedQuantity
- executedPrice`
- Rate limiting: Rate limit has been updated to 120 calls per 1 minute window. When rate limited, a response code of 429 and a response header of `x-valr-ratelimited: true` will be returned.
- Example 1: You are allowed to do 120 calls from 10:10:00 to 10:10:59. When the time changes to 10:11:00, the counter will be reset and will start over.
- Example 2: If the first request comes in at 10:10:30, the counter will be reset at 10:11:00
- Separated the API and Website web socket sessions. WebSockets which were connected via the API will no longer be closed when the user logs out of the VALR website.
- When a `PING` message is received on the Trade WebSocket, a response with `NO_SUBSCRIPTIONS` in the `PONG` will be sent, if the user has not subscribed to any message types.
- When a user connects and authenticates to the Account WebSocket, all account balances and open orders associated with the user account will be sent in the response. One `BALANCE_UPDATE` message for each asset held and one `OPEN_ORDERS_UPDATE` message containing all open orders on the account, across all order books will be sent.
- The `BALANCE_UPDATE` web socket message now includes an `updatedAt` field.
- The REST GET Balances response (`https://api.valr.com/v1/account/balances`) now includes an `updatedAt` field for each asset held.
- Added the REST GET VALR Status (`https://api.valr.com/v1/public/status`) request which will indicate whether the API is "online" or in "read-only" mode. In "read-only" mode, only GET and OPTIONS requests are accepted. The "read-only" mode is sometimes necessary during maintenance.
- The `filledPercentage` field on open orders is now accurate to two decimal places.
- The REST GET Order Book (`https://api.valr.com/v1/marketdata/:currencyPair/orderbook`) response and the REST GET Order Book (Non aggregated) (`https://api.valr.com/v1/marketdata/:currencyPair/orderbook/full`) response now include a `LastChange` field, indicating the timestamp of the last update to the order book.
- The `AGGREGATED_ORDERBOOK_UPDATE` message on the Trade web socket now includes a `LastChange` field, indicating the timestamp of the last update to the order book.