{"uid":"cap_LiCmlvg9i6CGjw9_AOBKr","slug":"x402-factory-nonfarm-payrolls-bls-6ac1a80c","name":"x402-factory Nonfarm Payrolls (BLS)","description":"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.…","url":"https://x402-factory.com/v1/econ/payrolls?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rl2A6UZLRDp9Hlm4AFZX7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"What was the latest nonfarm payrolls number from the BLS — did it beat expectations, and how much was it revised from the initial release?","exampleUseCases":[{"title":"Morning macro briefing for traders","prompt":"Give me the latest nonfarm payrolls print, whether it surprised to the upside or downside versus the market-implied expectation, and when the next release is scheduled."},{"title":"Revision tracking for economic research","prompt":"Show me the nonfarm payrolls first-release value vs the current revised figure for each of the last 12 months — I want to see how big the revisions have been."},{"title":"Automated jobs-report alert workflow","prompt":"As soon as the new payrolls data is out, pull the latest BLS print, the surprise figure versus expectations, and flag if the number was revised from the prior release."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:11:18.411Z","isFirstParty":false,"canonicalSlug":"x402-factory-nonfarm-payrolls-bls-6ac1a80c"}