Перейти к содержанию

Rate Info Service

Overview

The service is responsible for the following functions:

  • Mapping currency information with provider data.
  • Fetching information about current exchange rates of all known currencies.
  • Saving currency exchange rates into permanent storage.
  • Generating JSON caches from historical exchange rate data.

Key Concepts and Terms

Mapping

Within the service, there is a need to correlate asset information in the Asset info service with internal currency identifiers provided by external providers. The service supports the following types of assets:

  • Coins - core cryptocurrencies supported by the service.
  • ERC-20 Tokens - cryptocurrencies based on Ethereum and Ethereum-like blockchains, identified by contract address.
  • Stellar Assets - cryptocurrencies based on the Stellar blockchain, identified by the issuing address and asset code.

Currency Rates

Price of one unit of cryptocurrency expressed in fiat currency.

Rate Caching

An end user (client) receives currency rate data from the service in a form of static JSON files.

An example structure of historical exchange rates

rate-history-day-btc.json
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
[
    {
        "date": 1680159600,
        "rates": {
            "usd": "28650.00000000",
            "aed": "105217.00000000",
            "ars": "5967523.00000000",
            "aud": "42747.00000000",
            "bdt": "3060738.00000000",
            "bhd": "10802.40000000",
            "bmd": "28650.00000000",
            "brl": "147124.00000000",
            "cad": "38817.00000000",
            "chf": "26289.00000000",
            "clp": "22694370.00000000",
            "cny": "197122.00000000",
            "czk": "622909.00000000",
            "dkk": "196912.00000000",
            "eur": "26434.00000000",
            "gbp": "23252.00000000",
            "hkd": "224900.00000000",
            "huf": "10061079.00000000",
            "idr": "431249469.00000000",
            "ils": "102312.00000000",
            "inr": "2354806.00000000",
            "jpy": "3797436.00000000",
            "krw": "37223653.00000000",
            "kwd": "8784.08000000",
            "lkr": "9305105.00000000",
            "mmk": "60151241.00000000",
            "mxn": "518312.00000000",
            "myr": "126662.00000000",
            "ngn": "13188245.00000000",
            "nok": "299033.00000000",
            "nzd": "45977.00000000",
            "php": "1558211.00000000",
            "pkr": "8120030.00000000",
            "pln": "123909.00000000",
            "rub": "2210661.00000000",
            "sar": "107586.00000000",
            "sek": "298429.00000000",
            "sgd": "38078.00000000",
            "thb": "980409.00000000",
            "try": "548691.00000000",
            "twd": "873529.00000000",
            "uah": "1057844.00000000",
            "vef": "2868.74000000",
            "vnd": "672539157.00000000",
            "zar": "519406.00000000",
            "xdr": "21351.00000000"
        }
    },
    {
        "date": 1680161400,
        "rates": {
            "usd": "28630.00000000",
            "aed": "105148.00000000",
            "ars": "5963420.00000000",
            "aud": "42666.00000000",
            "bdt": "3058620.00000000",
            "bhd": "10795.93000000",
            "bmd": "28630.00000000",
            "brl": "147043.00000000",
            "cad": "38778.00000000",
            "chf": "26262.00000000",
            "clp": "22678665.00000000",
            "cny": "196814.00000000",
            "czk": "621722.00000000",
            "dkk": "196711.00000000",
            "eur": "26411.00000000",
            "gbp": "23206.00000000",
            "hkd": "224747.00000000",
            "huf": "10044430.00000000",
            "idr": "430789284.00000000",
            "ils": "102440.00000000",
            "inr": "2352698.00000000",
            "jpy": "3787459.00000000",
            "krw": "37149887.00000000",
            "kwd": "8781.41000000",
            "lkr": "9298666.00000000",
            "mmk": "60109616.00000000",
            "mxn": "517435.00000000",
            "myr": "126489.00000000",
            "ngn": "13179118.00000000",
            "nok": "298552.00000000",
            "nzd": "45853.00000000",
            "php": "1557047.00000000",
            "pkr": "8114411.00000000",
            "pln": "123841.00000000",
            "rub": "2207686.00000000",
            "sar": "107489.00000000",
            "sek": "298507.00000000",
            "sgd": "38023.00000000",
            "thb": "981047.00000000",
            "try": "548532.00000000",
            "twd": "871980.00000000",
            "uah": "1057112.00000000",
            "vef": "2866.76000000",
            "vnd": "672073762.00000000",
            "zar": "518255.00000000",
            "xdr": "21336.00000000"
        }
    },
    ...
]

An example structure of the latest Coin rates

rates-coin.json
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
{
    "eth": {
        "usd": "1902.85000000",
        "aed": "6987.84000000",
        "ars": "428478.00000000",
        "aud": "2855.48000000",
        "bdt": "201883.00000000",
        "bhd": "717.34000000",
        "bmd": "1902.85000000",
        "brl": "9502.65000000",
        "cad": "2590.84000000",
        "chf": "1688.65000000",
        "clp": "1528420.00000000",
        "cny": "13162.98000000",
        "czk": "40477.00000000",
        "dkk": "12836.46000000",
        "eur": "1722.71000000",
        "gbp": "1514.30000000",
        "hkd": "14933.50000000",
        "huf": "643413.00000000",
        "idr": "28023705.00000000",
        "ils": "6932.26000000",
        "inr": "155668.00000000",
        "jpy": "256187.00000000",
        "krw": "2518514.00000000",
        "kwd": "582.85000000",
        "lkr": "608351.00000000",
        "mmk": "3995043.00000000",
        "mxn": "34145.00000000",
        "myr": "8473.40000000",
        "ngn": "872574.00000000",
        "nok": "20396.00000000",
        "nzd": "3051.89000000",
        "php": "105472.00000000",
        "pkr": "537616.00000000",
        "pln": "7900.71000000",
        "rub": "149585.00000000",
        "sar": "7136.21000000",
        "sek": "19533.20000000",
        "sgd": "2528.22000000",
        "thb": "64412.00000000",
        "try": "37076.00000000",
        "twd": "58394.00000000",
        "uah": "70009.00000000",
        "vef": "190.53000000",
        "vnd": "44617128.00000000",
        "zar": "34803.00000000",
        "xdr": "1409.64000000"
    },
    "btc": {
        "usd": "29088.00000000",
        "aed": "106821.00000000",
        "ars": "6549990.00000000",
        "aud": "43651.00000000",
        "bdt": "3086118.00000000",
        "bhd": "10965.76000000",
        "bmd": "29088.00000000",
        "brl": "145264.00000000",
        "cad": "39605.00000000",
        "chf": "25814.00000000",
        "clp": "23364391.00000000",
        "cny": "201218.00000000",
        "czk": "618764.00000000",
        "dkk": "196226.00000000",
        "eur": "26334.00000000",
        "gbp": "23149.00000000",
        "hkd": "228283.00000000",
        "huf": "9835617.00000000",
        "idr": "428387997.00000000",
        "ils": "105971.00000000",
        "inr": "2379633.00000000",
        "jpy": "3916231.00000000",
        "krw": "38499595.00000000",
        "kwd": "8909.80000000",
        "lkr": "9299631.00000000",
        "mmk": "61070747.00000000",
        "mxn": "521961.00000000",
        "myr": "129530.00000000",
        "ngn": "13338718.00000000",
        "nok": "311792.00000000",
        "nzd": "46653.00000000",
        "php": "1612315.00000000",
        "pkr": "8218334.00000000",
        "pln": "120775.00000000",
        "rub": "2286653.00000000",
        "sar": "109089.00000000",
        "sek": "298597.00000000",
        "sgd": "38648.00000000",
        "thb": "984635.00000000",
        "try": "566768.00000000",
        "twd": "892644.00000000",
        "uah": "1070200.00000000",
        "vef": "2912.60000000",
        "vnd": "682045501.00000000",
        "zar": "532022.00000000",
        "xdr": "21549.00000000"
    },
    ...
}

An example structure of the latest ERC20 Token rates

rates-erc20.json
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
{
    "eth-0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9": {
        "usd": "71.53000000",
        "aed": "262.67000000",
        "ars": "16106.59000000",
        "aud": "107.34000000",
        "bdt": "7588.84000000",
        "bhd": "26.97000000",
        "bmd": "71.53000000",
        "brl": "357.21000000",
        "cad": "97.39000000",
        "chf": "63.48000000",
        "clp": "57454.00000000",
        "cny": "494.80000000",
        "czk": "1521.56000000",
        "dkk": "482.53000000",
        "eur": "64.76000000",
        "gbp": "56.92000000",
        "hkd": "561.35000000",
        "huf": "24186.00000000",
        "idr": "1053417.00000000",
        "ils": "260.59000000",
        "inr": "5851.58000000",
        "jpy": "9630.11000000",
        "krw": "94671.00000000",
        "kwd": "21.91000000",
        "lkr": "22868.00000000",
        "mmk": "150175.00000000",
        "mxn": "1283.52000000",
        "myr": "318.52000000",
        "ngn": "32800.00000000",
        "nok": "766.70000000",
        "nzd": "114.72000000",
        "php": "3964.72000000",
        "pkr": "20209.00000000",
        "pln": "296.99000000",
        "rub": "5622.94000000",
        "sar": "268.25000000",
        "sek": "734.26000000",
        "sgd": "95.04000000",
        "thb": "2421.24000000",
        "try": "1393.70000000",
        "twd": "2195.03000000",
        "uah": "2631.65000000",
        "vef": "7.16000000",
        "vnd": "1677167.00000000",
        "zar": "1308.25000000",
        "xdr": "52.99000000"
    },
    "avax-0xd6070ae98b8069de6b494332d1a1a81b6179d960": {
        "usd": "450.82000000",
        "aed": "1655.56000000",
        "ars": "101515.00000000",
        "aud": "676.52000000",
        "bdt": "47830.00000000",
        "bhd": "169.95000000",
        "bmd": "450.82000000",
        "brl": "2251.37000000",
        "cad": "613.82000000",
        "chf": "400.08000000",
        "clp": "362113.00000000",
        "cny": "3118.57000000",
        "czk": "9589.92000000",
        "dkk": "3041.21000000",
        "eur": "408.14000000",
        "gbp": "358.77000000",
        "hkd": "3538.04000000",
        "huf": "152437.00000000",
        "idr": "6639371.00000000",
        "ils": "1642.39000000",
        "inr": "36881.00000000",
        "jpy": "60696.00000000",
        "krw": "596686.00000000",
        "kwd": "138.09000000",
        "lkr": "144130.00000000",
        "mmk": "946505.00000000",
        "mxn": "8089.62000000",
        "myr": "2007.52000000",
        "ngn": "206730.00000000",
        "nok": "4832.30000000",
        "nzd": "723.05000000",
        "php": "24988.00000000",
        "pkr": "127372.00000000",
        "pln": "1871.84000000",
        "rub": "35440.00000000",
        "sar": "1690.71000000",
        "sek": "4627.80000000",
        "sgd": "598.99000000",
        "thb": "15260.37000000",
        "try": "8784.05000000",
        "twd": "13834.64000000",
        "uah": "16586.50000000",
        "vef": "45.14000000",
        "vnd": "10570682.00000000",
        "zar": "8245.54000000",
        "xdr": "333.97000000"
    },
    ...
}

For a detailed description of rate caching, see the JSON Caching section.