SignalShopper - API Documentation

Getting Started

The SignalShopper API allows you to programmatically access all quantitative signals available in your dashboard. Each signal has its own unique API key that you'll use for authentication.

Base URL

All API requests should be made to:

https://api.signalshopper.com/v1

Authentication

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Endpoints

Get Latest Signal

Retrieve the most recent data for a specific signal.

GET /signals/latest

Example Request:

curl -X GET "https://api.signalshopper.com/v1/signals/latest" \
-H "Authorization: Bearer sk_gamma_8f72hd92jd82h"

Example Response:

{
  "signal_id": "dealer_gamma",
  "timestamp": "2025-05-28T14:30:00Z",
  "data": {
    "spx_gamma": 3.42,
    "key_levels": [
      {"price": 4250, "gamma": 5.67},
      {"price": 4300, "gamma": 7.82},
      {"price": 4350, "gamma": 4.21}
    ],
    "dealer_positioning": "net_long",
    "market_impact": "moderate"
  }
}

Get Historical Signals

Retrieve historical data for a specific signal.

GET /signals/history?days=7

Parameters:

Parameter	Type	Description
days	integer	Number of days of historical data to retrieve (max: 30)
start_date	string	Optional start date in ISO format (YYYY-MM-DD)
end_date	string	Optional end date in ISO format (YYYY-MM-DD)

Rate Limits

The API has the following rate limits:

60 requests per minute
1000 requests per day

If you exceed these limits, you'll receive a 429 Too Many Requests response.

Error Codes

Status Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
403	Forbidden - You don't have access to this signal
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Need Help?

If you have any questions or need assistance with the API, please contact our support team:

api-support@signalshopper.com