vnstock-next

Không gian làm việc của dự án phát triển phiên bản tiếp theo, kế thừa các yếu tố mang lại thành công của vnstock đến hiện tại.

Triết lý thiết kế

Dễ dàng để phổ cập tới số đông, đáp ứng nhu cầu đa dạng của người dùng

• Tham khảo mô tả tại đây

Mục tiêu phát triển

Tạo dựng kiến trúc mã nguồn chặt chẽ, có tính kế thừa để dễ dàng nâng cấp và mở rộng tính năng trong giai đoạn tới.

Nhận diện nhu cầu

• Cấu trúc hàm phân cấp, dễ nhớ và áp dụng cho nhiều lớp tài sản khác nhau. Ví dụ: stock.price.some_function() | commodity.price.some_function()) thay vì các hàm đơn lẻ thiếu trật tự và cần phải tra cứu mỗi khi dùng.
• Mô hình dữ liệu đầu ra cố định & chặt chẽ giúp dễ dàng lưu trữ vào cơ sở dữ liệu hoặc chuyển làm nguồn cấp cho các ứng dụng được liên kết để mở rộng tính năng. Ví dụ kết hợp các ứng dụng TA, Backtest, phân tích portfolio hiện có. Cân nhắc naming convention sử dụng snake_case
• Hỗ trợ automation testing giúp giảm thời gian kiểm tra, dễ phát hiện lỗi để đẩy nhanh thời gian phát hành khi quy mô của thư viện được mở rộng.
• Tối ưu cho performance. Cân nhắc sử dụng kết hợp với Polar cho các thành phần tính toán ưu tiên tốc độ xử lý và đa luồng.
• Cung cấp giải thích ý nghĩa của dữ liệu trả về (optional)

Cấu trúc thư viện

• vnstock-next
• docs
• tests
• data (optional)

Phân tích mẫu (ưu tiên)

Phân loại

Nhu cầu	Nhóm dữ liệu	Tên tiêu chuẩn	Mô tả
Phân tích kỹ thuật	Giá cổ phiếu	Quote	Cả realtime lẫn dữ liệu lịch sử
Phân tích kỹ thuật	Giá cổ phiếu	Quote	Cả realtime lẫn dữ liệu lịch sử
Phân tích kỹ thuật	Giá cổ phiếu	Quote	Cả realtime lẫn dữ liệu lịch sử
Phân tích cơ bản

Nhóm dữ liệu

Các nhóm chính:

• Stock & ETFs

• Index

• Future

• Commodity

• Forex

• Crypto

• CW

• Mutual Funds

• Company Fundamental

• Economics

• News

• ESG

Dữ liệu qua xử lý

• Chỉ báo

Dữ liệu mẫu

Xem chi tiết trong thư mục docs

Nguồn ý tưởng

Thư viện

Tên	Stars	Folks	Mô tả
OpenBB	25.3k	2.5k	-
yfinance	11k	2.1k	-
pandas_reader	2.8k	676	-
Nasdaq Data Link python	333	59

Nguồn cấp dữ liệu

Cách cấu trúc dữ liệu cho thấy một bức tranh toàn cảnh về các loại dữ liệu và đầu ra tiêu chuẩn của chúng.

Quốc tế

Tiêu chuẩn đang áp dụng trên các thị trường sôi động nhất thế giới.

Tên	Mô tả
FinancialModelingPrep
Alpha Vantage
Polygon	Mô tả cụ thể data type
Barchart	Mô tả cụ thể input/output
Tradier	Tham khảo API document
IEX Cloud	Tham khảo cách cấu trúc các nhóm dữ liệu
Nasdaq DataLink
Refinitive	Microsoft 365 tích hợp sẵn cho Excel
Fiinhub

Việt Nam

• Wefeed
• Fiintrade
• Vietstock
• FireAnt
• Fialda

Phân tích

Tên	Stars	Folks	Mô tả
pyfolio	5.3k	1.7k	Quản lý danh mục
pandas_ta	4.3k	871	Phân tích kỹ thuật

Endpoints

1. stock

• chart: dữ liệu vẽ đồ thị và tính toán chỉ báo kỹ thuật
  • search
  • info: thông tin cơ bản về mã cổ phiếu
  • candles: dữ liệu giá vẽ đồ thị nến, OHLCV
• trade
  • quote: dữ liệu khớp lệnh (dạng bảng chi tiết)
  • foreign_trade
  • proprietary_trade
• fundamental
  • company
    • overview: mô tả ngắn
    • profile: Mô tả dài cho từng công ty
    • shareholder
    • officer
    • subsidiary
    • insider_deal
    • event
    • news
  • finance
    • ratio
    • report
  • earning
  • dividend
• analysis
  • valuation

2. crypto

• chart
  • search
  • info
  • candles
• trade
  • quote

3. forex

• chart
  • search
  • info
  • candles
• trade
  • quote

4. commodity

• asset
  • gold
    • chart
      • search
      • info
      • candles
    • trade
      • quote