---
title: "Signed US economic statistic from the BLS"
method: GET
path: "/v1/oracle/stat"
---

# Signed US economic statistic from the BLS

`GET /v1/oracle/stat`

## Request

- Base URL: `https://soren.com`
- URL: `https://soren.com/v1/oracle/stat`
- Auth: none declared

Latest value plus about a year of history for a named BLS series, with a SHA-256 of the exact upstream bytes, the read time and an Ed25519 signature. Public domain data (17 U.S.C. 105); the attestation is what is sold, and it matters because BLS revises its series.

## Query parameters

- `series` 'unemployment_rate' | 'cpi' | 'nonfarm_payroll' | 'labor_force_participation' | 'avg_hourly_earnings', required

## Response `200`

Signed statistic.

- object
  - `value` object
  - `source` object
  - `provenance` object
  - `attestation` string
  - `settlement` string, nullable

## Other responses

- `400`: Missing or unknown series. Refused before payment; lists the supported series.
- `402`: Payment required.
- `404`: BLS returned no observations.
- `503`: BLS unavailable or declined to process.

---

[API](https://skmtc.dev/soren/apis/soren-free-games-api.md) · [All operations](https://skmtc.dev/soren/apis/soren-free-games-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soren/apis/soren-free-games-api/revisions/00402cfcf30d?raw)