Tổng quan API

API Reference

Crypto Scanner Pro cung cấp RESTful API tại /api/v1/.

Base URL

Production: https://api.cryptoscanner.pro/api/v1
Sandbox:    https://api.sandbox.cryptoscanner.pro/api/v1

Authentication

API sử dụng JWT Bearer token hoặc API Key:

# JWT Token
curl -H "Authorization: Bearer <token>" https://api.cryptoscanner.pro/api/v1/signals
# API Key
curl -H "X-API-Key: <api_key>" https://api.cryptoscanner.pro/api/v1/signals

Response Format

Thành công

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "pageSize": 50,
    "total": 100,
    "totalPages": 2
  }
}

Lỗi

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired token"
  }
}

Rate Limiting

  • Free: 10 requests/phút
  • Basic: 60 requests/phút
  • Pro: 300 requests/phút
  • Enterprise: 1000 requests/phút Headers phản hồi:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1700000000

Pagination

Tất cả endpoints list đều hỗ trợ phân trang:

GET /api/v1/signals?page=1&pageSize=50&sort=createdAt:desc

WebSocket

Kết nối real-time tại:

wss://api.cryptoscanner.pro

Events:

  • signal:new — Tín hiệu mới
  • signal:update — Cập nhật tín hiệu
  • trade:opened — Lệnh mới được mở
  • trade:closed — Lệnh đã đóng
  • pnl:update — Cập nhật PnL
  • risk:alert — Cảnh báo rủi ro
  • price:update — Cập nhật giá