REST endpoints

# newest first (default)
/v1/backtests?limit=20

# best Sharpe on BTC or ETH, 4h, first half of 2025
/v1/backtests?asset=BTCUSDT,ETHUSDT&timeframe=4h&sort=sharpe_ratio&order=desc&from=2025-01-01&to=2025-06-30

# one tag, highest return first
/v1/backtests?tag=breakout&sort=total_return&order=desc

# 1. parse plain English
curl -X POST https://www.texttoquant.com/api/v1/parse \
  -H "Authorization: Bearer ttq_..." -H "Content-Type: application/json" \
  -d '{"query":"Buy BTCUSDT on the 4h when RSI(14) crosses above 30, sell at 6% profit or 3% stop loss, last 2 years"}'

# 2. run it (bills one backtest)
curl -X POST https://www.texttoquant.com/api/v1/backtests \
  -H "Authorization: Bearer ttq_..." -H "Content-Type: application/json" \
  -d '{"parsedQuery": <the object from step 1>}'

# 3. read your results
curl "https://www.texttoquant.com/api/v1/backtests?limit=10" \
  -H "Authorization: Bearer ttq_..."

{
  "success": true,
  "data": {
    "analysisId": "a1b2c3d4-e5f6-…",
    "query": "Buy BTCUSDT on the 4h when RSI(14) …",
    "backtestResults": {
      "summary": {
        "totalReturnPct": 42.3,
        "winRate": 60.4,
        "sharpeRatio": 1.82,
        "maxDrawdownPct": 11.7,
        "profitFactor": 1.9,
        "totalTrades": 48
      },
      "grading": { "grade": "B+", "score": 78 }
    }
  }
}

{
  "metrics": {
    "probabilityScan": {
      "totalSignals": 647,
      "resolvedSignals": 631,
      "pendingSignals": 16,
      "successRate": 27.7,
      "edge": {
        "breakevenRatePct": 26.1,
        "edgePts": 1.6,
        "expectancyPct": 0.026,
        "payoffRatio": 2.83,
        "ci95": { "low": 24.3, "high": 31.2 },
        "verdict": "inconclusive",
        "minSampleForVerdict": 30
      },
      "execution": {
        "takenSignals": 544,
        "skippedSignals": 87,
        "skippedEdgePts": -1.4,
        "modelFidelity": { "compared": 544, "agreementPct": 91.2, "medianAbsDeltaPts": 0.31 }
      },
      "successDefinition": "exit_targets",
      "unmodelledExits": ["indicator_signal"],
      "signalCount": 647
    }
  }
}

# start async → 202 { "analysisId": "…", "status": "running" }
curl -X POST https://www.texttoquant.com/api/v1/backtests \
  -H "Authorization: Bearer ttq_..." -H "Content-Type: application/json" \
  -d '{"parsedQuery": <the object from /v1/parse>, "wait": false}'

# cancel it, refunds the credit only if the run is still queued
curl -X POST https://www.texttoquant.com/api/v1/backtests/<analysisId>/cancel \
  -H "Authorization: Bearer ttq_..."

{ "success": true,
  "data": { "analysisId": "…", "status": "cancelled", "refunded": true, "reason": "queued_removed" } }

# 1. discover your saved indicator names
GET /v1/indicators

# 2. parse with hints so conditions are tagged custom
POST /v1/parse
{ "query": "Buy BTCUSDT 1d when my_osc crosses above 0, from 2023-01-01 to 2025-01-01",
  "customIndicatorHints": ["my_osc"] }

# 3. run with the name mapping
POST /v1/backtests
{ "parsedQuery": { }, "savedIndicatorMapping": { "my_osc": "my_osc" } }

# register (max 3 active; https + public host only)
POST /v1/webhooks
{ "url": "https://yourapp.com/ttq-hook", "events": ["backtest.completed"] }
→ { "id": "…", "secret": "whsec_…" }   # store the secret NOW

# every delivery is signed:
#   X-TTQ-Signature: t=<unix>,v1=<hex hmac-sha256(secret, `${t}.${rawBody}`)>
# verify: recompute the HMAC over `${t}.${rawBody}` and compare constant-time

# payload
{ "id": "evt_…", "event": "backtest.completed",
  "data": { "analysisId": "…", "status": "completed", "resultUrl": "/v1/backtests/…" } }