HitechCloud v2
VI EN
Portal Lấy khoá API
Tài chính & Tỷ giá fx/convert

Quy đổi một số tiền giữa hai đồng tiền

Tự chọn tuyến quy đổi và nói rõ đã đi đường nào trong trường `tuyen`. Có VND thì dùng giá ngân hàng niêm yết: đổi ngoại tệ sang VND lấy giá ngân hàng MUA (mặc định mua chuyển khoản, đổi bằng `rate_type=cash`), đổi VND sang ngoại tệ lấy giá ngân hàng BÁN. Cặp ngoại tệ thuần dùng tỷ giá tham chiếu ECB. Đồng nào chỉ một nguồn có thì bắc cầu: đồng có trong bảng ECB mà ngân hàng không niêm yết (PLN, SEK…) đi qua USD; đồng ngân hàng niêm yết mà ECB không công bố (KWD, SAR, RUB) đi qua VND. Số tiền vào và ra đều là chuỗi thập phân, tính bằng số học thập phân chính xác chứ không phải số thực; kết quả làm tròn theo số chữ số lẻ của đồng đích (VND, JPY, KRW làm tròn về số nguyên) và kèm cả giá trị chưa làm tròn.

GET https://api-tools.hitechcloud.vn/api/fx/convert Đã chép
Cần khoá API

Tham số

from string · truy vấn bắt buộc

Mã đồng tiền nguồn theo ISO 4217, ví dụ USD.

to string · truy vấn bắt buộc

Mã đồng tiền đích theo ISO 4217, ví dụ VND.

amount string · truy vấn

Số tiền cần quy đổi, gửi dạng chuỗi để khỏi mất chính xác. Tối đa 15 chữ số phần nguyên và 8 chữ số thập phân. Mặc định 1.

rate_type enum · truy vấn

Cột giá ngân hàng dùng khi đổi ngoại tệ sang VND: transfer (mua chuyển khoản, mặc định) hoặc cash (mua tiền mặt). Không ảnh hưởng tới chiều VND sang ngoại tệ vì chiều đó luôn dùng giá bán ra.

Mã trả về

200 Thành công.
401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.
404 Không tìm thấy dữ liệu tương ứng.
429 Vượt hạn mức của khoá. Xem header Retry-After.