Tài Liệu API REST
Hướng dẫn toàn diện về các loại giao diện API REST và phương thức xác thực của SunPerp.
Loại Giao Diện
Có hai loại giao diện, bạn có thể chọn loại phù hợp theo tình huống và sở thích của mình.
REST API
REST (Representational State Transfer) là một trong những cơ chế giao tiếp phổ biến nhất dưới HTTP, mỗi URL đại diện cho một loại tài nguyên.
Được khuyến nghị cho: Nên sử dụng Rest API cho các thao tác một lần, như giao dịch và rút tiền.
WebSocket API
WebSocket là một giao thức mới trong HTML5. Nó hỗ trợ giao tiếp hai chiều đầy đủ giữa client và server. Kết nối có thể được thiết lập bằng một lần bắt tay duy nhất, sau đó server có thể chủ động đẩy thông báo đến client.
Được khuyến nghị cho: Nên sử dụng WebSocket API để nhận cập nhật dữ liệu, như dữ liệu thị trường và cập nhật lệnh.
Xác Thực
Cả hai API đều có hai cấp độ xác thực:
API Công Khai
Dành cho thông tin cơ bản và dữ liệu thị trường. Không cần xác thực.
✓ Không cần xác thực
✓ Truy cập dữ liệu thị trường
✓ Thông tin cơ bản
API Riêng Tư
Dành cho các thao tác liên quan đến tài khoản như giao dịch và quản lý tài khoản. Mỗi API riêng tư phải được xác thực bằng API Key.
🔐 Yêu cầu API Key
🔐 Thao tác giao dịch
🔐 Quản lý tài khoản
Điểm Cuối API Chính
Dữ Liệu Thị Trường
GET /api/v1/ticker
Thông tin ticker 24h
GET /api/v1/orderbook
Sổ lệnh thị trường
GET /api/v1/trades
Lịch sử giao dịch gần đây
GET /api/v1/klines
Dữ liệu biểu đồ nến
Giao Dịch (Yêu Cầu API Key)
POST /api/v1/order
Tạo lệnh mới
DELETE /api/v1/order
Hủy lệnh
GET /api/v1/orders
Lấy danh sách lệnh
GET /api/v1/positions
Thông tin vị thế