Skip to main content
GET
FX rates (USD base)
Every price in the CSBoard API is denominated in USD. The currency endpoint returns the same FX rate table that powers the site’s own payment and display flows, giving you a consistent conversion layer for presenting local-currency prices to your users. Rates are sourced from OpenExchangeRates for major currencies and from the Central Bank of Russia for RUB, and are cached for approximately one hour. Authentication required. Send your key as Authorization: Bearer csb_pub_....

Parameters

This endpoint takes no query parameters.

Response fields

string
required
Always "USD". All rates are expressed relative to one US dollar.
object
required
A map of ISO 4217 currency codes to their exchange rate against USD (units of that currency per 1 USD). Example: { "USD": 1, "EUR": 0.92, "RUB": 78.4, "GBP": 0.79 }.
datetime
required
ISO 8601 timestamp of when the rate table was last refreshed.
string
Source identifier for the RUB rate, e.g. "cbr" (Central Bank of Russia).
string
Source identifier for non-RUB rates, e.g. "openexchangerates".

Converting prices

To display a price_usd value in a local currency, multiply it by the corresponding rate:
Because the rates table is cached for ~1 hour, fetch it once at application start and refresh it periodically rather than calling this endpoint per-item.

Example request

Example response

Error codes

Cache the rates response client-side and refresh it no more than once per hour. Rates are updated on the same ~1 hour cycle, so polling more frequently won’t give you fresher data and consumes your rate limit budget.

Authorizations

Authorization
string
header
required

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

Response

Current FX rates.

base
string
required
Example:

"USD"

rates
object
required

Currency code → units per 1 USD.

updated_at
string<date-time>
required
rub_source
string
base_source
string