GET /v1/econ/treasury-10y

$0.02dailytier: datacache 900sEngine E — US Economic Data (FRED)

Latest 10-year Treasury yield print from the Fed via FRED/ALFRED: first-release vs latest value with a revised flag (revisions never pose as print-day numbers), surprise vs a labeled expectation (market-implied when a matching prediction market exists, else trend-model), next daily release date, and a 12-observation mini-series. Same shape as /v1/econ/:series bound to treasury-10y.

Parameters

None.

Example

curl "https://x402-factory.com/v1/econ/treasury-10y"

Example response

{
  "data": {
    "series": "treasury-10y",
    "fred_id": "DGS10",
    "title": "10-Year Treasury Yield (CM)",
    "source_agency": "Board of Governors of the Federal Reserve System (US)",
    "release_name": "H.15 Selected Interest Rates",
    "units": "Percent",
    "frequency": "Daily",
    "latest_print": {
      "obs_date": "2026-08-12",
      "headline": 4.68,
      "headline_units": "%",
      "headline_basis": "first release level",
      "first_release_value": 4.68,
      "latest_value": 4.68,
      "revised": false,
      "first_released_on": "2026-08-13"
    },
    "surprise": null,
    "surprise_note": "continuous market series (daily): no discrete print to grade",
    "next_release_date": "2026-11-27",
    "recent": [
      {
        "obs_date": "2026-07-28",
        "value": 4.61
      },
      {
        "obs_date": "2026-07-29",
        "value": 4.67
      },
      {
        "obs_date": "2026-07-30",
        "value": 4.68
      },
      {
        "obs_date": "2026-07-31",
        "value": 4.75
      },
      {
        "obs_date": "2026-08-03",
        "value": 4.7
      },
      {
        "obs_date": "2026-08-04",
        "value": 4.63
      },
      {
        "obs_date": "2026-08-05",
        "value": 4.63
      },
      {
        "obs_date": "2026-08-06",
        "value": 4.69
      },
      {
        "obs_date": "2026-08-07",
        "value": 4.65
      },
      {
        "obs_date": "2026-08-10",
        "value": 4.72
      },
      {
        "obs_date": "2026-08-11",
        "value": 4.7
      },
      {
        "obs_date": "2026-08-12",
        "value": 4.68
      }
    ],
    "revisions": []
  },
  "meta": {
    "endpoint": "/v1/econ/treasury-10y",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.051Z",
    "freshness": "daily",
    "sources": [
      "fred"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/econ.series.treasury-10y",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string"
    },
    "fred_id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "source_agency": {
      "type": "string"
    },
    "release_name": {
      "type": "string"
    },
    "units": {
      "type": "string"
    },
    "frequency": {
      "type": "string"
    },
    "latest_print": {
      "type": "object",
      "properties": {
        "obs_date": {
          "type": "string"
        },
        "headline": {
          "type": "number"
        },
        "headline_units": {
          "type": "string"
        },
        "headline_basis": {
          "type": "string"
        },
        "first_release_value": {
          "type": "number"
        },
        "latest_value": {
          "type": "number"
        },
        "revised": {
          "type": "boolean"
        },
        "first_released_on": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "obs_date",
        "headline",
        "headline_units",
        "headline_basis",
        "first_release_value",
        "latest_value",
        "revised",
        "first_released_on"
      ],
      "additionalProperties": false
    },
    "surprise": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "actual": {
              "type": "number"
            },
            "expected": {
              "type": "number"
            },
            "surprise": {
              "type": "number"
            },
            "expectation_source": {
              "type": "string",
              "enum": [
                "market-implied",
                "trend-model"
              ]
            },
            "expectation_detail": {
              "type": "string"
            },
            "comparable_market": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "market_p": {
                  "type": "number"
                },
                "question": {
                  "type": "string"
                }
              },
              "required": [
                "slug",
                "market_p",
                "question"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "actual",
            "expected",
            "surprise",
            "expectation_source",
            "expectation_detail"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "surprise_note": {
      "type": "string"
    },
    "next_release_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "next_release_expectation": {
      "type": "object",
      "properties": {
        "expected": {
          "type": "number"
        },
        "slug": {
          "type": "string"
        },
        "market_p": {
          "type": "number"
        },
        "question": {
          "type": "string"
        }
      },
      "required": [
        "expected",
        "slug",
        "market_p",
        "question"
      ],
      "additionalProperties": false
    },
    "recent": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "obs_date": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "obs_date",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "revisions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "obs_date": {
            "type": "string"
          },
          "first_value": {
            "type": "number"
          },
          "latest_value": {
            "type": "number"
          }
        },
        "required": [
          "obs_date",
          "first_value",
          "latest_value"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "series",
    "fred_id",
    "title",
    "source_agency",
    "release_name",
    "units",
    "frequency",
    "latest_print",
    "surprise",
    "next_release_date",
    "recent",
    "revisions"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.02 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors