# x402-factory Nonfarm Payrolls (BLS)

> x402-factory Nonfarm Payrolls (BLS) is a paid API for AI agents from x402-factory.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Returns the latest BLS nonfarm payrolls print with first-release vs revised values, surprise vs expectation, next release date, and a 12-month mini-series.

## Facts

- Endpoint: GET https://x402-factory.com/v1/econ/payrolls?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-factory-nonfarm-payrolls-bls-6ac1a80c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LiCmlvg9i6CGjw9_AOBKr

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 x402-factory-nonfarm-payrolls-bls-6ac1a80c
```

Example prompt: What was the latest nonfarm payrolls number from the BLS — did it beat expectations, and how much was it revised from the initial release?

## When to prefer this

Use this endpoint when you need a ready-made, structured payrolls data package that bundles first-release vs revised values, surprise vs labeled expectation (with market-implied probability when available), and the next release date — all in one call at $0.02. Prefer this over raw FRED API calls when you need revision-aware data or want surprise calculations without building your own trend model or prediction market lookup.

## Known failure modes

- FRED/ALFRED data unavailable — upstream service outage returns 503
- Stale data if BLS has not yet published the current month's release
- No market-implied expectation available — falls back to trend-model expectation source
- Missing or null surprise field if expectation cannot be computed
- Payment not included or invalid — returns 402 Payment Required

## How this service works

Nonfarm payrolls (BLS, monthly): latest print, revisions, surprise — Latest Nonfarm payrolls print from the BLS via FRED/ALFRED: first-release vs latest value with a revised flag (revisions never pose as print-day numbers), surprise vs a labeled expectation (market-implied when a matching prediction market exists, else trend-model), next monthly release date, and a 12-observation mini-series.…

## Output

Returns a JSON object with: the FRED series ID and title, latest print details (observation date, headline value, units, first-release vs latest value, revised flag), a surprise object (actual, expected, surprise magnitude, expectation source label — market-implied or trend-model — and optionally a linked prediction market slug/probability), the next scheduled release date, a 12-observation recent mini-series of monthly values, and a revisions array showing first vs latest values for prior observations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "title": "Total Nonfarm Payrolls (SA)",
   "units": "Thousands of Persons",
   "recent": [
    {
     "value": 158472,
     "obs_date": "2025-08-01"
    },
    {
     "value": 158548,
     "obs_date": "2025-09-01"
    },
    {
     "value": 158408,
     "obs_date": "2025-10-01"
    },
    {
     "value": 158449,
     "obs_date": "2025-11-01"
    },
    {
     "value": 158432,
     "obs_date": "2025-12-01"
    },
    {
     "value": 158592,
     "obs_date": "2026-01-01"
    },
    {
     "value": 158436,
     "obs_date": "2026-02-01"
    },
    {
     "value": 158650,
     "obs_date": "2026-03-01"
    },
    {
     "value": 158798,
     "obs_date": "2026-04-01"
    },
    {
     "value": 158861,
     "obs_date": "2026-05-01"
    },
    {
     "value": 158881,
     "obs_date": "2026-06-01"
    },
    {
     "value": 158858,
     "obs_date": "2026-07-01"
    }
   ],
   "series": "payrolls",
   "fred_id": "PAYEMS",
   "surprise": {
    "actual": -23,
    "expected": 77,
    "surprise": -100,
    "expectation_detail": "trend-model: mean of prior 3 thousands (m/m change) prints",
    "expectation_source": "trend-model"
   },
   "frequency": "Monthly",
   "revisions": [
    {
     "obs_date": "2026-06-01",
     "first_value": 158984,
     "latest_value": 158881
    },
    {
     "obs_date": "2026-05-01",
     "first_value": 159001,
     "latest_value": 158861
    },
    {
     "obs_date": "2026-04-01",
     "first_value": 158736,
     "latest_value": 158798
    }
   ],
   "latest_print": {
    "revised": false,
    "headline": -23,
    "obs_date": "2026-07-01",
    "latest_value": 158858,
    "headline_basis": "first release vs prior period (latest vintage)",
    "headline_units": "thousands (m/m change)",
    "first_released_on": "2026-08-07",
    "first_release_value": 158858
   },
   "release_name": "Employment Situation",
   "source_agency": "U.S. Bureau of Labor Statistics",
   "next_release_date": "2026-09-04"
  },
  "meta": {
   "docs": "https://x402-factory.com/docs/econ.series.payrolls",
   "sources": [
    "fred"
   ],
   "version": "1.0.0",
   "endpoint": "/v1/econ/payrolls",
   "data_mode": "live",
   "freshness": "daily",
   "request_id": "req_00000000",
   "generated_at": "2026-08-21T03:58:57.918Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-factory-nonfarm-payrolls-bls-6ac1a80c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-factory.com](https://www.zero.xyz/host/x402-factory.com/llms.txt)