Skip to main content
GET
/
api
/
signals
Signals
curl --request GET \
  --url https://api.example.com/api/signals
{
  "signals": [
    {
      "id": "<string>",
      "headline": "<string>",
      "explanation": "<string>",
      "source": "<string>",
      "implication": "<string>",
      "category": "<string>",
      "severity": "<string>",
      "timestamp": "<string>",
      "tags": [
        {}
      ],
      "geography": "<string>",
      "confidence": 123,
      "sectorImpacts": [
        {
          "sector": "<string>",
          "riskLevel": "<string>",
          "rationale": "<string>"
        }
      ],
      "timeHorizon": "<string>",
      "computedAt": "<string>",
      "patternConditions": [
        {
          "condition": "<string>",
          "value": "<any>",
          "met": true
        }
      ],
      "consecutivePeriods": 123,
      "historicalContext": {
        "nearestAnchor": "<string>",
        "similarity": 123,
        "outcome": "<string>",
        "lagWeeks": 123,
        "firstToBreak": "<string>"
      }
    }
  ],
  "count": 123,
  "lastUpdated": "<string>"
}
Returns the current set of consumer inflation signals, each with a headline, severity rating, sector impact analysis, and confidence score. Team+ subscribers receive additional fields including pattern conditions and historical context anchoring.

​
Authentication

Requires a valid JWT token in the Authorization header. 
Authorization: Bearer <token>

​
Query Parameters

​
geography
string
default:"US"
Target geography. Supported values: US, UK.
​
severity
string
Filter signals by severity level. One of high, medium, or low.
​
category
string
Filter signals by category (e.g., energy, housing, labour).
​
periods
number
default:1
Number of recent periods to include. Increase to retrieve signals from prior weeks.

​
Response

​
signals
array
Array of signal objects.
​
count
number
Total number of signals returned.
​
lastUpdated
string
ISO 8601 timestamp of the last data refresh.

​
Examples

curl -X GET "https://api.consumersignals.io/api/signals?geography=US&severity=high" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "signals": [
    {
      "id": "sig_20260328_energy_01",
      "headline": "Gasoline price divergence widening against seasonal norms",
      "explanation": "Retail gasoline prices are tracking 8% above the five-year seasonal average, diverging from crude oil benchmarks.",
      "source": "Energy market indicators",
      "implication": "Upward pressure on transport and logistics costs may flow through to consumer goods within 4-6 weeks.",
      "category": "energy",
      "severity": "high",
      "timestamp": "2026-03-28T12:00:00Z",
      "tags": ["energy", "gasoline", "transport"],
      "geography": "US",
      "confidence": 82,
      "sectorImpacts": [
        {
          "sector": "Consumer Discretionary",
          "riskLevel": "elevated",
          "rationale": "Higher fuel costs reduce disposable income and discretionary spending capacity."
        }
      ],
      "timeHorizon": "4-6 weeks",
      "computedAt": "2026-03-28T14:30:00Z",
      "consecutivePeriods": 3
    }
  ],
  "count": 1,
  "lastUpdated": "2026-03-29T04:12:00Z"
}