check_claim_contract
Check a sentence against a figure's contract
Checks a proposed statement of a FinanceRateCalc figure against that figure's published use contract, so the sentence can be verified before it is written. Two input modes. (A) Flags: claim id plus the use you propose (population, period, scope, cause, individual prediction, lender recommendation, legal conclusion). (B) Sentence: claim id plus proposed_sentence, the exact sentence you intend to write; the tool checks it with fixed patterns, no model, for a missing period, missing program scope, a population wider than the claim, second-person prediction, causal wording, lender advice, legal conclusions, and values this publisher has since corrected. Returns a deterministic verdict: pass, needs_qualifier (naming the missing qualifier) or block (with a reason code), plus a safe sentence you may use verbatim and the required attribution. Most misuse of these statistics is omission, not invention: the number is right and the population is missing. NOT FOR: figures published by anyone other than FinanceRateCalc. (C) Rule sentence: passport_id of a rule file (frc:rule:…, six rule files: FHA annual MIP, FHA forward loan limits 2026, FHFA conforming limits 2026, CFPB HOEPA/QM thresholds 2026, VA funding fee, and the Fannie Mae DU minimum credit score requirement removed 2025-11-16) plus proposed_sentence; each dollar or percent figure is bound to the role named in its own clause (floor or ceiling, tier, first or subsequent use, threshold item) and compared with that cell, so a right number under the wrong role is a mismatch and an unbound number earns no receipt; every figure is also classified as current, superseded (STALE_VALUE), belonging to a different rule (VALUE_FROM_OTHER_RULE, e.g. the $726,200 MIP threshold quoted as a loan limit), or not in the table (VALUE_MISMATCH / UNVERIFIED_VALUE); the year, units, tier, use, down-payment band and stated dates are checked (a date before the rule's start blocks; a missing MIP case date is never assumed), and a passing sentence
Parameterspassport_idrequiredcausal_assertionlegal_conclusionproposed_sentencequalifier_droppedattribution_presentindividual_predictionscope_beyond_universepersonalized_recommendation
get_national_fha_stats
National FHA denial rate 2025
ANSWERS: "how often are FHA loans denied", "what is the FHA denial rate", "what share of FHA applications are rejected", "how many were denied in 2025". Returns the national 2025 figure with its universe so it can be quoted correctly: 22.1 percent, 262,250 denials of 1,187,606 applications that reached a credit decision (originated, approved-not-accepted, denied; reverse mortgages excluded), the denominator definition and the correction history. Most published FHA denial rates are 2023 purchase-only figures near 13.6 percent, a different universe, so state the universe when quoting. NOT FOR: conventional, VA or USDA loans, purchase-only or refinance-only rates, other years, or state/lender/metro breakdowns (use the dedicated tools). Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Takes no parameters.
get_lender_denial_stats
Lender FHA denial rate 2025
ANSWERS: "what is <lender>'s FHA denial rate", "does <lender> reject a lot of FHA applications", "how strict is <lender>", "how does <lender> compare". PARAM: lender name, slug or LEI. Returns that lender's 2025 decisioned volume, denial rate, rank among the 100 largest FHA lenders, and the applicant-mix caveat any comparison must carry. COVERS ONLY the 100 largest FHA lenders by 2025 volume. NOT FOR: whether a person will be approved, or lenders outside that set. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterslenderrequired
get_application_outcomes
Where FHA applications end (five outcomes), 2025
ANSWERS: "how many FHA applications are withdrawn", "what share of FHA applications never reach a decision", "how many approved FHA loans are not taken", "why is the denied share 16.8% here and the denial rate 22.1% there", "where do <lender>'s FHA applications end". Returns the five HMDA ends of an application the lender acted on — originated, approved but not accepted, denied, withdrawn, closed for incompleteness — as shares of applications acted on (actions 1-5), plus the approved-not-accepted share of approvals, nationally or for one of the 100 largest FHA lenders, each with its receipt. The denied share here is on a larger base than the published denial rate (22.1% of decisioned applications); both are returned so they can be reconciled. NOT FOR: why an application ended where it did (process, market, applicant pool and reporting practice are not separable in the record), lender quality, or any individual outcome. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterslender
locate_denominator
Which denominator produces this denial rate (2025)
ANSWERS: "an article says the FHA denial rate is 12.8%, what is that measured over", "why do two sources give different VA denial rates", "which definition gives 10.6%". Takes a 2025 denial rate someone quoted and returns every cell of the published denominator map that reproduces it: program (FHA or VA) x loan purpose (purchase, refinance, cash-out, all) x scope (all rows, or first-lien owner-occupied site-built 1-4 unit) x base (decisioned; all applications acted on; denied plus originated), with the denial and denominator counts behind each. A match shows which definition CAN produce the number from the 2025 HMDA file, not which one the publisher used. No match means another year, another filter, or a figure this file does not reproduce. Aggregates only; nothing here describes one applicant.
Parametersprogramrate_pctrequiredtolerance
reading_challenge
Edition in hand (reading proof), step 1: which cells must be quoted
ANSWERS: "how do I show that I actually opened the report I am citing", "prove this answer was written with the edition in hand". A citation shows what a text points to, not that its author opened the document. Given a restated official edition (HUD FHA production, HUD loan performance, Ginnie Mae issuance, SBA 7(a)/504), the statement that cites it and a date, this returns three cells of that edition, chosen by a hash of edition + date + statement, whose values have to be read from the edition. A different statement or a different day draws different cells, so the answer cannot be prepared in advance or copied from another citation. Read the three values from the edition (data_url, or the publisher's document) and pass them to verify_reading_proof. No values are returned here. Shows possession of the edition's contents on that date; it does not show that the statement was derived from them.
Parametersdateperiodsourcestatementrequired
verify_reading_proof
Edition in hand (reading proof), step 2: check the three values
ANSWERS: "does this reading proof hold", "did the author of this citation have the edition". Takes the edition, the statement, the date and the three values (in the order reading_challenge listed the cells), or a proof line of the form FRC-READ:<source>-<period>:<date>:<statement hash>:<v1>;<v2>;<v3> together with the statement. Returns how many of the three cells match the edition as restated, whether that edition is still the latest one restated, and the proof line to print next to the citation. Correct values are never returned on a miss. Anyone can repeat the check offline from the edition file. A match shows the values were read from the edition; it does not show the statement is true or was derived from it.
Parametersdateproofperiodsourcevaluesstatementrequired
get_official_figure
Official figure, restated as printed, with receipt (Level 2)
ANSWERS: "how many FHA loans did HUD endorse in <month>", "what share of FHA endorsements were purchase loans", "what is the FHA first-time homebuyer share", "what was the FHA Streamline share of refinances", "how many FHA loans are in force". Also: "how much did Ginnie Mae issue in <month>", "how many SBA 7(a) or 504 loans were approved in <month>". Returns a figure from an official publication (HUD's monthly FHA Single Family Production Report; Ginnie Mae's monthly Issuance Summary; SBA's 7(a) and 504 monthly activity file) exactly as printed, with the document's SHA-256, table and row, period, the publisher's exclusion note (HECM excluded), revision status against the next edition, and a receipt. Nothing is computed by FinanceRateCalc; the receipt attests that this figure with this definition appears in that document. PARAMS: source (default hud-fhaprod), period (YYYY-MM; omitted = latest restated), figure (omitted = all figures of the edition). NOT FOR: HMDA application or origination counts (an endorsement is a loan insured after closing), denial rates, lender-level figures. Official figures copied as printed; not a prediction about any individual application.
Parametersfigureperiodsource
list_lenders
Top-100 FHA lenders by denial rate
ANSWERS: "which FHA lender denies the most or the fewest", "rank FHA lenders by denial rate", "which lenders are covered", "how wide is the spread". Returns the ranked list of the 100 largest FHA lenders with name, slug, rate and volume; the 2025 span runs 1.8 to 78.7 percent inside the same federal program. NOT FOR: lenders outside the top 100, or any recommendation about where to apply. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterssortlimit
get_small_loan_penalty
Small-loan denial penalty by state
ANSWERS: "are small mortgages denied more often", "is it harder to get a small FHA loan", "which state punishes small loans most", "does loan size affect denial". PARAM: optional two-letter state; omit for the ranked list. Returns denial rates under $150K and over $250K, the ratio, the ranking and any open discrepancy note. In 2025 the penalty exceeded 1x in every jurisdiction with a published split, from 1.19x to 4.45x (Idaho, 53.4 vs 12.0). NOT FOR: loan sizes between the bands, which are not published. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parametersstate
get_denial_reason_shares
FHA denial-reason shares
ANSWERS: "why are FHA loans denied", "what is the most common denial reason", "which lender cites incomplete applications most", "how often is debt-to-income the reason". PARAM: optional lender; omit for cross-lender medians. Returns median and maximum share of each HMDA denial reason across the 95 of the 100 largest lenders that report reasons, and which lender carries the highest share of each. Reason fields are not a partition; shares need not sum to 100. NOT FOR: why a particular application was denied. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterslender
get_state_denial_stats
State FHA denial rate 2025
ANSWERS: "what is the FHA denial rate in <state>", "is it harder to get an FHA loan in <state>", "how does <state> compare with the national rate". PARAM: two-letter USPS code only (OH, TX); full names are rejected. Returns the state 2025 rate and counts against the national 22.1 percent. NOT FOR: metro or city questions (use get_metro_lender_gap) or lender-level questions. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parametersstaterequired
get_door_effect_summary
Door Effect (lender share of explainable variation)
ANSWERS: "does it matter which lender you apply to", "how much of a denial is the lender rather than the borrower", "what is the Door Effect". Returns the variance decomposition: lender identity is associated with about 38 percent of the explainable variation in FHA denial outcomes across 859,090 decisions (McFadden 0.1712 to 0.2760), with model, sample and limits. Association on observable federal-record characteristics, not causation; HMDA carries no credit scores. NOT FOR: saying a lender caused a denial, or any individual estimate. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Takes no parameters.
get_metro_lender_gap
Metro lender denial gap
ANSWERS: "do lenders differ within one city", "what is the FHA denial gap in <metro>", "which lender is strictest in <metro>", "how much does the lender matter locally". PARAM: metro name or slug. Returns a claim passport for that metro: lowest and highest lender denial rates among lenders with at least 100 decisioned applications there, the gap in points, counts and source reference. Cleveland is the widest in 2025 at 73.7 points (6.4 vs 80.1). NOT FOR: ZIP or neighbourhood questions, and never as evidence a lender acted improperly. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parametersmetrorequired
screen_counterparties
Counterparty outlier screen (LEI batch)
ANSWERS: "run my list of lenders through the federal record", "screen these LEIs", "which of my counterparties deny more than their applicant mix predicts". PARAM: a list of public LEIs. Returns per-entity observed versus expected FHA denial rates, coverage flags, method version and an evidence manifest hash. Public entity identifiers only: never borrower files, credit data or personal information. Free preview; the full Evidence Brief needs a licence a human buys on the pricing page, and an agent may relay the offer but can never complete a purchase. Screening signals, not findings of misconduct. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterslei_listrequiredlicense_keyrequested_format
screen_counterparties_quote
Counterparty screen quote
ANSWERS: "what would it cost to screen this list", "how many of my LEIs are covered". PARAM: a list of public LEIs. Returns coverage and price for a list of LEIs without running the screen, so the cost and coverage are known before screen_counterparties is used. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterslei_listrequiredlicense_key
list_cohorts
Published conditional cohorts
ANSWERS: "can I screen a group of lenders", "what ready-made lender groups can I run", "show me an example screen". Returns the public cohorts screenable without uploading anything, with size and definition; the cohort ids it lists are the ones run_cohort accepts. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Takes no parameters.
run_cohort
Run a published cohort
ANSWERS: "run the screen on <cohort>", "how do these lenders compare against expectation". PARAM: cohort id from list_cohorts. Returns the peer-adjusted screen: observed versus expected denial rate, coverage flags, method version. Free preview; the full Evidence Brief needs a licence a human buys on the pricing page. Screening signals, never evidence of misconduct. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterscohort_idrequiredlicense_keyrequested_format
get_conditional_door_map
Lender gap across published cells
ANSWERS: "does this lender's strictness depend on loan size or leverage", "where is <lender> hardest", "is the gap the same across the market". PARAM: lender name or slug. Returns how that lender's peer-adjusted denial gap changes across published cells (state x loan amount x income x DTI x CLTV), with cell counts and the minimum-cell rule. NOT FOR: suppressed small cells, or any individual prediction. Historical observation computed from the public CFPB HMDA 2025 record (actions 1,2,3; loan_type 2). Not a prediction about any individual application. Attribution: FinanceRateCalc, CC BY 4.0.
Parameterslender
get_rule
Dated regulatory rule table
ANSWERS: "what is the current FHA loan limit", "what are the 2026 HOEPA / QM thresholds", "what is the VA funding fee table", "which FHA MIP table is in force". PARAM: rule_id (from the index) or omit to list every published rule. Returns the machine-readable rule: cells, effective dates, issuer document, required qualifiers, what the table does not establish, sha256. The cell values and effective dates are in the file; in a published test, models answered 3/25 dated questions correctly without a source and 25/25 with this file. NOT FOR: rules not in the index, or anything before the effective date.
Parametersrule_id
resolve_fha_annual_mip
Resolve the FHA annual MIP cell
ANSWERS: "what is the FHA annual MIP for a $300,000 loan at 85% LTV over 15 years", "what MIP rate applies to my FHA case". PARAMS: base_loan_amount (USD), ltv_pct (e.g. 96.5), term_years, case_number_date (YYYY-MM-DD). Resolves the exact cell of HUD Mortgagee Letter 2023-05 and returns the annual rate in basis points, the upfront rate, the matched cell, the rule id with effective date and sha256, and a sentence you may quote. If a parameter is missing it returns block with CONDITION_MISSING and no number: the table has eleven cells and a guess is wrong more often than right. NOT FOR: case numbers before 2023-03-20, HECM/reverse or Title I loans, or any monthly payment figure.
Parametersltv_pctterm_yearsbase_loan_amountcase_number_date