# Soren US Economic Statistics Oracle

> Soren US Economic Statistics Oracle is a paid API for AI agents from soren.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns a signed, timestamped US economic statistic (unemployment rate, CPI, nonfarm payroll, labor force participation, or average hourly earnings) from BLS, with a SHA-256 hash of the raw BLS bytes and an Ed25519 signature for cryptographic verification.

## Facts

- Endpoint: GET https://soren.com/v1/oracle/stat?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/soren-us-economic-statistics-oracle-d0fed7f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zPeFt23ykLwwalUjyMeAc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability soren-us-economic-statistics-oracle-d0fed7f9
```

Example prompt: Can you fetch the latest US unemployment rate from the BLS oracle and give me the signed, timestamped result along with its SHA-256 hash so I can verify it hasn't been revised later?

## When to prefer this

Choose this endpoint when you need a cryptographically verifiable, tamper-evident snapshot of a US economic statistic — especially when downstream use cases require proving what a figure WAS at a moment in time (contracts, audits, legal records, smart contracts) and cannot rely on BLS's own website, which revises data in place. Prefer this over direct BLS API calls when attestation, non-repudiation, or historical freeze-point proof is required.

## Known failure modes

- Invalid or unsupported BLS series/statistic type returns an error
- BLS upstream unavailable causes a fetch failure
- Payment not settled (x402) results in 402 Payment Required
- Signature verification fails if public key is fetched from wrong URL
- Stale data if BLS has not yet released the latest release for the period

## How this service works

A signed, timestamped US economic statistic from the Bureau of Labor Statistics — unemployment rate, CPI, nonfarm payroll, participation or average hourly earnings. Returns the latest figure with about a year of history, a SHA-256 of the exact bytes BLS returned, and an Ed25519 signature. Use it to prove what a figure WAS at a moment, because BLS revises its series. Verify with soren.com/oracle-key.json

## Output

Returns the latest value of the requested BLS statistic plus approximately one year of historical readings, a SHA-256 hash of the exact bytes BLS returned, an Ed25519 signature over those bytes, and a timestamp. The signature can be verified using the public key at soren.com/oracle-key.json, allowing anyone to prove the figure was exactly this value at this moment, even if BLS later revises the series.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "series"
     ],
     "properties": {
      "series": {
       "type": "string",
       "examples": [
        "unemployment_rate"
       ],
       "description": "One of: unemployment_rate, cpi, nonfarm_payroll, labor_force_participation, avg_hourly_earnings."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "value": {
   "units": "percent",
   "latest": {
    "year": "<YYYY>",
    "value": "<number>",
    "period_name": "<month>"
   },
   "recent": [
    {
     "year": "<YYYY>",
     "value": "<number>",
     "period_name": "<month>"
    }
   ],
   "series": "unemployment_rate",
   "series_id": "LNS14000000"
  },
  "source": {
   "name": "US Bureau of Labor Statistics",
   "licence": "Public domain (US Government work, 17 U.S.C. 105)."
  },
  "provenance": {
   "signature": {
    "value": "<base64>",
    "algorithm": "Ed25519"
   },
   "observed_at": "<ISO-8601 UTC>",
   "upstream_sha256": "<hex>"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soren-us-economic-statistics-oracle-d0fed7f9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from soren.com](https://www.zero.xyz/host/soren.com/llms.txt)