VALR API

VALR provides a set of REST endpoints and a complementary WebSocket service which enables you to programmatically access your account on VALR.

Usage of the API is governed by our Terms of Service.

With the API you can:

• Access real-time and historical market data
• Place and manage trade orders
• Buy and sell 60+ cryptocurrencies
• Withdraw crypto and fiat currencies

Getting Started

Base URL

All API requests are made to:

https://api.valr.com

Enable Two-Factor Authentication

Two-Factor Authentication (2FA) must be enabled on your VALR account before you can generate API keys. You can enable 2FA from your account security settings.

Content Type

All REST API requests must use application/json as the content type. Requests are only accepted over HTTPS.

Sending a POST, PUT, or PATCH request without the Content-Type: application/json header will result in a 401 Unauthorized response.

Response Format

Successful responses return HTTP status codes in the 200–299 range unless there is a server or infrastructure error. Results are wrapped in a JSON result object.

A 202 Accepted response means the request has been accepted for processing but is not yet complete. You should check the order status via the Order Status REST API or subscribe to WebSocket events for real-time updates.

Authentication

All non-public endpoints require API key authentication. Requests without a valid API key will receive a 403 Forbidden response.

Public endpoints under /v1/public/* do not require authentication — these include market data such as order books, trade history, and currency information.

See the Authentication guide for full details on generating API keys and signing requests.