REST API Reference

The VALR REST API provides programmatic access to your account, trading, and market data. All endpoints are available over HTTPS at:

https://api.valr.com

Quick Reference

Base URL	https://api.valr.com
Protocol	HTTPS only
Content-Type	application/json
Authentication	HMAC-SHA512 signed requests (guide)
Rate Limits	2,000 req/min per API key, 1,200 req/min per IP (details)

Authentication

All non-public endpoints require API key authentication with HMAC-SHA512 request signing. Public endpoints under /v1/public/* (market data, order books, currencies) do not require authentication.

🔑 Before You Start

Two-Factor Authentication (2FA) must be enabled on your VALR account before you can generate API keys. See the Authentication guide for setup instructions and code examples in 5 languages.

Response Format

Successful responses return HTTP status codes in the 200–299 range. A 202 Accepted response means the request has been accepted for processing but is not yet complete — check the order status via REST or subscribe to WebSocket events for real-time updates.

Endpoints

Browse the full API reference below, organised by tag. Select any endpoint in the sidebar to view request parameters, response schemas, and try it out.