GET /v1/fx

On this page

GET /v1/fx
Access
Request
Response
Response fields
Errors

Returns the current USD-based exchange rates used to convert latest prices when you request a currency other than USD. Rates update about every hour.

Access#

Available on all plans.

Request#

GETapi.cs2.sh/v1/fx

curl https://api.cs2.sh/v1/fx \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

Response#

{
  "base": "USD",
  "updated_at": "2026-09-22T23:00:02Z",
  "collected_at": "2026-09-22T23:00:54.577Z",
  "fresh": true,
  "rates": {
    "AUD": 1.40622087,
    "CAD": 1.40543053,
    "CHF": 0.82058071,
    "CNY": 6.71350215,
    "EUR": 0.87319354,
    "GBP": 0.74932836,
    "JPY": 157.40767305,
    "NZD": 1.74524572,
    "SGD": 1.27536852,
    "USD": 1
  }
}

Response fields#

FXResponse fields:

Field	Type	Required	Description
`base`	`string`	Yes	Base currency (always `USD`).
`updated_at`	`string (date-time)`	Yes	When the rate provider published these rates.
`collected_at`	`string (date-time)`	Yes	When cs2.sh collected them.
`fresh`	`boolean`	Yes	`false` when the rates are more than 2 hours old. Latest-price conversion keeps using them for up to 24 hours.
`rates`	`Record<string, number>`	Yes	Units of each currency per 1 USD, keyed by currency code.

Errors#

400 validation_error means query parameters were supplied. 503 service_unavailable means exchange rates are unavailable. See Request errors for shared errors.