Chuỗi tỷ giá theo ngày giữa một đồng cơ sở và một hoặc nhiều đồng đích

Lấy từ tỷ giá tham chiếu ECB. ECB chỉ công bố vào ngày làm việc nên cuối tuần và ngày lễ không có mốc. KHÔNG phục vụ VND (trả 422 kèm mã lỗi `vnd_history_unavailable`): ECB không công bố tỷ giá cho đồng Việt Nam, còn bảng niêm yết VND thì chỉ tra được theo từng ngày nên không dựng được dải ngày — lấy từng ngày bằng GET api/fx/rates?date=YYYY-MM-DD.

GET https://api-tools.hitechcloud.vn/api/fx/history Đã chép

Cần khoá API

Tham số

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

Đồng cơ sở theo ISO 4217, ví dụ USD. Không nhận VND.

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

Một hoặc nhiều đồng đích cách nhau bằng dấu phẩy, ví dụ EUR,JPY. Không nhận VND.

start date · truy vấn bắt buộc

Ngày đầu dải, dạng YYYY-MM-DD.

end date · truy vấn

Ngày cuối dải, dạng YYYY-MM-DD. Bỏ trống để lấy tới mốc mới nhất ECB đã công bố.

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.

Ví dụ gọi

bash

curl --location 'https://api-tools.hitechcloud.vn/api/fx/history?from=GIA_TRI&to=GIA_TRI&start=GIA_TRI&end=GIA_TRI' \
--header 'X-API-Key: $HITECH_API_KEY' \
--header 'Accept: application/json'

php

$response = Http::withHeaders([
    'X-API-Key' => env('HITECH_API_KEY'),
])->get('https://api-tools.hitechcloud.vn/api/fx/history', [
    'from' => 'GIA_TRI',
    'to' => 'GIA_TRI',
    'start' => 'GIA_TRI',
    'end' => 'GIA_TRI',
]);

$data = $response->json();

javascript

const q = new URLSearchParams({
  from: 'GIA_TRI',
  to: 'GIA_TRI',
  start: 'GIA_TRI',
  end: 'GIA_TRI',
});

const res = await fetch(`https://api-tools.hitechcloud.vn/api/fx/history?${q}`, {
  headers: { 'X-API-Key': process.env.HITECH_API_KEY },
});

const data = await res.json();

python

import os, requests

res = requests.get(
    "https://api-tools.hitechcloud.vn/api/fx/history",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    params={
        "from": "GIA_TRI",
        "to": "GIA_TRI",
        "start": "GIA_TRI",
        "end": "GIA_TRI",
    },
)
data = res.json()

Đã chép mã

Thử ngay

X-API-Key

Khoá chỉ lưu trong trình duyệt của bạn. Lấy khoá →

from bắt buộc truy vấn

to bắt buộc truy vấn

start bắt buộc truy vấn

end truy vấn

Cùng nhóm

GET Quy đổi một số tiền giữa hai đồng tiền GET Giá tiền mã hoá theo một hoặc nhiều đồng đối c... GET Giá một đồng tiền mã hoá theo id dạng tên đầy... GET Danh mục mã tiền tệ API này phục vụ GET Bảng tỷ giá ngân hàng của một ngày: 20 ngoại t... GET Tỷ giá ngân hàng của một ngoại tệ theo mã ISO...