Skip to main content
GET
/
api
/
signals
/
credibility
Signal Credibility
curl --request GET \
  --url https://api.example.com/api/signals/credibility
{
  "credibility": [
    {}
  ],
  "count": 123,
  "geography": "<string>"
}
Returns credibility assessments for signal types, enabling users to weight signals by their historical track record. Filter by geography and specific signal types.

​
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.
​
types
string
Comma-separated list of signal types to filter (e.g., energy_divergence,housing_momentum). Omit to return all types.

​
Response

​
credibility
array
Array of credibility records.
​
count
number
Total number of records returned.
​
geography
string
Geography code for the returned data.

​
Examples

curl -X GET "https://api.consumersignals.io/api/signals/credibility?geography=US&types=energy_divergence,housing_momentum" \
  -H "Authorization: Bearer <token>"

​
Example Response

{
  "credibility": [
    {
      "signalType": "energy_divergence",
      "credibilityScore": 0.81,
      "totalSignals": 47,
      "correctCalls": 38,
      "avgConfidence": 76,
      "lastEvaluated": "2026-03-28T00:00:00Z"
    },
    {
      "signalType": "housing_momentum",
      "credibilityScore": 0.72,
      "totalSignals": 35,
      "correctCalls": 25,
      "avgConfidence": 69,
      "lastEvaluated": "2026-03-28T00:00:00Z"
    }
  ],
  "count": 2,
  "geography": "US"
}