跳转到主要内容
GET
/
currency
FX rates (USD base)
curl --request GET \
  --url https://csboard.com/v1/currency \
  --header 'Authorization: Bearer <token>'
{
  "base": "USD",
  "rates": {
    "USD": 1,
    "EUR": 0.92,
    "RUB": 78.4,
    "GBP": 0.79
  },
  "updated_at": "2026-06-29T17:00:00Z",
  "rub_source": "cbr",
  "base_source": "openexchangerates"
}
CSBoard API 中所有价格均以美元计价。currency 端点返回与站点自身支付与展示流程相同的汇率表，为您提供一致的换算层，用于向用户展示本地货币价格。汇率主要币种来源于 OpenExchangeRates，RUB 来源于俄罗斯中央银行，并缓存约一小时。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

​
参数

此端点不接受任何查询参数。

​
响应字段

​
base
string
必填
始终为 "USD"。所有汇率均相对于 1 美元表示。
​
rates
object
必填
ISO 4217 货币代码到其相对美元汇率（每 1 美元等于多少该货币单位）的映射。例如：{ "USD": 1, "EUR": 0.92, "RUB": 78.4, "GBP": 0.79 }。
​
updated_at
datetime
必填
汇率表上次刷新时的 ISO 8601 时间戳。
​
rub_source
string
RUB 汇率的来源标识，例如 "cbr"（俄罗斯中央银行）。
​
base_source
string
非 RUB 汇率的来源标识，例如 "openexchangerates"。

​
价格换算

要将 price_usd 值以本地货币显示，请将其乘以对应汇率： 
local_price = price_usd × rates["EUR"]
# 例如 14.37 USD × 0.92 = 13.22 EUR
由于汇率表缓存约 1 小时，请在应用启动时获取一次，并定期刷新，而非对每个商品都调用此端点。

​
示例请求

curl https://csboard.com/v1/currency \
  -H "Authorization: Bearer csb_pub_..."

​
示例响应

{
  "base": "USD",
  "rates": {
    "USD": 1,
    "EUR": 0.92,
    "RUB": 78.4,
    "GBP": 0.79
  },
  "updated_at": "2026-06-29T17:00:00Z",
  "rub_source": "cbr",
  "base_source": "openexchangerates"
}

​
错误代码

HTTP 状态码代码含义
401unauthorizedAPI 密钥缺失或无效。
429rate_limit_exceeded超过 30 次/分钟。在重试前请检查 Retry-After 响应头。
请在客户端缓存 rates 响应，每小时刷新不超过一次。汇率约每小时更新一次，更频繁地轮询不会带来更新鲜的数据，反而会消耗您的速率限制额度。

授权

​
Authorization
string
header
必填

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

响应

Current FX rates.

​
base
string
必填
示例:

"USD"

​
rates
object
必填

Currency code → units per 1 USD.

​
updated_at
string<date-time>
必填
​
rub_source
string
​
base_source
string