API Overview

Base URL: https://api.cliqi.bot/api

All authenticated endpoints require: Authorization: Bearer <jwt_token>

---

Endpoints Overview

Mount	Auth	Key Endpoints
/api/auth	Public/JWT	X OAuth, Privy login, /me, logout, Telegram connect
/api/wallet	JWT	Balances, deposits, withdrawals, token holdings
/api/trades	JWT	Buy, sell, swap, portfolio, PnL, trade history
/api/settings	JWT	Trading parameters, pause/resume
/api/premium	JWT	Subscribe, status, pricing, payment history
/api/admin	Bearer	Platform stats (admin only)

---

Error Responses

All endpoints return errors in this format:

{ "error": "Human-readable error message" }

Status	Meaning
400	Bad request / validation error
401	Missing or invalid JWT token
404	Resource not found
429	Rate limited — try again later
500	Internal server error
503	Service not configured (e.g., ADMIN_SECRET missing)

---

Real-Time Updates

CLIQI uses Socket.IO for real-time events. See the WebSocket Events page for connection details and event reference.