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ột | Mô tả |
|---|---|
Symbol | Mã giao dịch (vd: BTC) |
StatusCode | Trạng thái (TRADING, BREAK) |
OpenPx | Giá mở cửa |
HighPx | Giá cao nhất |
LowPx | Giá thấp nhất |
ClosePx | Giá đóng cửa / hiện tại |
RefPx | Giá tham chiếu |
TradeCount | Số giao dịch |
Name | Tên đầy đủ của coin |
MatchedVol | Khối lượng khớp |
Vol | Tổng khối lượng |
QuoteVol | Khối lượng quote |
BidVol | Khối lượng mua |
BidPx | Giá mua tốt nhất (best bid) |
AskVol | Khối lượng bán |
AskPx | Giá 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ột | Mô tả |
|---|---|
ID | Mã giao dịch |
PX | Giá |
QTY | Khối lượng |
QUOTE_QTY | Giá trị quote |
TIME | Thời gian (Unix milliseconds) |
IS_BUYER_MAKER | Người mua là maker |
IS_BEST_MATCH | Khớ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ột | Mô tả |
|---|---|
SIDE | Loại lệnh (bid = mua, ask = bán) |
PX | Giá |
VOL | Khố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/d | Lấy dữ liệu lịch sử của tiền điện tử BTC theo ngày |
| /api/hist/BTC/m/1747648842/1779184842 | Lấ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ột | Mô tả |
|---|---|
TRADING_TIME | Thời gian (Unix timestamp) |
TRADE_COUNT | Số lượng giao dịch |
OPEN_PX | Giá mở cửa |
HIGH_PX | Giá cao nhất |
LOW_PX | Giá thấp nhất |
CLOSE_PX | Giá đóng cửa |
VOL | Khối lượng giao dịch |
QUOTE_VOL | Khối lượng báo giá |
BUY_VOL | Khối lượng mua |
BUY_QUOTE_VOL | Khối lượng báo giá mua |
REF_PX | Giá tham chiếu |
Bắt đầu nhanh
- Đăng ký gói DataPro Crypto tại trang Mua.
- Tải & cài đặt phần mềm DataPro Crypto — đăng nhập bằng tài khoản đã mua.
- 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
| Mã | Ý nghĩa |
|---|---|
200 | Thành công |
400 | Tham số không hợp lệ |
404 | Không tìm thấy (endpoint không tồn tại hoặc không có dữ liệu cho symbol) |
405 | Method không được hỗ trợ (chỉ GET) |
429 | Rate limit - cần chờ trước khi gọi tiếp |
500 | Lỗi server |
503 | Không thể kết nối nguồn dữ liệu |