API Overview

Exchange Rates - Methods for fetching official and commercial exchange rates.

Product Overview

Methods for fetching official and commercial exchange rates.
Based on online official and commercial Exchange Rates API you are able to calculate prices of assets in various currencies for your business.


API Overview

Endpoint Addresses:

All endpoints are structured according to the following pattern:
{base-url}/{api-version}/{product}/{sub-product}

Base URL

API Version

current version: v1

Product endpoints

  • CommercialRatesList: /commercial
    Gets commercial exchange rates for Georgian Lari.
  • Commercial ConvertionResult: /commercial/convert
    Returns convertion value of amount between currencies specified in from and to parameters based on TBC bank's commercial exchange rates.
  • OfficialRatesList: /nbg
    Gets official exchange rates for Georgian Lari.
  • Official ConvertionResult: /nbg/convert
    Returns convertion value of amount between currencies specified in from and to parameters based on official exchange rates.

Authorizing Requests:

  • All requests should contain apikey parameter with corresponding developer ap key value in a Header.
  • apikey parameter is used to verify registered developer app and grant general access to make api call. To get your developer app key, follow instructions at Creating developer account.

Testing services:


Error Response

In case of error, the standard response in problem JSON will be returned.

Details can be found at Error Code Description.