---
title: "US recession signals: Sahm rule and prediction markets — $0.007"
method: GET
path: "/v1/data/macro/recession"
tags: ["data"]
---

# US recession signals: Sahm rule and prediction markets — $0.007

`GET /v1/data/macro/recession`

## Request

- Base URL: `https://x402.asterpay.io`
- URL: `https://x402.asterpay.io/v1/data/macro/recession`
- Auth: one of:
  - API key in header `PAYMENT-SIGNATURE`
  - HTTP payment

Sahm rule value computed from BLS unemployment (triggered at 0.50 pp) plus the most traded open recession markets on Polymarket with their current Yes probability. Source: BLS / Polymarket (public domain (BLS); Polymarket public API). Cadence: monthly; observed_at in the response is the upstream timestamp.

## Response `200`

US recession signals: Sahm rule and prediction markets

- object
  - `success` boolean, required
  - `data` object, required: Door-specific payload; see the door description and GET /v1/data for an example URL
  - `source` object, required
    - `name` string, required
    - `url` string, required
    - `license` string, required
  - `observed_at` string, nullable, required: Upstream publication/observation time (ISO 8601). Never the AsterPay fetch time.
  - `fetched_at` string, required: When AsterPay last fetched from the upstream
  - `cadence` 'live' | '5m' | '15m' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly', required
  - `next_expected` string, nullable: Earliest time a newer upstream value is expected
  - `cache_expires_at` string
  - `stale` boolean, required: true when the upstream failed and a cached copy under 24h old was served
  - `timestamp` string, required

## Other responses

- `402`: Payment Required — pay via x402 or MPP (USDC on Base, Ethereum, Polygon, Arbitrum, Optimism or SKALE), then retry. See the WWW-Authenticate and Payment-Required response headers, or the `accepts` array below. The example is the exact body the runtime returns (minus per-request extras such as example_response and extensions.bazaar).

---

[API](https://skmtc.dev/asterpay/apis/asterpay-data-api.md) · [All operations](https://skmtc.dev/asterpay/apis/asterpay-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterpay/apis/asterpay-data-api/revisions/97b4ab464b3b?raw)
