Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man bls-occupational-stats

/bls-occupational-stats

agentutility / edge-finance / bls-occupational-stats
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CATEGORY
uncategorized
STATUS
live
NAME
bls-occupational-stats pull wage, employment level, and growth data straight from the bureau of labor statistics public data api by series id, covering formats…
SYNOPSIS
POST https://x402.agentutility.ai/bls-occupational-stats
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Pull wage, employment level, and growth data straight from the Bureau of Labor Statistics Public Data API by series ID, covering formats like OEWS occupational wages (OEUM...), local-area unemployment (LAU...), and CES employment series. It's a federal, public, free source, and an optional BLS_API_KEY raises the rate limit for heavier lookups. Send series_ids (up to 25 per request) plus an optional start_year and end_year; get back per-series data points with year, period, value, footnotes, and optional net/percent-change calculations. Use it as a BLS wage data API, occupational employment lookup, or labor statistics tool for wage benchmarking, HR market research, or macroeconomic dashboards.

INPUTrequest schema
propertytypedescriptionreq?
series_idsarrayBLS series IDs to fetch (e.g. 'LAUCN040010000000005'). Max 25 per request.required
start_yearstringStart year for the data range. Must be paired with end_year (the other is mirrored if only one is given).optional
end_yearstringEnd year for the data range. Must be paired with start_year (the other is mirrored if only one is given).optional
include_calculationsbooleanBoolean, default false. When true, includes BLS net/percent change calculations per data point.optional
OUTPUTresponse shape
fieldtypedescription
series_returnedstringCount of series IDs successfully returned by the BLS API in this response.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/bls-occupational-stats \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the bls-occupational-stats tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
edge-financeblslabor-statswagesemploymentoccupational-databls-api
methods
POST
cluster
edgefinance
price
$0.02 USDC per call
ADJACENTother endpoints in edgefinance
endpointdescriptionprice
polymarket-kalshi-arbitrageScans for arbitrage between Polymarket and Kalshi prediction markets.$0.02
tariff-duty-scenarioCalculates import duty what-if scenarios: current vs proposed duty and landed-cost deltas from caller-supplied values, rates, freight, in…$0.02
earnings-calendarFinds a company's next earnings date and its recent earnings-related SEC filings.$0.03
earnings-calendar-apiFinds company earnings dates from SEC filings: 8-K Item 2.02, 10-Q, 10-K, NT filing signals, fiscal periods, and next-earnings cadence es…$0.03
earnings-call-transcribeTranscribes a company earnings call from its publicly posted investor-relations webcast or replay audio URL, then optionally turns that t…$0.03
earnings-transcriptEarnings call transcript generator.$0.03
fda-calendarTracks upcoming FDA Advisory Committee (AdComm) meetings, a catalyst calendar for biotech.$0.03
fda-calendar-apiTracks FDA advisory committee meetings, monitoring upcoming and recent AdComm notices, docket ids, committee names, and meeting dates.$0.03
SEE ALSO
agentutility · edgefinance · x402 · mcp · llms.txt · registry.json · bazaar.x402.org