SpotRates

Get spot FX prices for all active currency pairs

Returns current spot FX prices (bid, ask, mid rates) for all currency pairs that are currently active in the system. Each price includes state information (VALID/ERROR) and metadata about the price source. Response is returned as a JSON array containing all active currency pairs.

get/api-regulated/v1/fx-spot-prices

Request

  • Base URL: https://api.currencyguard.com
  • URL: https://api.currencyguard.com/api-regulated/v1/fx-spot-prices
  • Auth: HTTP bearer

Response

Spot prices retrieved successfully. Returns a JSON array of FXPriceStateDTO objects, one for each active currency pair.

validboolean required

Whether the price data is currently valid (true) or in an error/degraded state (false). When false, the value may still be present (stale/approximate data).

errorMessagesstring[]

List of error messages explaining why the state is invalid. Empty/null when valid=true. Can contain multiple accumulated errors from different sources.

valueTimestampstring required

ISO 8601 timestamp indicating when the underlying data was produced at the source (business time). This represents the data's original timestamp.

emissionTimestampstring required

ISO 8601 timestamp indicating when our system emitted this state (system/processing time). This represents when the wrapper was created.

subscriptionSourcestring

Market data subscription channel identifier. Used for debugging and monitoring data flows.

emissionSourcestring

Identifier of the market data provider or internal pricing engine that produced this data. Diagnostic detail for internal use only — omitted from responses to non-internal callers.

infoMessagesstring[]

Informational messages providing context about the price state (e.g., validation details, reference source checks). Do not affect validity. Diagnostic detail for internal use only — omitted from responses to non-internal callers.

Example response

[
  {
    "valid": true,
    "errorMessages": [
      "Market data feed delayed by 30 seconds",
      "Volatility surface is stale"
    ],
    "valueTimestamp": "2024-03-01T14:30:15.123Z",
    "emissionTimestamp": "2024-03-01T14:30:16.456Z",
    "subscriptionSource": "DEFAULT",
    "value": {
      "symbol": "GBPUSD",
      "timestamp": "2024-03-01T14:30:15.123Z",
      "bid": 1.09235,
      "ask": 1.09255,
      "mid": 1.09245
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.