Market Data
GET /v1/currency — FX Rates for USD Price Conversion
Retrieve the USD-base FX rate table used by CSBoard payment flows. Multiply any price_usd by the target currency rate for a local-currency price.
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
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.
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 aprice_usd value in a local currency, multiply it by the corresponding rate:
Example request
Example response
Error codes
Authorizations
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.