VALR API

Cryptocurrency / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

VALR is a South African cryptocurrency exchange that offers a comprehensive API for market data, account management, and trading. The API supports REST and WebSocket connections for real-time data. Public market data is accessible without authentication, while trading operations require an API key with HMAC signing.

💡

Beginner Tip

VALR public endpoints like /v1/public/{currencyPair}/marketsummary give you live market data without needing an API key, which is a great way to explore the API before implementing authentication. When you do add auth, follow the HMAC signature guide in the VALR docs carefully.

Available Data

coin price in USD/EUR
market capitalization
24h price change
trading volume
circulating supply

Example Response

JSON Response
{
  "id": "bitcoin",
  "symbol": "btc",
  "current_price": 65432.1,
  "market_cap": 1280000000000,
  "price_change_24h": 1250.5,
  "price_change_percentage_24h": 1.95,
  "total_volume": 28500000000
}

Field Reference

currencyPair The trading pair for the market summary (e.g., BTCZAR)
askPrice The lowest price at which sellers are willing to sell
bidPrice The highest price at which buyers are willing to buy
lastTradedPrice Price of the most recent completed trade
changeFromPreviousClosePercent Percentage change in price since the previous close
highPrice Highest trade price in the last 24 hours

Implementation Example

const url = "https://docs.valr.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

403 Forbidden on private endpoints Missing API key or incorrectly computed HMAC signature
Refer to the VALR authentication docs to correctly compute the signature using your API key, secret, timestamp, verb, path, and body
Currency pair not found Using a lowercase or incorrectly formatted currency pair
Currency pairs on VALR must be uppercase and concatenated (e.g., BTCZAR, not BTC-ZAR or btczar)
Timestamp out of range The timestamp in your signed request is too far from the server time
Ensure your system clock is synced and generate a fresh timestamp for each request; do not reuse timestamps

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Cryptocurrency
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →