Securely Redirecting...

Connecting to Stripe

Back to API Index

Non-Farm Payrolls (NFP) (USD)

The measure of the number of workers in the U.S. excluding farm workers and those who work in private households or non-profit organizations. NFP is arguably the most market-moving data point in Forex. A significantly higher-than-expected number is seen as confirming economic strength and is extremely bullish for the USD, often leading to sharp moves against other currencies.

Category: Labor Market

API Endpoint

/api/usd/non_farm_payrolls
Or view detailed, interactive documentation: Open Swagger Docs

Data Source

Primary Source

FRED (BLS)

Official Series ID

PAYEMS

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

Thousands of Persons (SA)

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

[
  {
    "date": "YYYY-MM-DD", 
    "val": 0.00
  },
  {
    "date": "2024-07-01", 
    "val": 4.2 
  },
  // ... history 
]

Request Parameters & Usage

Parameter Required Format Description
start YES YYYY-MM-DD The start date for the data retrieval.
end NO YYYY-MM-DD The end date for the data retrieval. Defaults to today's date.
key YES string Your unique API key for authentication.

Example Usage

To retrieve the Non-Farm Payrolls (NFP) data for USD starting from the beginning of 2023: 

GET https://fxmacrodata.com/api/usd/non_farm_payrolls?start=2023-01-01&key=YOUR_API_KEY