Sign in

v1

latestOpenAPI 3.0.02026-08-06102185472.3 KB
Rates

Get rate by ID

Gets a configured exchange rate by ID.

get/config/rates/{rate_id}

Path parameters

rate_idstring uuid required

Provide the rate_id of the exchange rate you want to return.

Response

Sucessfully returned rate.

rate_idstring uuid required

Unique identifier of the exchange rate.

expiration_offsetinteger required

<b>(DEPRECATED)</b> This property is deprecated. Refer to expires_at to determine rate expiration. <p>Amount of time in milliseconds that the rate is valid for after the rate's created_date value. For example, if the expiration_offset value is 100000 milliseconds, the rate expires 100000 milliseconds after this created_date value. If set to 0, the rate does not expire.</p>

order_type'buy' | 'sell' required

Order type for the exchange rate.

rate_scaleinteger required

Number of decimal places to which the exchange rate is calculated. For example, if the rate_scale value is set to 9 and the rate value is set to 1.25, the scaled value of the rate is 1.250000000.

ratenumber required

Exchange rate for the specified base and counter currency.

base_currencystring required

Base currency of the exchange rate.

counter_currencystring required

Counter currency of the exchange rate.

source_currencystring required

If order_type is set to buy, this is set to the base currency. If order_type is set to sell, this is set to the counter currency.

destination_currencystring required

If order_type is set to buy, this is set to the counter currency. If order_type is set to sell, this is set to the base currency.

source_ledgerstring required

Source ledger associated with the exchange rate.

destination_ledgerstring required

Destination ledger associated with the exchange rate.

source_ledger_accountstring required

Account on the source ledger associated with rate.

destination_ledger_accountstring required

Account on the destination ledger associated with rate.

created_datestring date-time required

Date and time at which the exchange rate was created, as an ISO-8601 timestamp in UTC. Fiat determines a rate's expiration date and time based on this value and expiration_offset value. For example, if the expiration_offset value is 100000 milliseconds, the rate expires 100000 milliseconds after this created_date value.

expires_atstring date-time

The time in which this rate expires in system local timezone

lower_limitnumber required

For a slab-based exchange rate, indicates the lower limit of the slab.

upper_limitnumber required

For a slab-based exchange rate, indicates the upper limit of the slab.

payout_methodstring

The payout method for the rate.

value_type'MARGIN' | 'RATE' required

Indicates whether the rate is a live exchange rate (MARGIN) or an exchange rate manually configured by Ripple (RATE). If this value is MARGIN, then margin_type will show a value.

margin_type'BPS' required

Indicates the unit of margin applied in addition to the rate provided by Ripple. This field has a value only if value_type = MARGIN. If value_type is RATE, this field is null.

Example response

{
  "rate_id": "328b3e50-7983-46d5-94a0-ef004d78db1d",
  "expiration_offset": 95000,
  "order_type": "buy",
  "rate_scale": 9,
  "rate": 0.89,
  "base_currency": "USD",
  "counter_currency": "GBP",
  "source_currency": "USD",
  "destination_currency": "GBP",
  "source_ledger": "rn.eur.uk.london",
  "destination_ledger": "rn.eur.uk.london",
  "source_ledger_account": "alias_usd_lon",
  "destination_ledger_account": "conct_gbp_lon",
  "upper_limit": 1000,
  "payout_method": "LOCAL_RAILS",
  "value_type": "MARGIN",
  "margin_type": "BPS"
}