Get a pair's market summary

GET

/v1/public/{currencyPair}/marketsummary

Public: no API key needed. Send the request as is, without signing it.

Returns one currency pair's market summary: best ask and bid, last traded price, and the high, low and volume over the last 24 hours, with the percentage change from the last price before then. Responses are cached for up to 5 seconds.

Parameters

Path Parameters

currencyPair*

Currency pair symbol, e.g. BTCZAR.

Type

string

Required

Example"BTCZAR"

Responses

OK

Content-Type

application/json

{

"currencyPair": "BTCZAR",

"askPrice": "1850012",

"bidPrice": "1849800",

"lastTradedPrice": "1849900",

"previousClosePrice": "1832000",

"baseVolume": "12.4518",

"quoteVolume": "22958256.31",

"highPrice": "1861000",

"lowPrice": "1825500",

"created": "2026-10-23T08:51:12.004Z",

"changeFromPrevious": "0.98",

"markPrice": "1849900"

}

Samples

Errors

HTTP	Error	When
400	-21INVALID_CURRENCY_PAIR	currencyPair isn't a currency pair VALR supports.
404	-111MARKET_SUMMARY_NOT_FOUND	VALR has no market summary for the pair yet, which can happen for a pair that isn't trading.

Public endpoints are not signed, so they never return authentication errors.