[Datasets](https://gloom.sh/datasets#datasets) Macro and positioning

# Yield curves and macro series.

Economic series observations, scheduled releases and government yield curves by date. Every response carries its sources and dates.

- [See plans](https://gloom.sh/datasets/pricing)
- [Read the reference](https://gloom.sh/datasets/docs/datasets/macro)

Request 1 credit

```
curl https://api.gloom.sh/v1/yield-curves \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"
```

With your key, this call returns the latest data. The response is one record of the [free sample](https://api.gloom.sh/v1/datasets/macro/sample), which needs no key.

Response · data[0]

```
{
  "curve": {
    "id": "us",
    "label": "US Treasury",
    "country": "US",
    "basis": "par",
    "couponsPerYear": 2
  },
  "asOf": "2026-09-29",
  "points": [
    {
      "tenor": "1M",
      "years": 0.0833333333333,
      "yield": 4.04
    },
    {
      "tenor": "6W",
      "years": 0.125,
      "yield": 4.14
    },
    // … 12 more items
  ]
}
```

Trimmed real output

## Who uses it.

- ### Quant teams

  Yield curves and series for models.
- ### Research agents

  Cite the release behind each number.
- ### Fintech apps

  Macro calendars and curves in your app.

## Coverage and price.

- **routes**: 4
- **sources**: 3
- **credit for the cheapest call**: 1

In all 44 datasets on every plan, from $200/mo. [See plans](https://gloom.sh/datasets/pricing)

**Routes and credits (4)**

- `GET /v1/yield-curves` Government yield curves by country 1 credit
- `GET /v1/yield-curves/{curve}` Yield curve with dated lookbacks, spreads and ranked moves 2 credits
- `GET /v1/macro/series/{seriesId}` Economic series observations and metadata 2 credits
- `GET /v1/macro/calendar` Economic releases, forecasts and reported actuals 1 credit

## Related.

- [FINRA short interest](https://gloom.sh/datasets/short-interest)
- [Central bank rates](https://gloom.sh/datasets/central-bank-rates)
- [FINRA short volume](https://gloom.sh/datasets/short-volume)