Signal API Documentation

REST API for programmatic access to trading signals and portfolio data

Your API Credentials

API Key
pk_live_***********************3a7f
API Secret
sk_live_***********************9b2c

Rate Limits

1,000 requests per minute. Contact support for higher limits.

Authentication

Overview

All API requests require authentication using your API key in the header. 

# Include in all requests
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Trading Signals

GET /api/v1/signals/latest Get latest trading signals
Parameters
Name Type Description
strategy string Filter by strategy name (optional)
since ISO 8601 Return signals after this timestamp (optional)
Response
{
  "signals": [
    {
      "id": "sig_abc123",
      "strategy": "Trendlock",
      "symbol": "XLK",
      "action": "BUY",
      "weight": 0.4534,
      "timestamp": "2024-12-12T09:30:00Z",
      "confidence": 0.85
    }
  ],
  "meta": {
    "count": 4,
    "generated_at": "2024-12-12T09:31:00Z"
  }
}
Response Codes
200 OK 401 Unauthorized 429 Rate Limited
GET /api/v1/signals/history Get historical signals
Parameters
Name Type Description
start_date required YYYY-MM-DD Start date for history query
end_date YYYY-MM-DD End date (defaults to today)
strategy string Filter by strategy name
limit integer Max results (default: 100, max: 1000)

Portfolio Data

GET /api/v1/portfolio/allocation Current portfolio allocation
Response
{
  "allocation": {
    "Trendlock": 0.4534,
    "Slammin_Q": 0.3147,
    "Monthly_Flip": 0.1588,
    "Overnight": 0.0732
  },
  "last_rebalance": "2024-12-01T00:00:00Z",
  "next_rebalance": "2025-01-01T00:00:00Z"
}
GET /api/v1/portfolio/positions Current positions across strategies
Response
{
  "positions": [
    {
      "strategy": "Trendlock",
      "symbol": "XLK",
      "weight": 0.4534,
      "entry_date": "2024-12-05",
      "entry_price": 228.45
    },
    {
      "strategy": "Slammin_Q",
      "symbol": "QQQ",
      "weight": 0.3147,
      "entry_date": "2024-12-10",
      "entry_price": 525.30
    }
  ],
  "cash_weight": 0.0732,
  "as_of": "2024-12-12T16:00:00Z"
}
GET /api/v1/portfolio/performance Performance metrics
Parameters
Name Type Description
period string mtd, qtd, ytd, 1y, 3y, inception (default: ytd)
Response
{
  "period": "ytd",
  "metrics": {
    "total_return": 0.2890,
    "annualized_return": 0.2890,
    "sharpe_ratio": 2.71,
    "sortino_ratio": 5.36,
    "max_drawdown": -0.0566,
    "volatility": 0.1067,
    "beta": 0.263,
    "correlation": 0.43
  },
  "benchmark": {
    "symbol": "SPY",
    "total_return": 0.177
  }
}

Returns Data

GET /api/v1/returns/daily Daily returns time series
Parameters
Name Type Description
start_date YYYY-MM-DD Start date (default: 1 year ago)
end_date YYYY-MM-DD End date (default: today)
format string json or csv (default: json)
GET /api/v1/returns/monthly Monthly returns summary
Response
{
  "returns": [
    { "month": "2024-01", "return": 0.0312 },
    { "month": "2024-02", "return": 0.0178 },
    { "month": "2024-03", "return": 0.0245 }
  ]
}