API DataPro Crypto

Tài liệu kỹ thuật & hướng dẫn sử dụng API local server DataPro Crypto.

https://datapro.vn Crypto API Docs

Thông tin về API

API DataPro Crypto là local server chạy trên máy người dùng. Phần mềm DataPro Crypto mở một HTTP server tại http://localhost:5000 để các ứng dụng/công cụ khác có thể truy xuất dữ liệu thị trường tiền mã hoá theo thời gian thực.

Để sử dụng API, người dùng phải có gói dịch vụ DataPro Crypto đang hoạt động và phần mềm phải đang chạy. Nếu tài khoản không còn gói này, API và phần mềm sẽ không hoạt động.

API trả về kiểu dữ liệu CSV

Endpoint cơ sở

http://localhost:5000/api

Ping

Kiểm tra kết nối & trạng thái server.

  • Gọi API với định dạng: url của bạn + endpoint

  • GET Endpoint: /api/ping
  • Mô tả: Trả về Unix timestamp dạng plain text khi server đang hoạt động.

Ví dụ trả về

1715212800

Lấy thông tin coin

Trả về thông tin giá và khối lượng hiện tại của một hoặc tất cả các coin. Kết quả dạng CSV.

  • Gọi API với định dạng: url của bạn + endpoint

  • GET Endpoint: /api/info/{symbol?}
  • Tham số:
{symbol?}Mã coin (vd: BTC). Bỏ trống để lấy tất cả.

Ví dụ

/api/info/BTC(Lấy thông tin BTC)
/api/info(Lấy tất cả coins)

Trả về: CSV với cấu trúc

Tên cộtMô tả
SymbolMã giao dịch (vd: BTC)
StatusCodeTrạng thái (TRADING, BREAK)
OpenPxGiá mở cửa
HighPxGiá cao nhất
LowPxGiá thấp nhất
ClosePxGiá đóng cửa / hiện tại
RefPxGiá tham chiếu
TradeCountSố giao dịch
NameTên đầy đủ của coin
MatchedVolKhối lượng khớp
VolTổng khối lượng
QuoteVolKhối lượng quote
BidVolKhối lượng mua
BidPxGiá mua tốt nhất (best bid)
AskVolKhối lượng bán
AskPxGiá bán tốt nhất (best ask)

Trade - Giao dịch gần đây

Lấy danh sách giao dịch gần nhất của một cặp coin. Kết quả dạng CSV.

  • Gọi API với định dạng: url của bạn + endpoint

  • GET Endpoint: /api/trade/{symbol}/{depth}
  • Tham số:
{symbol} (bắt buộc): Mã tiền điện tử (VD: BTC)
{depth} (bắt buộc): Số lượng giao dịch (1-1000)

Ví dụ

/api/trade/BTC/1 1 giao dịch gần nhất của BTC
/api/trade/ETH/100 100 giao dịch gần nhất của ETH

Trả về: CSV với cấu trúc

Tên cộtMô tả
IDMã giao dịch
PXGiá
QTYKhối lượng
QUOTE_QTYGiá trị quote
TIMEThời gian (Unix milliseconds)
IS_BUYER_MAKERNgười mua là maker
IS_BEST_MATCHKhớp giá tốt nhất

Book - Sổ lệnh

Lấy danh sách lấy sổ lệnh một tiền điện tử. Kết quả dạng CSV.

  • Gọi API với định dạng: url của bạn + endpoint

  • GET Endpoint: /api/book/{symbol}/{depth}
  • Tham số:
{symbol} (bắt buộc): Mã tiền điện tử (VD: BTC)
{depth} (bắt buộc): Độ sâu sổ lệnh. Giá trị hợp lệ: 5, 10, 20, 50, 100, 500, 1000, 5000.

Ví dụ

/api/book/BTC/5(Tất cả giao dịch BTC từ đầu phiên)
/api/book/BTC/500(Từ thời điểm chỉ định)

Trả về: CSV với cấu trúc

Tên cộtMô tả
SIDELoại lệnh (bid = mua, ask = bán)
PXGiá
VOLKhối lượng

Hist - Dữ liệu lịch sử

Danh sách lịch sử giao dịch của một tiền điện tử. Kết quả dạng CSV.

  • Gọi API với định dạng: url của bạn + endpoint

  • GET Endpoint: /api/hist/{symbol}/{datatype}/{fromtime}/{totime}
  • Tham số:
{symbol}: Mã tiền điện tử (VD: BTC)
{datatype}: Loại dữ liệu. Giá trị hợp lệ: d, m (d: theo ngày, m: theo tháng)
{fromtime}: Thời gian bắt đầu (Unix timestamp). Mặc định: 0 (từ đầu)
{totime}: Thời gian kết thúc (Unix timestamp). Mặc định: 0 (đến cuối)

Quy tắc thời gian:

  • fromtime = 0: Lấy từ đầu (không giới hạn dưới)

  • totime = 0: Lấy đến cuối (không giới hạn trên)

  • Nếu totime > 0 thì totime phải lớn hơn fromtime

Ví dụ

/api/hist/BTC/dLấy dữ liệu lịch sử của tiền điện tử BTC theo ngày
/api/hist/BTC/m/1747648842/1779184842Lấy dữ liệu lịch sử của tiền điện tử BTC từ ngày 19/05/2025 đến 19/05/2026 theo tháng

Trả về: CSV với cấu trúc

Tên cộtMô tả
TRADING_TIMEThời gian (Unix timestamp)
TRADE_COUNTSố lượng giao dịch
OPEN_PXGiá mở cửa
HIGH_PXGiá cao nhất
LOW_PXGiá thấp nhất
CLOSE_PXGiá đóng cửa
VOLKhối lượng giao dịch
QUOTE_VOLKhối lượng báo giá
BUY_VOLKhối lượng mua
BUY_QUOTE_VOLKhối lượng báo giá mua
REF_PXGiá tham chiếu

Bắt đầu nhanh

  1. Đăng ký gói DataPro Crypto tại trang Mua.
  2. Tải & cài đặt phần mềm DataPro Crypto — đăng nhập bằng tài khoản đã mua.
  3. Khởi động phần mềm — local server sẽ tự động bật tại http://localhost:5000.

Mã lỗi thường gặp

Ý nghĩa
200Thành công
400Tham số không hợp lệ
404Không tìm thấy (endpoint không tồn tại hoặc không có dữ liệu cho symbol)
405Method không được hỗ trợ (chỉ GET)
429Rate limit - cần chờ trước khi gọi tiếp
500Lỗi server
503Không thể kết nối nguồn dữ liệu