API Docs

Get daily trading signals in 3 steps.

Get Today's Signal

"What should I do today?"

curl "https://sectormomentums.com/api/signal?key=YOUR_API_KEY"

Response

{
  "action": "HOLD",
  "message": "Continue holding SOXL (100 shares @ $55).",
  "symbol": "SMH",
  "trade_symbol": "SOXL",
  "position": {
    "symbol": "SOXL",
    "shares": 100,
    "entry_price": 55,
    "current_price": 54.95,
    "pnl_pct": -0.1
  },
  "rankings": [["SMH", 60.4], ["XLE", 22.1], ...]
}

The message field tells you exactly what to do.

What the signals mean

BUYBuy the recommended ticker.

HOLDDo nothing. Your current position is good.

ROTATESell current, buy the new top sector.

SELLRisk detected. Close your position now.

CASHNo opportunity. Stay on the sidelines.

Update Your Position

Keep this current so your signals stay accurate.

I just bought something

curl -X POST "https://sectormomentums.com/api/position" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "action": "buy",
    "symbol": "SOXL",
    "shares": 500,
    "price": 55
  }'

I just sold everything

curl -X POST "https://sectormomentums.com/api/position" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "action": "sell",
    "price": 58
  }'

I'm not holding anything

curl -X POST "https://sectormomentums.com/api/position" \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_API_KEY", "action": "cash"}'

Check my current position

curl "https://sectormomentums.com/api/position?key=YOUR_API_KEY"

Quick Reference

• API Key — pass as ?key= for GET, or api_key in POST body.

• Signals refresh daily after US market close (~4:30 PM ET).

• Personalized — your signal depends on what you hold and when you bought it.

• No position recorded? The API will remind you to set one.