Public data

Public endpoints return reference and market data that isn't tied to your business: whether the exchange is online, its clock, the currencies and pairs it lists, and market summaries and price history. They take no API key, so send them unsigned from anywhere.

When to use them

• Checking your clock: signed requests are rejected if their timestamp is too old, so compare your server's clock with the server time if they start failing.
• Monitoring: the exchange status says whether VALR is accepting all requests or only reads.
• Prices and charts: market summaries for every pair and price buckets (candles).

Limits and freshness

Public endpoints are limited per IP address rather than per key, and their responses are cached: up to 5 seconds for market summaries and price buckets, and up to a minute for currencies and pairs. Each response's Cache-Control header says for how long.

Endpoints

Status and time

Whether VALR is accepting all requests, and the server's clock for checking your request timestamps. These endpoints are public, so no API key is needed.

Endpoint	Request	Needs
Get the server time	GET /v1/public/time	No API key
Get the exchange status	GET /v1/public/status	No API key

Currencies and pairs

The currencies and currency pairs VALR lists, with each pair's trading limits, the order types it accepts and its slippage limits. These endpoints are public, so no API key is needed.

Endpoint	Request	Needs
List currencies	GET /v1/public/currencies	No API key
List currency pairs	GET /v1/public/pairs	No API key
List currency pairs by type	GET /v1/public/pairs/{type}	No API key

Market prices

Market summaries and price buckets for every currency pair, with no API key needed. Responses can be up to 5 seconds old.

Endpoint	Request	Needs
List market summaries	GET /v1/public/marketsummary	No API key
Get a pair's market summary	GET /v1/public/{currencyPair}/marketsummary	No API key
List price buckets	GET /v1/public/{currencyPair}/buckets	No API key