# Freddie Mac API: Get mortgage rates > Returns Freddie Mac's U.S. 30-year and 15-year fixed mortgage rates for the latest survey or a chosen date, with weekly and year-ago changes, and optionally a weekly history for a date range. Unofficial. Not affiliated with or endorsed by Freddie Mac. - Page: https://fous.com/methods/freddiemac.com/get-mortgage-rates - Method: `freddiemac.com/get_mortgage_rates`, version 1 - Website: freddiemac.com - Returns: survey date, 30-year and 15-year rates, weekly and year-ago changes, optional weekly history - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | no | `"2026-09-22"` | Survey week on or before this date (YYYY-MM-DD); defaults to the latest survey. | | `end_date` | string | no | `"2025-10-31"` | Last date to include in weekly history (YYYY-MM-DD); defaults to today when start_date is set. | | `start_date` | string | no | `"2025-09-01"` | First date to include in weekly history (YYYY-MM-DD); defaults to the earliest available survey when end_date is set. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "date": "2026-09-22", "end_date": "2025-10-31", "start_date": "2025-09-01" } ``` Its output: ```json { "page_url": "https://www.freddiemac.com/pmms/pmms_archives", "survey_date": "2026-09-17", "weekly_history": [ { "page_url": "https://www.freddiemac.com/pmms/pmms_archives", "survey_date": "2025-10-30", "rate_15_year_percent": 5.41, "rate_30_year_percent": 6.17 }, { "page_url": "https://www.freddiemac.com/pmms/pmms_archives", "survey_date": "2025-10-23", "rate_15_year_percent": 5.44, "rate_30_year_percent": 6.19 }, { "page_url": "https://www.freddiemac.com/pmms/pmms_archives", "survey_date": "2025-10-16", "rate_15_year_percent": 5.52, "rate_30_year_percent": 6.27 } ], "rate_15_year_percent": 6.26, "rate_30_year_percent": 6.95, "change_15_year_year_ago_points": 0.85, "change_30_year_year_ago_points": 0.69, "change_15_year_previous_week_points": 0.17, "change_30_year_previous_week_points": 0.19 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"freddiemac.com/get_mortgage_rates","input":{"date":"2026-09-22","end_date":"2025-10-31","start_date":"2025-09-01"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What is the current 30-year fixed mortgage rate from Freddie Mac this week? - Show me the 15-year fixed rate for the survey week of 2026-09-24 and how it changed from last week. - How have 30-year mortgage rates moved over the year, with weekly history from 2025-09-01 to 2025-10-31? - Compare today's average 15-year and 30-year fixed rates with the same week a year ago on freddiemac.com. - I need the Freddie Mac weekly mortgage rate survey as of 2026-06-15, including year-over-year change. ## Input schema ```json { "type": "object", "properties": { "date": { "type": "string", "examples": [ "2026-09-24" ], "description": "Survey week on or before this date (YYYY-MM-DD); defaults to the latest survey." }, "end_date": { "type": "string", "examples": [ "2025-10-31" ], "description": "Last date to include in weekly history (YYYY-MM-DD); defaults to today when start_date is set." }, "start_date": { "type": "string", "examples": [ "2025-09-01" ], "description": "First date to include in weekly history (YYYY-MM-DD); defaults to the earliest available survey when end_date is set." } } } ``` ## Output schema ```json { "type": "object", "required": [ "survey_date", "rate_30_year_percent", "rate_15_year_percent", "page_url", "change_30_year_previous_week_points", "change_15_year_previous_week_points", "change_30_year_year_ago_points", "change_15_year_year_ago_points", "weekly_history" ], "properties": { "page_url": { "type": "string", "format": "uri" }, "survey_date": { "type": "string", "format": "date" }, "weekly_history": { "type": "array", "items": { "type": "object", "required": [ "survey_date", "rate_30_year_percent", "rate_15_year_percent", "page_url" ], "properties": { "page_url": { "type": "string", "format": "uri" }, "survey_date": { "type": "string", "format": "date" }, "rate_15_year_percent": { "type": [ "number", "null" ] }, "rate_30_year_percent": { "type": "number", "description": "Average fixed mortgage rate in percent (for example, 6.35 means 6.35%)." } }, "additionalProperties": false }, "description": "Weekly survey results, newest first, within the requested date range; up to 520 weeks. Empty if no range was requested." }, "rate_15_year_percent": { "type": [ "number", "null" ] }, "rate_30_year_percent": { "type": "number", "description": "Average fixed mortgage rate in percent (for example, 6.35 means 6.35%)." }, "change_15_year_year_ago_points": { "type": [ "number", "null" ] }, "change_30_year_year_ago_points": { "type": [ "number", "null" ] }, "change_15_year_previous_week_points": { "type": [ "number", "null" ] }, "change_30_year_previous_week_points": { "type": [ "number", "null" ] } }, "additionalProperties": false } ``` ## See more - [Bankrate API: Get mortgage rates](https://fous.com/methods/bankrate.com/get-mortgage-rates.md): Gets Bankrate's published mortgage or refinance interest rates and APRs by loan type, with the as-of date of the rate table. A ZIP code or state picks the matching state page; Bankrate describes these tables as national averages. Weekly changes are included only when Bankrate publishes a matching change. - [FRED API: Get economic indicator](https://fous.com/methods/fred.stlouisfed.org/get-economic-indicator.md): Gets a public FRED economic series by plain name or series ID, with its observations, latest value and source details. - [FRED API: Search economic series](https://fous.com/methods/fred.stlouisfed.org/search-indicators.md): Searches FRED economic series by topic, ordered by popularity, and returns each series' coverage dates, units, frequency and last update. FRED does not publish a popularity score on these pages, so it is null. - [U.S. Treasury API: Get Treasury yields](https://fous.com/methods/home.treasury.gov/get-treasury-yields.md): Gets official daily Treasury par yield curve rates for a date, or the latest published date on or before it. - [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [U.S. Treasury API: Get reporting exchange rates](https://fous.com/methods/treasury.gov/get-reporting-exchange-rates.md): Gets the U.S. Treasury quarterly reporting exchange rate for a country or currency on a given date. If that quarter has no published record, it uses the latest preceding quarter. - [Macrotrends API: Get long-term price history](https://fous.com/methods/macrotrends.net/get-long-term-price-history.md): Gets decades of yearly commodity or stock-index price history from Macrotrends: yearly average, open, high, low, close, annual change and inflation-adjusted value for gold, silver, crude oil, natural gas, copper, Dow Jones, S&P 500 and Nasdaq. The current year may be incomplete. - [Bankrate API: List best savings, CD or money market rates](https://fous.com/methods/bankrate.com/list-best-savings-rates.md): Lists Bankrate's current high-yield savings, CD (for a chosen term) or money market account rates in Bankrate's listed order, with APY, minimum deposit and whether the listing is sponsored.