// SQUANT DESK · API REFERENCE

API REFERENCE

SQuant Desk REST API for institutional integrations. All endpoints return JSON with Content-Type application/json. Base URL: https://squantdesk.com

// AUTHENTICATION

BEARER TOKEN

Endpoints marked as AUTH require a Supabase JWT token. Get it from your authenticated session and include it in the Authorization.

// Obtener token (JavaScript / TypeScript)
const { data: { session } } = await supabase.auth.getSession()
const token = session?.access_token

// Usar en requests
fetch('https://squantdesk.com/api/vps/champions', {
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  }
})
# cURL
curl -H "Authorization: Bearer <token>" \
     https://squantdesk.com/api/public/engine-stats
// RATE LIMITS

USAGE LIMITS

PLAN
REQ / MIN
REQ / DAY
BURST
Free
10
200
3
PRO
60
5 000
10
Institutional
600
No limit
50

Exceeding the limit returns HTTP 429 with header Retry-After: <seconds>.

// ENDPOINTS

ENDPOINT REFERENCE

GET/api/public/engine-statsPUBLIC

Global state of the quantitative engine: backtests processed, win rate, drawdown, market regime and equity curve.

SAMPLE RESPONSE
{
  "total": 16386795,
  "rate_hr": 124075,
  "timeframes": 7,
  "by_tf": { "4h": 3472285, "1h": 5672653, "15m": 5696032 },
  "assets": 5,
  "live": true,
  "regime": "BULL",
  "equity": 11422.53,
  "equity_initial": 10000,
  "return_pct": 14.23,
  "profit_factor": 1.935,
  "max_dd_pct": -8.74,
  "win_rate": 59.1,
  "total_trades": 22,
  "computed_at": "2026-07-02T14:30:00Z"
}
GET/api/vps/championsAUTH

List of active champion models with out-of-sample metrics, walk-forward test and Monte Carlo per timeframe.

🔐Requires Authorization: Bearer <token>
SAMPLE RESPONSE
[
  {
    "slot": "4h_01",
    "sym": "BTCUSDT",
    "tf": "4h",
    "strategy": "PRO.MACD",
    "direction": "LONG",
    "grade": "A+",
    "cagr": 38.2,
    "win_rate": 61.4,
    "max_dd": -7.8,
    "profit_factor": 2.14,
    "mc_confidence": 0.87,
    "risk_pct": 2.5,
    "saved_at": "2026-07-02T12:00:00Z"
  }
]
GET/api/lp-signal/activeAUTH

Active LP signal approved by the system, with hypothesis, price range, Kelly sizing and projected days. Requires PRO plan.

🔐Requires Authorization: Bearer <token>
SAMPLE RESPONSE
{
  "signal": {
    "id": "uuid",
    "hyp": "bullish_lp",
    "hyp_text": "Rango alcista concentrado en soporte clave",
    "pool": "ETH/USDC",
    "fee_tier": "0.05%",
    "range_low_pct": -8.5,
    "range_high_pct": 12.0,
    "kelly_pct": 18.4,
    "days_projected": 14,
    "ref_price": 3480.22,
    "created_at": "2026-07-01T08:00:00Z",
    "expires_at": "2026-07-15T08:00:00Z"
  }
}
GET/api/community-setupsPUBLIC

Setups published by the community with reputation ≥ 10. Includes pair, type (LONG/SHORT/LP), entry, SL, TP and votes.

SAMPLE RESPONSE
[
  {
    "id": "uuid",
    "par": "BTCUSDT",
    "tipo": "LONG",
    "entry": 61500,
    "sl": 59800,
    "tp": 67000,
    "rr": 3.24,
    "timeframe": "4h",
    "votos_up": 12,
    "votos_down": 1,
    "estado": "ACTIVO",
    "created_at": "2026-07-01T10:00:00Z",
    "profiles": { "username": "sigma_trader", "reputation": 47 }
  }
]
POST/api/community-setupsAUTH

Publish a new setup. Requires reputation ≥ 10 on the authenticated user's profile.

🔐Requires Authorization: Bearer <token>
SAMPLE RESPONSE
// Body (application/json):
{
  "par": "ETHUSDT",
  "tipo": "SHORT",           // "LONG" | "SHORT" | "LP"
  "entry": 3480,
  "sl": 3650,
  "tp": 3100,
  "rr": 2.11,
  "timeframe": "1h",
  "metodologia": "OB + divergencia RSI en resistencia",
  "nota": "Invalidado si cierra > 3700"
}

// Response 201:
{ "id": "uuid", ... }
GET/api/motor/signalsAUTH

Active signals from the live engine: symbol, direction, HMM regime, confidence and timestamp.

🔐Requires Authorization: Bearer <token>
SAMPLE RESPONSE
{
  "regime": "BULL",
  "signals": [
    {
      "sym": "BTCUSDT",
      "tf": "4h",
      "direction": "LONG",
      "confidence": 0.78,
      "entry": 61500,
      "updated_at": "2026-07-02T14:00:00Z"
    }
  ]
}
// ERRORS

ERROR CODES

200OK — successful response
400Bad Request — invalid or missing parameter
401Unauthorized — missing, expired or invalid token
403Forbidden — plan without access to the requested endpoint
429Too Many Requests — rate limit exceeded
500Internal Server Error — error in the engine or database
503Service Unavailable — VPS engine not responding
// Estructura de error estándar
{
  "error": "Descripción del error",
  "code":  "ERROR_CODE"          // presente en algunos endpoints
}
// INSTITUTIONAL ACCESS

INSTITUTIONAL PLAN

⚡
Uncapped rate limits
600 req/min, no daily limit, burst of 50.
∑
Custom models
Backtests and champions parametrised by contract.
◎
White label available
Your own branding on top of the SIGMA infrastructure.
⊕
Guaranteed SLA
99.5% monthly uptime with proactive notifications.
Need institutional access or a custom integration?
Response time: < 24 business hours · No-obligation quote
CONTACT US →
SQuant Desk API v2 · 2026
TermsPrivacyContact