Skip to main content

​
GET /v1/macro/status

Return macro source-health, country coverage, freshness, and source-rights posture from runtime validation artifacts or an explicit degraded fallback
Audience: application and coding agent.

​
Canonical metadata

  • requestId
  • traceparent

​
Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/macro/status"

​
Example response

{
  "object": "macro_status",
  "status": "ready",
  "generatedAt": "2026-06-09T22:15:00.000Z",
  "artifactGeneratedAt": "2026-06-09T22:15:00.000Z",
  "computedAt": "2026-06-09T22:15:00.000Z",
  "statusSource": "validation_artifacts",
  "countries": [
    {
      "country": "US",
      "status": "ready",
      "seriesCount": 32,
      "freshCount": 32,
      "staleCount": 0,
      "sourceErrorCount": 0,
      "fallbackCount": 0,
      "latestMaterializedAt": "2026-06-01T00:00:00.000Z",
      "oldestFreshnessAgeHours": 560,
      "topAlerts": []
    }
  ],
  "sources": [
    {
      "sourceKey": "fred",
      "status": "ready",
      "indicatorCount": 33,
      "unexpectedFallbackCount": 0,
      "sourceErrorCount": 0,
      "artifactStatus": "available",
      "topAlerts": []
    }
  ],
  "alerts": [],
  "methodology": {
    "id": "macro_status_artifact_v1",
    "version": "v1",
    "summary": "Macro status is artifact-backed when runtime validation artifacts are available; otherwise it returns an explicit degraded runtime-registry fallback."
  },
  "sourceRights": {
    "posture": "public_safe_summary",
    "summary": "Status exposes source posture counts and freshness health, not credentials or raw vendor payloads."
  }
}

​
Give this prompt to your agent

​
Failure posture

  • treat non-2xx responses as contract-aware failures, not free-form errors
  • preserve requestId and traceparent in logs and downstream reports
  • if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff