taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

get-rate.rst (913B)

      1 .. http:get:: /rate
      2 
      3   Since protocol **v2**.
      4 
      5   This public endpoint allows clients to get the currenlty applied change rate between the regional currency and the fiat currency of the banking system for this exchange account.
      6   Those informations should never be used to perform conversions use :http:get:`/cashin-rate </cashin-rate>` and :http:get:`/cashout-rate </cashout-rate>` instead.
      7   Conversion rates can change at any time. Clients must deal with any resulting errors and call :http:get:`/cashin-rate </cashin-rate>` or :http:get:`/cashout-rate </cashout-rate>` again to use the new rates.
      8   If ``cashin_ratio`` is zero, this means the account cannot cashin, and if ``cash_out`` ratio is zero, this means the account cannot cashout.
      9 
     10   **Response:**
     11 
     12   :http:statuscode:`200 OK`:
     13     Response is a `ConversionRate`.
     14   :http:statuscode:`501 Not implemented`:
     15     This server does not support conversion.