{"uid":"cap_NM9FqU7uZTvgTxSS5tO_F","slug":"stationfx-total-nonfarm-payrolls-339d258d","name":"StationFX Total Nonfarm Payrolls","description":"Total U.S. employment excluding farm workers — the broadest monthly labor market measure. Reported on the first Friday of each month (jobs report). Monthly changes drive major market moves. Use for labor market trend analysis, cycle identification, and Fed reaction function modeling. Monthly frequency.","url":"https://stationfx.com/economic-data/labor/all-employees-total-nonfarm?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http","description":"Always \"http\" for HTTP endpoints"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string","description":"HTTP method. Always GET for StationFX query endpoints"},"queryParams":{"type":"object","properties":{"fmt":{"enum":["json","toon"],"type":"string","description":"Response format. Use toon for compact agent-friendly output."},"fields":{"type":"string","description":"Comma-separated metric names"},"date_to":{"type":"string","description":"End date YYYY-MM-DD"},"date_from":{"type":"string","description":"Start date YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Response format. Always \"json\" (or \"toon\" if fmt=toon was requested)"},"example":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"},"example":{"data":[{"date":"2024-01-01","value":5.33,"mom_pct":0,"yoy_change":0.5,"zscore_12m":1.2,"trend_direction":1}],"meta":{"frequency":"M","source_key":"PAYEMS"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9jB4YhSneURrkRe83h4Sr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns monthly U.S. total nonfarm payroll employment data (the 'jobs report' headline figure) with derived statistics including MoM/YoY changes, z-scores, trend signals, and rolling averages.","exampleAgentPrompt":"Pull the StationFX total nonfarm payrolls data from January 2020 through today in JSON format — I want to see the monthly values plus the month-over-month changes and the 5-year z-scores so I can analyze how current job growth compares to recent history.","exampleUseCases":[{"title":"Fed policy reaction function modeling","prompt":"I'm building a Fed reaction function model — can you grab the monthly nonfarm payrolls data from January 2022 to present from StationFX, including the year-over-year changes and z-scores, so I can quantify how far labor market strength is from the Fed's comfort zone?"},{"title":"Jobs report day market briefing","prompt":"It's jobs report Friday — pull today's latest nonfarm payrolls reading from StationFX along with the month-over-month change and where that sits as a percentile rank over the past 5 years, so I can brief my team on whether this print is a market mover."},{"title":"Recession cycle identification","prompt":"I want to identify the last three US employment cycle peaks and troughs — can you get me the nonfarm payroll monthly data from StationFX going back to January 2005 in JSON format, including the above-trend flag and rolling 12-month average, so I can map where expansions turned to contractions?"}],"resultDescription":"A JSON array of monthly observations, each containing the date, raw nonfarm payroll level (in thousands of workers), month-over-month absolute change, month-over-month percent change, year-over-year absolute change, year-over-year percent change, 12-month and 5-year z-scores, a binary above-trend flag, 5-year percentile rank, and 3-month and 12-month rolling averages. Compact 'toon' format is available for token-efficient agent consumption.","failureModes":["Invalid date format returns a 400-level error — use YYYY-MM-DD strictly","Requesting a date range before series history begins may return empty data array","Invalid fmt parameter value (not 'json' or 'toon') may cause a parsing error","Payment not included or insufficient USDC balance returns a 402 Payment Required response","Future dates return no data as releases are monthly on the first Friday"],"whenToPreferThis":"Choose this endpoint when you need the broadest official U.S. labor market headline — total nonfarm payrolls — with pre-computed statistical context (z-scores, percentile ranks, trend flags) already attached. Prefer it over raw BLS API calls when you want derived analytics (MoM, YoY, rolling averages) without building them yourself. It is the right choice for Fed policy modeling, macro dashboards, and jobs-report-day analysis. For farm-sector employment, household survey data (unemployment rate), or wage growth, use a complementary series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:46:16.661Z","isFirstParty":false,"canonicalSlug":"stationfx-total-nonfarm-payrolls-339d258d"}