> This page is for API Reference. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://fiftytwo-demo.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://fiftytwo-demo.ferndocs.com/_mcp/server. # Get currency by Code and chain GET https://api.fiftytwo.com/masterdata/currencies/v1/chain/{chainId}/{currencyCode} Reference: https://fiftytwo-demo.ferndocs.com/api/master-data/reference/currencies/get-currency-by-code-and-chain ## Request ### Path parameters - `currencyCode` (string, required) — The Code of the currency to retrieve - `chainId` (integer, required) — The ID of the chain ## Response ### 200 Success - `currencies` (list of CurrenciesCurrenciesItems, required) — List of all supported currencies with their exchange rate information and metadata. ## Errors ### 400 Bad Request Error Bad Request - `string` ## Types ### CurrenciesCurrenciesItems Definition of a single currency record as stored in f112c(val). - `currencyCode` (string, required) — A short code that identifies the currency, usually the well-known abbreviation (like 'USD' or 'EUR'). Must be 1 to 4 letters. - `exchangeRate` (double, required) — The currency’s main exchange rate compared to a base or reference currency, expressed per 100 units of the currency. Used for price and payment calculations. For example, if 1 USD equals 1.1000 in the reference currency, exchangeRate must be 110.0000, since the rate is provided per 100 units. Supports up to 4 decimal places. - `commonCurrencyCode` (integer, required) — A number that tells the system whether this currency should be converted using a shared 'common currency' before converting it to another currency. If the value is 0, the currency is converted directly using its own exchange rate. If the value is greater than 0, the currency must first be converted into the shared common currency, and then converted again into the target currency. This is useful when two currencies do not have a direct exchange rate, so the system uses a common middle currency to ensure the conversion is correct. - `conversionFactor` (double, required) — A value used to convert amounts to and from the common currency. Amounts are divided or multiplied by this number during conversion. Supports up to 6 decimal places. - `isoNumericCode` (integer, required) — The official three-digit ISO numeric code for the currency (for example, USD = 840, EUR = 978). If the value is 0, the currency does not have an ISO numeric code. - `displayText` (string, optional) — A short, human-friendly label or name for the currency. Maximum 10 characters. - `decimalCount` (enum, optional, default: 2) — Number of decimals used when displaying or rounding currency amounts. Allowed values: 0, 1, or 2. Defaults to 2 if not specified. - Allowed values: `0`, `1`, `2` ## Examples **Response** ```json { "currencies": [ { "currencyCode": "EUR", "exchangeRate": 100, "commonCurrencyCode": 0, "conversionFactor": 1, "isoNumericCode": 978, "displayText": "Euro", "decimalCount": 2 }, { "currencyCode": "USD", "exchangeRate": 116.84, "commonCurrencyCode": 978, "conversionFactor": 1.1684, "isoNumericCode": 840, "displayText": "US Dollar", "decimalCount": 2 }, { "currencyCode": "CHF", "exchangeRate": 92.42, "commonCurrencyCode": 978, "conversionFactor": 0.9242, "isoNumericCode": 756, "displayText": "Swiss Fr.", "decimalCount": 2 }, { "currencyCode": "DKK", "exchangeRate": 747.27, "commonCurrencyCode": 978, "conversionFactor": 7.4727, "isoNumericCode": 208, "displayText": "Dan. Krone", "decimalCount": 2 }, { "currencyCode": "SEK", "exchangeRate": 1089.2, "commonCurrencyCode": 978, "conversionFactor": 10.892, "isoNumericCode": 752, "displayText": "Swe. Krona", "decimalCount": 2 }, { "currencyCode": "NOK", "exchangeRate": 1109.8, "commonCurrencyCode": 978, "conversionFactor": 11.098, "isoNumericCode": 578, "displayText": "Nor. Krone", "decimalCount": 2 }, { "currencyCode": "ISK", "exchangeRate": 14320, "commonCurrencyCode": 978, "conversionFactor": 143.2, "isoNumericCode": 352, "displayText": "Ice. Krona", "decimalCount": 2 }, { "currencyCode": "PLN", "exchangeRate": 425.43, "commonCurrencyCode": 978, "conversionFactor": 4.2543, "isoNumericCode": 985, "displayText": "Polish Zl.", "decimalCount": 2 }, { "currencyCode": "GBP", "exchangeRate": 87.058, "commonCurrencyCode": 978, "conversionFactor": 0.87058, "isoNumericCode": 826, "displayText": "Pound St.", "decimalCount": 2 } ] } ``` **SDK Code** ```python Currencies_getCurrencyByCodeAndChain_example import requests url = "https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode" response = requests.get(url) print(response.json()) ``` ```javascript Currencies_getCurrencyByCodeAndChain_example const url = 'https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode'; const options = {method: 'GET'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Currencies_getCurrencyByCodeAndChain_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Currencies_getCurrencyByCodeAndChain_example require 'uri' require 'net/http' url = URI("https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```java Currencies_getCurrencyByCodeAndChain_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode") .asString(); ``` ```php Currencies_getCurrencyByCodeAndChain_example request('GET', 'https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode'); echo $response->getBody(); ``` ```csharp Currencies_getCurrencyByCodeAndChain_example using RestSharp; var client = new RestClient("https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift Currencies_getCurrencyByCodeAndChain_example import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://api.fiftytwo.com/masterdata/currencies/v1/chain/1/currencyCode")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```