Convert Vietnamese Amounts in Words or Slang to Numbers

Turn Vietnamese written or colloquial amounts into numbers: “hai triệu rưỡi”, “2tr5”, “500k”, “1 tỷ 2”, “2 củ”; batch mode and amount extraction from text.

Result

Press “Run” to see the result.

The reverse of number-to-words for Vietnamese. The parser understands standard reading (hai nghìn không trăm hai mươi sáu, một trăm lẻ năm, ba mươi mốt, mười lăm nghìn), colloquial shortcuts (hai triệu rưỡi, trăm rưỡi, một tỷ hai = 1.2 billion, hai lăm nghìn, nửa triệu), shop and chat slang (500k, 2tr5, 1k2, 2 củ, 1 tỏi, 2 lít), Vietnamese decimal and thousands separators (1,5 triệu, 1.500.000đ) and text typed without accents (hai trieu ruoi).

Each result has the value, the currency when one is written (đồng, đ, VNĐ, $, USD) or implied by slang, the amount read back in words, a confidence score and the alternative reading when the text is ambiguous (2tr5 could literally be 2,000,005; 1.500 could be 1.5). mode=extract finds every amount inside a sentence with its character positions, handy for chat orders or bank transfer notes; texts parses up to 1,000 strings at once.

Ranges such as “2-3 triệu” are returned as two amounts, and digit sequences like “hai ba” are rejected as ambiguous instead of guessed.

Use this in your code

curl "https://apibox.io.vn/v1/vn-number-parse?mode=extract&text=C%E1%BB%8Dc%202tr5%2C%20c%C3%B2n%20l%E1%BA%A1i%20m%E1%BB%99t%20tri%E1%BB%87u%20hai%20tr%C4%83m%20ngh%C3%ACn%20%C4%91%E1%BB%93ng%2C%20ship%2030k" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-number-parse?mode=extract&text=C%E1%BB%8Dc%202tr5%2C%20c%C3%B2n%20l%E1%BA%A1i%20m%E1%BB%99t%20tri%E1%BB%87u%20hai%20tr%C4%83m%20ngh%C3%ACn%20%C4%91%E1%BB%93ng%2C%20ship%2030k', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-number-parse?mode=extract&text=C%E1%BB%8Dc%202tr5%2C%20c%C3%B2n%20l%E1%BA%A1i%20m%E1%BB%99t%20tri%E1%BB%87u%20hai%20tr%C4%83m%20ngh%C3%ACn%20%C4%91%E1%BB%93ng%2C%20ship%2030k",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-number-parse?mode=extract&text=C%E1%BB%8Dc%202tr5%2C%20c%C3%B2n%20l%E1%BA%A1i%20m%E1%BB%99t%20tri%E1%BB%87u%20hai%20tr%C4%83m%20ngh%C3%ACn%20%C4%91%E1%BB%93ng%2C%20ship%2030k');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

API documentation → Get a free API key

FAQ

How is “2tr5” read?

As 2,500,000: digits after a unit are the next fraction (like “2 triệu 5 trăm nghìn”). The literal reading 2,000,005 is returned as an alternative.

Does it work without accents?

Yes for single amounts (“hai trieu ruoi”). In extraction mode unaccented words need a unit (trieu, nghin…) to avoid false matches.

Which slang is supported?

k / nghìn / ngàn, tr / triệu / củ, tỷ / tỉ / tỏi, lít and xị (100,000), chục, rưỡi and nửa.