Menu · Market
Market

Mortgage rates

GEThttps://api.ruuster.com/v1/mortgage/rates

Today's national mortgage-rate averages (30- and 15-year fixed, FHA, jumbo, VA and the 10-year Treasury) and the history of one series, from public Federal Reserve data, for market context and payment illustrations.

  • Authentication: x-api-key and x-email headers of an owner or admin
  • Rate limit: 120 requests per minute per key
View as Markdown

The same numbers the Ruuster Brain's mortgage-rates widget shows, as data. Two kinds of series come back on every call: the daily Optimal Blue Mortgage Market Indices (OBMMI), which average the rates locked across lenders each business day and are posted one business day in arrears, and the weekly Freddie Mac Primary Mortgage Market Survey (PMMS), published on Thursdays. Both are published by FRED (the St. Louis Fed) with disclosed methodology, so they can be shown to clients with their date and source.

history is one series over a trailing window, for a trend line or a "rates over the last year" table. Pick the series with series; the default is the daily 30-year conforming index.

These are national averages, not a quote: a borrower's rate depends on credit, points, loan type and the lender's pricing that day. When you put a payment in front of someone, say which rate and date you used.

Not a lookup call. Rates are refreshed hourly; FRED itself updates the daily indices each business day and the survey weekly.

Query parameters

Name Type Default Description
series string OBMMIC30YF The series to return in history: OBMMIC30YF (30-year fixed, daily), OBMMIC15YF (15-year fixed, daily), OBMMIFHA30YF (FHA 30-year, daily), OBMMIJUMBO30YF (jumbo 30-year, daily), OBMMIVA30YF (VA 30-year, daily), DGS10 (10-year Treasury yield, daily), MORTGAGE30US (30-year fixed, weekly survey), MORTGAGE15US (15-year fixed, weekly survey)
days integer 90 Trailing window for history, 7 to 400 days

Response

Field Description
asOf daily and weekly: the newest date in each group of series
daily[] One row per daily series: series, label, rate (percent), date, previous, previousDate, change (percentage points since the previous reading). null when the series had no reading
weekly[] The same shape for the two survey series
history series, label, frequency, source, days, from, to, and points[] of date and rate in the window, oldest first
sources Where the daily, weekly and Treasury figures come from
note What these averages are and are not

When FRED is down, each series falls back to its last successfully read figures, which keep their original dates, so check the dates before calling a rate "today's". 503 source_unavailable (with Retry-After: 60) only when FRED can't be reached and no saved figures exist; try again in a minute.