Telos API Reference
The Telos API provides programmatic access to multi-exchange crypto futures and CFD trading, AI agent signals, and on-chain prediction markets. All endpoints are authenticated via JWT bearer tokens. New to Telos? Start with our setup guide or explore AI department features.
REST
HTTP API · JSON · Rate-limited
WS
Real-time streams · Market data · Orders
SDK
TypeScript client library
BASE URL
https://api.telos.kentaursoft.com/v2Authentication
All API requests require a valid JWT access token in the Authorization header.
Obtaining a Token
/auth/login{
"username": "your_username",
"password": "your_password"
} {
"success": true,
"token": "eyJhbG...JWT_TOKEN",
"user": {
"username": "your_username",
"role": "user"
}
}Using the Token
Include the token in every request:
Authorization: Bearer <your_jwt_token> Content-Type: application/json
Token Expiry: Tokens expire after 24 hours. Use POST /auth/refresh to extend.
Trading APIs
Execute trades, manage positions, and monitor market data across connected exchanges.
/trading/ordersPlace a new order on a connected exchange.
{
"symbol": "BTCUSDT",
"side": "buy",
"type": "limit",
"price": 65000.00,
"quantity": 0.1,
"exchange": "binance",
"mode": "paper"
} /trading/positionsRetrieve all open positions across connected exchanges.
{
"positions": [
{
"symbol": "BTCUSDT",
"side": "long",
"size": 0.5,
"entry_price": 63200.00,
"mark_price": 64800.00,
"unrealized_pnl": 800.00,
"leverage": 3,
"exchange": "binance"
}
],
"total_margin": 10533.33
}/trading/orders/{orderId}Cancel an open order by ID.
{
"success": true,
"cancelled_order": "ord_abc123"
}/trading/marketsList available trading pairs and their current prices.
{
"markets": [
{
"symbol": "BTCUSDT",
"last_price": 64800.00,
"change_24h": 2.45,
"volume_24h": 1245000000,
"bid": 64795.00,
"ask": 64805.00
}
]
}Prediction Markets
Query and trade on-chain binary outcome markets powered by Polymarket.
/predictions/marketsBrowse all active prediction markets with optional category filter.
{
"markets": [
{
"id": "pm_abc123",
"question": "Will BTC reach a new ATH?",
"category": "crypto",
"yes_price": 0.50,
"no_price": 0.50,
"volume": "0",
"closing_time": "2026-12-31T23:59:59Z",
"liquidity": "0"
}
],
"total_markets": 0,
"total_volume": "0"
}/predictions/tradePlace a YES/NO position on a prediction market.
{
"market_id": "pm_abc123",
"outcome": "YES",
"amount": 100.00
}/predictions/positionsView your active prediction positions and P&L.
{
"positions": [
{
"market_id": "pm_abc123",
"question": "BTC to reach $150K by Dec 2026?",
"outcome": "YES",
"amount": 100.00,
"current_value": 142.50,
"pnl": 42.50
}
]
}Account
/account/profile{
"username": "your_username",
"role": "user",
"connected_exchanges": ["binance", "bybit"],
"trading_mode": "paper",
"created_at": "2026-01-15T08:30:00Z"
}/account/performanceTrading performance metrics and history.
{
"total_trades": 342,
"win_rate": 0.68,
"total_pnl": 12450.00,
"sharpe_ratio": 1.82,
"max_drawdown": 0.12,
"profit_factor": 2.34
}WebSocket Streams
Real-time data streams for market prices, order book updates, position changes, and AI signal notifications.
Connect
wss://api.telos.kentaursoft.com/v2/ws?token=<jwt_token>Subscribe to Channels
{
"type": "subscribe",
"channels": [
"market.BTCUSDT.ticker",
"market.BTCUSDT.orderbook",
"user.positions",
"user.orders",
"ai.signals"
]
}market.{symbol}.ticker
{
"channel": "market.BTCUSDT.ticker",
"data": {
"price": 64800.00,
"change_24h": 2.45,
"volume_24h": 1245000000
}
}user.positions
{
"channel": "user.positions",
"data": {
"positions": [...],
"updated_at": "2026-05-20T10:30:00Z"
}
}Error Codes
| Code | HTTP Status | Description |
|---|---|---|
| AUTH_001 | 401 | Invalid or expired JWT token |
| AUTH_002 | 403 | Insufficient permissions |
| TRADE_001 | 400 | Insufficient margin/balance |
| TRADE_002 | 400 | Risk gate blocked: exceeds max position size |
| TRADE_003 | 429 | Rate limit exceeded — 100 req/min per API key |
| EXCH_001 | 502 | Exchange connection error |
| GEN_001 | 500 | Internal server error |
Deep Dive Into Telos
Explore more features, security details, and capabilities.
AI Features
6 specialized AI departments analyzing markets in parallel.
Learn more →Supported Exchanges
Connect to 8+ major crypto exchanges with read-only API access.
Learn more →Backtesting
Test strategies against historical data before going live.
Learn more →AI Strategies
Pre-built strategies powered by multi-department AI consensus.
Learn more →How It Works
Understand the full AI trading pipeline from signal to execution.
Learn more →Pricing Plans
Private beta, upgrade when you need more power.
Learn more →