Pular para o conteúdo

Get rate by ID

Requisição

Gets a configured exchange rate by ID.

Segurança
Bearer
Caminho
rate_idstring, (uuid)obrigatório

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

curl -i -X GET \
  'https://docs.ripple.com/_mock/pt-br/products/payments-odl/api-docs/ripplenet/reference/openapi/config/rates/{rate_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Respostas

Sucessfully returned rate.

Corpoapplication/json
rate_idstring, (uuid)obrigatório

Unique identifier of the exchange rate.

Exemplo:"328b3e50-7983-46d5-94a0-ef004d78db1d"
expiration_offsetintegerobrigatório

(DEPRECATED) This property is deprecated. Refer to expires_at to determine rate expiration.

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.

Exemplo:95000
order_typestringobrigatório

Order type for the exchange rate.

Enum:"buy""sell"
Exemplo:"buy"
rate_scaleintegerobrigatório

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.

Padrão:9
Exemplo:9
ratenumberobrigatório

Exchange rate for the specified base and counter currency.

Exemplo:0.89
base_currencystringobrigatório

Base currency of the exchange rate.

Exemplo:"USD"
counter_currencystringobrigatório

Counter currency of the exchange rate.

Exemplo:"GBP"
source_currencystringobrigatório

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.

Exemplo:"USD"
destination_currencystringobrigatório

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.

Exemplo:"GBP"
source_ledgerstringobrigatório

Source ledger associated with the exchange rate.

Exemplo:"rn.eur.uk.london"
destination_ledgerstringobrigatório

Destination ledger associated with the exchange rate.

Exemplo:"rn.eur.uk.london"
source_ledger_accountstringobrigatório

Account on the source ledger associated with rate.

Exemplo:"alias_usd_lon"
destination_ledger_accountstringobrigatório

Account on the destination ledger associated with rate.

Exemplo:"conct_gbp_lon"
created_datestring, (date-time)obrigatório

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_limitnumberobrigatório

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

Exemplo:0
upper_limitnumberobrigatório

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

Exemplo:1000
payout_methodstring

The payout method for the rate.

Exemplo:"LOCAL_RAILS"
value_typestringobrigatório

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.

Enum:"MARGIN""RATE"
Exemplo:"MARGIN"
margin_typestringobrigatório

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.

Value:"BPS"
Exemplo:"BPS"
Resposta
{
  "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",
  "created_date": "2019-08-24T14:15:22Z",
  "expires_at": "2019-08-24T14:15:22Z",
  "lower_limit": 0,
  "upper_limit": 1000,
  "payout_method": "LOCAL_RAILS",
  "value_type": "MARGIN",
  "margin_type": "BPS"
}