API

ExRates Connect API

2024

Powerful API for processing text and real-time exchange rates.

{

"text": "I bought a computer for $1000 yesterday, and I had to sell 10 TON to get enough money. And the funny thing is, I got a cashback on my card, about a hundred hryvnias.",

"cryptoCurrencies": [

{

"code": "TON",

"value": 10

}

],

"fiatCurrencies": [

{

"code": "USD",

"value": 1000

},

{

"code": "UAH",

"value": 100

}

]

}

{

"rates": {

"EUR": 1,

"USD": 0.93,

"GBP": 1.18,

"UAH": 0.023

},

"flags": {

"EUR": "",

"USD": "",

"GBP": "",

"UAH": ""

},

"symbols": {

"EUR": "€",

"USD": "$",

"GBP": "£",

"UAH": "₴"

}

}

About ExRates Connect API:

The ExRates Connect API is a powerful tool designed for text processing, currency and number searching, and real-time exchange rates. The API originated from ERTB version 3.0 and was part of the bot code, and then was completely rewritten in .NET to optimize performance. This API serves as the heart of all our bots, carefully analyzing texts to identify numbers and currencies.

ExRates Connect is currently used only for our company's products, with a public launch planned for 2025. This API aggregates exchange rates for both fiat and cryptocurrencies from various sources, providing complete and accurate data.

Our team is constantly updating and improving the API, integrating new features and optimizing existing functions to maintain its performance and reliability.

Languages for the Word-To-Number

6 - Belarusian, English, German, Polish, Russian, Ukrainian

Basic recognition of fiat currencies

160 currencies, gold and silver (in ounces)

Enhanced recognition of fiat currencies

6 - Belarusian (93 + 2), English (45 + 2), German (145 + 2), Polish (51 + 2), Russian (25 + 2), Ukrainian (51 + 2)

Updating fiat currencies rates

1 time per 12 hours

Basic recognition of cryptocurrencies

38 currencies

Enhanced recognition of crypto currencies

35 currencies

Updating cryptocurrencies rates

4 times per minute

Patch notes:

2026-06-10 • 1.5.0

Smarter recognition

  • Amounts now pair with the right currency: a stray number nearby (an account level, a year, a quantity) no longer turns into a phantom price.
  • Far fewer false alarms: everyday words that merely resemble currency names are no longer recognized as money.
  • Prices after a dash are now understood – "PRICE - 1,149,999uzs" works.
  • Price ranges next to unit phrases are read correctly: "120-130 dollars per thousand cubic meters" gives 120 and 130, not 1000.
  • Common typos in number words are handled better ("10 милионов долларов" → $10,000,000).
  • A standalone "k" is no longer mistaken for "thousand".

Almost all of these fixes come straight from your 👍/👎 feedback under recognition replies – 15 of the 18 most-reported mistakes are now fixed. Keep the feedback coming!

2026-06-05 • 1.4.0

Smarter number and currency recognition

  • Ranges now work: "100-200 USD" and "two hundred-three hundred hryvnias" return both ends of the range. A descending "200-100" is still treated as subtraction.
  • Billions and trillions are understood: "$839 млрд" is read as 839,000,000,000 USD.
  • Compound numbers in words: "3 млн. 183 тыс. 750" is read as 3,183,750.
  • Amounts in parentheses are no longer missed: in "100 USDT ($99.85)" the value in brackets is now caught.
  • Far fewer false matches: ordinary words and 1-2 letter symbols (like "all", "top", "dot" or a lone "d"/"m") are no longer mistaken for currencies.
  • Very short inputs like "1$" are now recognized.

Historical rate snapshots are now available, fiat currencies report their native symbols, and the discontinued DAI/TON endpoints were removed.

2026-05-08 • 1.3.0

Fixed exchange rates and accelerated parser

  • Fixed a critical caching bug: exchange rates now actually update every 12h (fiat) / 15s (crypto). Previously the bot was returning values from the file fallback (24+ hours old) for months
  • Fixed socket leak – the API no longer requires a restart due to port exhaustion after weeks of uptime
  • Support for 3-word currency names: british pound sterling, hong kong dollar, new zealand dollar, south korean won, united states dollar, британський фунт стерлінгів, etc.
  • Fractional currency units now convert to the main unit: kopecks, cents, grosze, satoshi, tiyn, eurocents (50 копеек → 0.5 RUB, 100,000,000 satoshi → 1 BTC, 25 копійок → 0.25 UAH)
  • German numerals (einundzwanzig, dreihundert) with auto-correction of single-character typos; fixed zwei millionen → 2,000,000 (previously a library bug → 1,000,000)
  • Conjunctions: "twenty and three usd", "двадцять і три долара", "zwei und dreißig euro" now correctly aggregate into a single sum
  • Over 150 new currency symbols; $ collisions are resolved by actual popularity in chats
  • Belarusian context (be/ru words and the letter ў) automatically switches RUB → BYN: "5 рублёў", "сорак два рублі", "пяцьдзесят капеек", "100 беларускіх рублёў"
  • Lei/leu now defaults to MDL (previously unpredictably RON) – based on real chat statistics
  • MATIC → POL: support for the new Polygon ticker (September 2024); old messages with matic/матик/матік still resolve
  • BUSD removed (Paxos discontinued issuance in February 2024, Binance delisted)
  • DAI removed
  • "sixteen tons" is no longer recognized as TON – short ISO codes (USD, BTC, TON, NZD) now only match whole words, but "100 ton" still works
  • "british"/"британский" are no longer tagged as BYN – the Br/бр abbreviation now only matches whole words
  • "100 долго" (Russian "long") is no longer recognized as USD – analogous prefix-matching issue with the "дол" abbreviation
  • "100 рублей за штуку" no longer adds a phantom "1000 RUB"
  • Added a webhook that will help us detect stale exchange-rate issues faster

The parser is on average 16× faster and uses 13× less memory – less server load, lower response latency, and headroom for scaling.

2024-08-21 • 1.2.0

Math-To-Number and other

  • Math-To-Number: added a parser for mathematical expressions. For example, (22 + 3) * 5 is converted to 125.
  • Added a new type of parser - advanced. It uses W2N and M2N.
  • Other minor changes to the bot functionality.

We are pleased to introduce Math-To-Number, a new module in our API that, like Word-To-Number in the past, will expand the capabilities of bots. Read more in the FAQ section.

2024-08-09 • 1.1.12

Small fixes

  • Fix for TAKE
  • Fix for TON

The TON rate is now received from Binance

FAQ

How do you add new crypto

There are three reasons why we add new cryptocurrencies. The first option is that we check the list of cryptocurrencies from time to time and see which new cryptocurrencies have a capitalization of more than $1 billion and a daily trading volume of more than $200 million. The second option is at the request of our users, but on the same terms as the first option. The third option is that we add cryptocurrencies of our partners.

What is Math-To-Number

M2N – Math-To-Number (also known as Math-To-Num and M2N) – is an algorithm that can recognize numbers written as mathematical expressions rather than ready-made digits (for example, "2+2" or "10*5-3"). M2N supports basic arithmetic operations (addition, subtraction, multiplication, division) and automatically normalizes different variants of signs (for example, "–", "—", "÷").

What is Word-To-Number

Word-To-Number (also known as Word-To-Num and W2N) is an algorithm that can recognize numbers written in words instead of numbers (for example, "twenty five"). W2N can also recognize words that are spelled with a small number of errors (for example, "twinty five").

When will the ExRates Connect API become public

No earlier than 2027

Where do you get the exchange rates from

Fiat exchange rates are received from Fixer.io, crypto exchange rates are received from Binance with some rare exceptions.