# Get Settlement Rate

Retrieves the guaranteed/locked exchange rate for settlement along with forecast rates for different execution intervals.

Rate Information Includes:
- Current Rate: locked exchange rate for immediate execution
- Rate ID: Unique identifier of the rate
- Forecast Rates: Forecast rates for execution at different time intervals (1-6 hours)
- Corridor Information: Source and destination member IDs

Rate Locking:
- Each rate response includes a rateId that locks the current rate
- This rateId must be used when creating a settlement to guarantee the rate
- Rate locks have an expiry time (typically 15 minutes for immediate execution)

Forecast Rates:
- Provides rates for scheduled execution
- Available intervals: IMMEDIATE, ONE_HOUR, TWO_HOURS, THREE_HOURS, FOUR_HOURS, FIVE_HOURS, SIX_HOURS
- Helps members choose optimal execution timing based on rate forecasts

Endpoint: GET /v2/settlement-rates
Version: 1.1.0

## Query parameters:

  - `destinationCcy` (string, required)
    ISO 4217 three-letter currency code for the destination currency.
    Example: "PHP"

## Response 200 fields (application/json):

  - `rate` (number)

  - `rateId` (string)

  - `sourceMemberId` (string)

  - `destinationMemberId` (string)

  - `forecastRates` (array)

  - `forecastRates.executionInterval` (string)
    Settlement execution interval determining when the settlement will be processed.

- IMMEDIATE: Execute settlement as soon as possible (0 hours delay)
- ONE_HOUR to SIX_HOURS: Schedule settlement for future execution

Execution intervals allow members to optimize settlement timing based on:
- Market conditions and rate forecasts
- Business requirements and cash flow needs
- Operational schedules and working hours
    Enum: "IMMEDIATE", "ONE_HOUR", "TWO_HOURS", "THREE_HOURS", "FOUR_HOURS", "FIVE_HOURS", "SIX_HOURS"

  - `forecastRates.rate` (number)
    rate for this execution interval.

## Response 400 fields (application/json):

  - `code` (string)

  - `message` (string)

  - `detail` (string)