Yield curves and macro series

Economic series observations, scheduled releases and government yield curves by date.

One row is

Economic series observations, scheduled releases and government yield curves by date

Example response

Trimmed real output. No key needed.

GET /v1/datasets/macro/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "curves": [
      {
        "curve": {
          "id": "us",
          "label": "US Treasury",
          "country": "US",
          "basis": "par",
          "couponsPerYear": 2
        },
        "asOf": "2026-09-29",
        "points": [
          {
            "tenor": "1M",
            "years": 0.08333333333333333,
            "yield": 4.04
          },
          {
            "tenor": "6W",
            "years": 0.125,
            "yield": 4.14
          },
          {
            "tenor": "2M",
            "years": 0.16666666666666666,
            "yield": 4.18
          },
          {
            "tenor": "3M",
            "years": 0.25,
            "yield": 4.25
          },
          {
            "tenor": "4M",
            "years": 0.3333333333333333,
            "yield": 4.3
          },
          {
            "tenor": "6M",
            "years": 0.5,
            "yield": 4.36
          },
          {
            "tenor": "1Y",
            "years": 1,
            "yield": 4.58
          },
          {
            "tenor": "2Y",
            "years": 2,
            "yield": 4.89
          },
          {
            "tenor": "3Y",
            "years": 3,
            "yield": 4.98
          },
          {
            "tenor": "5Y",
            "years": 5,
            "yield": 5.06
          },
          {
            "tenor": "7Y",
            "years": 7,
            "yield": 5.16
          },
          {
            "tenor": "10Y",
            "years": 10,
            "yield": 5.26
          },
          {
            "tenor": "20Y",
            "years": 20,
            "yield": 5.64
          },
          {
            "tenor": "30Y",
            "years": 30,
            "yield": 5.59
          }
        ],
        "previous": null,
        "checkedAt": "2026-09-30T12:00:00.000Z"
      }
    ]
  },
  "meta": {
    "dataset": "macro",
    "asOf": "2026-09-29",
    "source": [
      {
        "id": "official-curves",
        "attribution": "Government and central bank publications",
        "licence": "Use subject to Gloom Datasets terms"
      },
      {
        "id": "macro-series",
        "attribution": "Government and economic data providers",
        "licence": "Use subject to Gloom Datasets terms"
      },
      {
        "id": "economic-calendar",
        "attribution": "Public economic release calendars",
        "licence": "Use subject to Gloom Datasets terms"
      }
    ],
    "historyStarts": null,
    "coverage": {
      "curves": 1
    },
    "lastUpdated": "2026-09-30T12:00:00.000Z"
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/macro/curves1 credits

Government yield curves by country. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters: none.

Credits: 1 (lookup x1)
Plans: Basic, Desk, Enterprise

GET /v1/macro/curves/{curve}2 credits

Yield curve with dated lookbacks and spreads. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: curve
In: path, required
Type: us, us-real, us-breakeven, eu-aaa, de, gb, jp, ca

Parameter: date
In: query
Type: date, YYYY-MM-DD
Notes: Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter	In	Type	Notes
`curve`	path, required	`us`, `us-real`, `us-breakeven`, `eu-aaa`, `de`, `gb`, `jp`, `ca`
`date`	query	date, `YYYY-MM-DD`	Valid calendar date (YYYY-MM-DD). from must be on or before to.

Credits: 2 (history x1)
Plans: Basic, Desk, Enterprise

GET /v1/macro/series/{seriesId}2 credits

Stored economic series observations and metadata. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: seriesId
In: path, required
Type: string ^[A-Za-z0-9]{1,40}$

Parameter: from
In: query
Type: date, YYYY-MM-DD
Notes: Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter: to
In: query
Type: date, YYYY-MM-DD
Notes: Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter: limit
In: query
Type: integer 1 to 1000

Parameter: sortOrder
In: query
Type: asc, desc

Parameter	In	Type	Notes
`seriesId`	path, required	string `^[A-Za-z0-9]{1,40}$`
`from`	query	date, `YYYY-MM-DD`	Valid calendar date (YYYY-MM-DD). from must be on or before to.
`to`	query	date, `YYYY-MM-DD`	Valid calendar date (YYYY-MM-DD). from must be on or before to.
`limit`	query	integer 1 to 1000
`sortOrder`	query	`asc`, `desc`

Credits: 2 (history x1)
Plans: Basic, Desk, Enterprise

GET /v1/macro/calendar1 credits

Economic releases, forecasts and reported actuals. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters: none.

Credits: 1 (lookup x1)
Plans: Basic, Desk, Enterprise

Meta fields

Field: dataset
Here: The dataset id
In the example: "macro"

Field: asOf
Here: The observation date established by the service; otherwise null
In the example: "2026-09-29"

Field: source
Here: Attribution and usage terms of each source
In the example: 3 sources

Field: historyStarts
Here: Earliest stored history when established by the service; otherwise null.
In the example: null, not stated yet

Field: coverage
Here: Service-established coverage; null when unavailable.
In the example: {"curves":1}

Field: lastUpdated
Here: The source update time established by the service; otherwise null
In the example: "2026-09-30T12:00:00.000Z"

Field	Here	In the example
`dataset`	The dataset id	`"macro"`
`asOf`	The observation date established by the service; otherwise null	`"2026-09-29"`
`source`	Attribution and usage terms of each source	3 sources
`historyStarts`	Earliest stored history when established by the service; otherwise null.	null, not stated yet
`coverage`	Service-established coverage; null when unavailable.	`{"curves":1}`
`lastUpdated`	The source update time established by the service; otherwise null	`"2026-09-30T12:00:00.000Z"`

Sources

Source: Government and central bank publications
Usage terms: Use subject to Gloom Datasets terms

Source: Government and economic data providers
Usage terms: Use subject to Gloom Datasets terms

Source: Public economic release calendars
Usage terms: Use subject to Gloom Datasets terms

Source	Usage terms
Government and central bank publications	Use subject to Gloom Datasets terms
Government and economic data providers	Use subject to Gloom Datasets terms
Public economic release calendars	Use subject to Gloom Datasets terms

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.