Vnstock Logo

API Rate Limit Là Gì? Cách Xử Lý Giới Hạn API Trong Vnstock

12/04/2025đọc 7 phút
API Rate Limit Là Gì? Cách Xử Lý Giới Hạn API Trong Vnstock
Nguồn của bạn

Chọn nguồn bạn có khoá, mã trên trang sẽ điền theo. Chưa chọn thì mã giữ chỗ trống <nguồn>. Nguồn xếp theo bảng chữ cái, không phải khuyến nghị.

Bạn đang chạy chương trình phân tích dữ liệu chứng khoán Việt Nam thì gặp mã lỗi HTTP 429 từ Open API của nguồn, kèm lời nhắc thử lại sau vài giây, rồi chương trình dừng. Bài này giải thích giới hạn đó đến từ đâu và cách làm việc trong giới hạn.

I. API1 Rate Limit là gì?

API Rate Limit
API Rate Limit (giới hạn tốc độ API) là cơ chế kiểm soát số lượng request mà một người dùng, ứng dụng hoặc IP[^3] có thể gửi đến API trong một khoảng thời gian nhất định. Đây là phương pháp phổ biến giúp các nhà cung cấp API điều tiết lưu lượng truy cập, đảm bảo hiệu suất và tính khả dụng của hệ thống.

Các loại API Rate Limit phổ biến

  1. Rate limit theo thời gian:
    • Request/giây (RPS)
    • Request/phút (RPM)
    • Request/giờ (RPH)
    • Request/ngày (RPD)
  2. Rate limit theo nguồn:
    • Theo IP
    • Theo tài khoản/API key
    • Theo ứng dụng
  3. Rate limit theo endpoint:
    • Giới hạn khác nhau cho từng endpoint cụ thể
    • Giới hạn chung cho toàn bộ API

Cách nhận biết khi đạt giới hạn request của API

Khi đạt đến giới hạn request hay Rate Limit, API thường trả về mã lỗi HTTP 4292 cùng với thông báo lỗi cụ thể. Nhiều API còn cung cấp thông tin trong header response3 về số request còn lại, thời gian đợi trước khi có thể gọi lại API, v.v.

II. Giới hạn truy cập khi dùng Vnstock thế hệ 6

Ở thế hệ 6, bạn dùng Open API chính thức của nguồn bạn chọn, như công ty chứng khoán nơi bạn có tài khoản, bằng khoá của chính bạn. Khoá nằm trên máy bạn và truy vấn đi thẳng từ máy bạn tới nguồn. Vì vậy giới hạn tần suất là của nguồn: mỗi nguồn công bố số yêu cầu được phép theo giây, phút hoặc ngày cho từng loại tài khoản, và trả mã 429 khi vượt.

Vnstock thế hệ 6 không áp hạn mức lượt gọi từ phía Vnstock. Khi nguồn từ chối vì vượt giới hạn, thư viện báo lỗi có mã và gợi ý thời gian chờ thay vì trả về bảng rỗng. Giới hạn cụ thể của từng nguồn nằm trong tài liệu Open API của nguồn và trang Nguồn dữ liệu.

III. Vì sao nguồn áp dụng API Rate Limit?

1. Giữ hệ thống của nguồn ổn định

Mỗi Open API phục vụ rất nhiều tài khoản cùng lúc. Giới hạn tần suất giúp không tài khoản nào chiếm hết năng lực xử lý của hệ thống.

2. Phân bổ công bằng giữa người dùng

Giới hạn theo tài khoản hoặc theo khoá giúp mọi người dùng API của nguồn có cùng điều kiện truy cập.

3. Hạn chế truy cập bất thường

API Rate Limit cũng hạn chế các mẫu truy cập bất thường, chẳng hạn vòng lặp gửi yêu cầu liên tục không kiểm soát, vốn có thể bị nhìn nhận giống lưu lượng tấn công từ chối dịch vụ (DDoS)4.

IV. Năm cách làm việc trong giới hạn của nguồn

Bạn có thể áp dụng một số cách sau để chương trình chạy ổn định trong giới hạn của nguồn:

1. Bổ sung thời gian nghỉ giữa các requests

Đây là phương pháp đơn giản nhất, thêm thời gian nghỉ (delay) giữa các lần gọi API để giãn nhịp gửi yêu cầu khi bạn dùng vòng lặp tải dữ liệu cho nhiều mã.

Python
import time
from tqdm import tqdm
from vnstock import Market, Reference

# Truy xuất danh sách mã trong VN30 (danh sách rổ lấy từ nguồn ssi)
vn30 = Reference("ssi").index("VN30").members()['symbol']
# Chỉ giữ lại những mã bạn thật sự theo dõi; dữ liệu đã tải nên lưu lại để dùng lại
# Tạo vòng lặp tải dữ liệu, sử dụng tqdm[^7] hiển thị tiến độ
for symbol in tqdm(vn30, desc='Đang xử lý các mã VN30'):
	df = Market("<nguồn>").equity(symbol).ohlcv(start='2024-01-01', end='2024-12-31')
	df['symbol'] = symbol
	print(df)
	# nghỉ 1s trước khi chuyển sang mã tiếp theo
	time.sleep(1)
  • Ưu điểm: Dễ thực hiện.
  • Nhược điểm: Chương trình chạy lâu hơn, đổi lại tải lên nguồn đều đặn. Độ trễ cố định (hard delay) chưa thích ứng được với tốc độ phản hồi thực tế của từng request, có thể kết hợp thêm cách ở mục 5.

2. Chọn nguồn phù hợp với loại dữ liệu

Chọn nguồn phù hợp với loại dữ liệu cần truy vấn giúp giảm số yêu cầu phải gửi.

  • Với dữ liệu lịch sử OHLCV5 kéo dài nhiều năm, một số nguồn cần nhiều yêu cầu phụ hơn để ghép đủ khoảng thời gian, nên tổng số lượt gọi tăng lên.
  • Chỉ truy vấn đúng khoảng thời gian và loại dữ liệu bạn cần thay vì tải lại toàn bộ.

3. Thiết lập bộ đếm để giữ nhịp gọi

Phương pháp này giúp theo dõi số lượng request đã gửi và tự động giãn nhịp gọi API. Bạn có thể tạo một bộ đếm đơn giản để theo dõi số lượng request và tự động tạm dừng khi gần chạm giới hạn của nguồn.

Nguyên tắc hoạt động:

  • Theo dõi số lượng request đã thực hiện trong 1 phút

  • Nếu gần chạm giới hạn, tự động đợi trước khi tiếp tục

  • Reset bộ đếm sau mỗi phút

  • Ưu điểm: Quản lý request chủ động, tối ưu hóa thời gian chờ

  • Nhược điểm: Cần thêm logic để quản lý bộ đếm

4. Sử dụng caching để giảm số lượng request

Lưu trữ kết quả API để tránh gọi lại những dữ liệu đã lấy trước đó.

Nguyên tắc hoạt động:

  • Lưu kết quả vào file hoặc bộ nhớ sau khi gọi API

  • Kiểm tra cache trước khi gọi API

  • Chỉ gọi API khi dữ liệu không có trong cache hoặc đã hết hạn

  • Ưu điểm: Giảm đáng kể số lượng request, tối ưu hiệu suất trong dài hạn

  • Nhược điểm: Dữ liệu có thể không phải là mới nhất khi lấy từ cache

5. Sử dụng thuật toán Exponential Backoff6

Phương pháp này tăng dần thời gian chờ sau mỗi lần gặp lỗi Rate Limit.

Nguyên tắc hoạt động:

  • Bắt đầu với thời gian chờ ngắn (ví dụ: 1 giây)

  • Khi gặp lỗi Rate Limit, tăng thời gian chờ theo cấp số nhân

  • Thử lại request sau thời gian chờ

  • Thêm yếu tố ngẫu nhiên để tránh đồng bộ hóa giữa các client

  • Ưu điểm: Xử lý lỗi tự động, thích ứng với điều kiện mạng và tải hệ thống

  • Nhược điểm: Có thể mất nhiều thời gian hơn nếu gặp nhiều lỗi liên tiếp

V. Câu hỏi thường gặp

Có cách nào vượt giới hạn của nguồn không?

Không nên. Giới hạn tần suất là điều kiện sử dụng API của nguồn. Cách hiệu quả là điều tiết lưu lượng: đặt khoảng nghỉ giữa các request, lưu dữ liệu cục bộ để dùng lại và chỉ cập nhật phần dữ liệu mới.

Làm sao để biết tôi đã sử dụng bao nhiêu request?

Một số nguồn trả thông tin số yêu cầu còn lại trong header phản hồi3; hãy xem tài liệu Open API của nguồn. Bạn nên chủ động ghi log hoặc xây dựng bộ đếm thời gian trong ứng dụng của mình để theo dõi và điều chỉnh tần suất cho phù hợp.

Tôi bị rate limit dù chỉ gửi rất ít request?

Có thể do ứng dụng gọi nhiều hàm khác nhau trên cùng một nguồn, hoặc một lời gọi lấy khoảng thời gian dài được nguồn chia thành nhiều trang, nên tổng số request cộng dồn chạm giới hạn của tài khoản.

Footnotes

  1. API (Application Programming Interface): Giao diện lập trình ứng dụng, phương thức kết nối để các phần mềm giao tiếp với nhau. ↩

  2. HTTP 429 (Too Many Requests): Mã phản hồi tiêu chuẩn của giao thức HTTP cho biết máy khách đã gửi quá nhiều yêu cầu trong một khoảng thời gian cho phép. ↩

  3. Response Header (Tiêu đề phản hồi HTTP): Phần chứa siêu dữ liệu (metadata) được máy chủ gửi kèm trong phản hồi HTTP, cung cấp thông tin phụ về phản hồi như kiểu dữ liệu, độ dài, trạng thái giới hạn request (rate limit), v.v. ↩ ↩2

  4. DDoS (Distributed Denial of Service): Tấn công từ chối dịch vụ phân tán, phương thức làm nghẽn lưu lượng truy cập của máy chủ bằng cách gửi lượng yêu cầu khổng lồ từ nhiều nguồn. ↩

  5. OHLCV: Định dạng dữ liệu tài chính cơ bản gồm giá Mở cửa (Open), Cao nhất (High), Thấp nhất (Low), Đóng cửa (Close) và Khối lượng giao dịch (Volume). ↩

  6. Exponential Backoff: Thuật toán giảm tải bằng cách tăng dần thời gian chờ sau mỗi lần gửi yêu cầu thất bại theo cấp số nhân (ví dụ: 1s, 2s, 4s, 8s...). ↩

Bài liên quan