curl --request GET \
--url https://gdeltcloud.com/api/v2/macro/series/{series_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/macro/series/{series_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/macro/series/{series_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"series": {
"series_id": "DGS10",
"title": "Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis",
"frequency": "Daily",
"frequency_short": "D",
"units": "Percent",
"units_short": "%",
"seasonal_adjustment": "Not Seasonally Adjusted",
"observation_start": "1962-01-02",
"observation_end": "2026-06-26",
"last_updated": "2026-06-27 15:18:04",
"source_agency": "FRB",
"release_id": 18,
"release_name": "H.15 Selected Interest Rates",
"geo_country_iso3": "USA",
"compliance_status": "ok",
"popularity": 91,
"attribution_text": "This product uses data from the Federal Reserve Bank of St. Louis (FRED) but is not endorsed or certified by it.",
"notes": "For further information regarding treasury constant maturity data, please refer to the H.15 Statistical Release notes and the Treasury Yield Curve Methodology."
},
"recent_observations": [
{
"date": "2026-06-26",
"value": 4.27
},
{
"date": "2026-06-25",
"value": 4.31
}
],
"meta": {
"attribution": "This product uses data from the Federal Reserve Bank of St. Louis (FRED) but is not endorsed or certified by it.",
"source": "Federal Reserve Bank of St. Louis (FRED)"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Get FRED series detail
Series catalog detail plus the most recent 24 observations (latest vintage). An unknown or quarantined series_id returns 404 with a message pointing to GET /api/v2/macro/series and the catalog. Requires a plan with Macro & economic data access (can_use_macro) — see Pricing for the plans that include it.
curl --request GET \
--url https://gdeltcloud.com/api/v2/macro/series/{series_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/macro/series/{series_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/macro/series/{series_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"series": {
"series_id": "DGS10",
"title": "Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Quoted on an Investment Basis",
"frequency": "Daily",
"frequency_short": "D",
"units": "Percent",
"units_short": "%",
"seasonal_adjustment": "Not Seasonally Adjusted",
"observation_start": "1962-01-02",
"observation_end": "2026-06-26",
"last_updated": "2026-06-27 15:18:04",
"source_agency": "FRB",
"release_id": 18,
"release_name": "H.15 Selected Interest Rates",
"geo_country_iso3": "USA",
"compliance_status": "ok",
"popularity": 91,
"attribution_text": "This product uses data from the Federal Reserve Bank of St. Louis (FRED) but is not endorsed or certified by it.",
"notes": "For further information regarding treasury constant maturity data, please refer to the H.15 Statistical Release notes and the Treasury Yield Curve Methodology."
},
"recent_observations": [
{
"date": "2026-06-26",
"value": 4.27
},
{
"date": "2026-06-25",
"value": 4.31
}
],
"meta": {
"attribution": "This product uses data from the Federal Reserve Bank of St. Louis (FRED) but is not endorsed or certified by it.",
"source": "Federal Reserve Bank of St. Louis (FRED)"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
FRED series ID (e.g. UNRATE, CPIAUCSL, DGS10). To discover valid IDs, call GET /api/v2/macro/series with no filters
Response
Series detail and recent observations. series carries series_id, title, frequency, frequency_short, units, units_short, seasonal_adjustment, observation_start, observation_end, last_updated, source_agency, release_id, release_name, geo_country_iso3, compliance_status, popularity, attribution_text, notes. recent_observations is up to 24 { date, value } points (most recent first). Includes the FRED non-endorsement meta.

