Explorer
Syncing—

US Macroeconomic SeriesService

us-macro

US macroeconomic time series published by U.S. government sources (BLS, BEA, Federal Reserve Board, Treasury, Census and others), through the FRED API. POST JSON {"series": ["CPIAUCSL", "UNRATE"], "start": "2024-01-01", "end": "2026-09-01"} to /v1/tool, or GET /v1/macro?series=GDP,DGS10&start=2026-01-01. series: FRED series ids from U.S. government sources (up to 12) or aliases inflation, labor, unemployment, payrolls, gdp, rates; default CPI and unemployment since 2024-01-01. Series FRED carries for third-party owners (for example the S&P 500) are not served. The response is a JSON object with series (series_id, title, source, count, observations of date and value), notice, plus unknown_series and not_served when they apply. This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. Live data, cached 6 hours.

Active Suppliers
1
of 1 ever configured
Service Info
Service ID
us-macro
Compute Units / Relay
100,000
Active Applications
1
Relay Mining EMA
1 relays
Service Metadata Cardsource: on-chain metadata (LCD)
{10 items
"schema":"pocket-service-card/v1"
"description":"US macroeconomic time series published by U.S. government sources (BLS, BEA, Federal Reserve Board, Treasury, Census and others), through the FRED API. POST JSO..."
"rpc_types":[1 item
0:{4 items
"type":"REST"
"intent":"expected"
"backend_hint":"us-macro HTTP server on :8080; POST /v1/tool (POST / also reaches it through the relay), GET /v1/health + /v1/version."
"notes":"Every response is a JSON object; errors are JSON 4xx with an error field."
}
]
"apis":[1 item
0:"us-macro-api"
]
"specs":[1 item
0:{4 items
"kind":"openapi"
"api":"us-macro-api"
"url":"https://services.supnodes.com/specs/us-macro/openapi.json"
"notes":"Machine-readable OpenAPI 3.0.3 contract for this service, with example requests."
}
]
"access":"public"
"results":"variable"
"serving":{7 items
"backend":"Single-process Python 3 HTTP server, standard library only, behind a RelayMiner (rest backend). No auth toward the backend; callers cannot send headers. Calls t..."
"implementations":[1 item
0:"us-macro >= 1.0"
]
"docs":"https://services.supnodes.com/specs/us-macro/README.md"
"min_disk_gb":1
"min_ram_gb":1
"healthcheck":[3 items
0:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/version"
"method":"GET"
}
"expect":{2 items
"json_path":"$.service"
"matches":"^us-macro$"
}
"notes":"Identity probe: pins the backend to this service so a wrong backend cannot be staked under this id."
}
1:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/health"
"method":"GET"
}
"expect":{2 items
"json_path":"$.status"
"matches":"^ok$"
}
"notes":"Readiness probe."
}
2:{4 items
"rpc_type":"REST"
"request":{3 items
"path":"/v1/tool"
"method":"POST"
"body":{2 items
"start":"2026-01-01"
"series":[1 item
0:"UNRATE"
]
}
}
"expect":{2 items
"json_path":"$.series[0].series_id"
"matches":"^UNRATE$"
}
"notes":"Functional probe: the unemployment rate this year; one upstream call unless cached."
}
]
"notes":"Upstream: the FRED API; each supplier needs its own free FRED API key and must follow the FRED API terms of use (own key, the notice, no third-party series). Ga..."
}
"docs":"https://services.supnodes.com/specs/us-macro/README.md"
"updated":"2026-10-02"
}