@model-match/api 3.57.1 → 3.59.0

package/openapi.json

@@ -11871,6 +11871,161 @@
         ],
         "type": "object"
       },
+      "CompanyActiveListing": {
+        "properties": {
+          "address": {
+            "description": "From the company's loan record on the parcel.",
+            "type": "string"
+          },
+          "lender": {
+            "description": "Lender on that loan — still the borrower's latest loan (retained), so the current lender of record.",
+            "nullable": true,
+            "type": "string"
+          },
+          "listPrice": {
+            "nullable": true,
+            "type": "number"
+          },
+          "listedDate": {
+            "description": "Date of the newest listing event (UTC).",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "listingStatus": {
+            "description": "The MLS status of the newest listing event (active).",
+            "type": "string"
+          },
+          "loanAmount": {
+            "type": "number"
+          },
+          "loanDate": {
+            "description": "Date of the company's latest loan on the parcel.",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+            "type": "string"
+          },
+          "originatorName": {
+            "type": "string"
+          },
+          "originatorNmlsId": {
+            "description": "The LO who wrote the company's latest loan on the parcel — employed by the company on that loan.",
+            "type": "string"
+          },
+          "propertyId": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "propertyId",
+          "address",
+          "listingStatus",
+          "listPrice",
+          "listedDate",
+          "originatorNmlsId",
+          "originatorName",
+          "loanDate",
+          "loanAmount",
+          "lender"
+        ],
+        "type": "object"
+      },
+      "CompanyActiveListingsResponse": {
+        "properties": {
+          "companyNmlsId": {
+            "type": "string"
+          },
+          "computedAt": {
+            "description": "When the weekly batch checked these listings (ISO-8601). Rows are as of this time, not live.",
+            "type": "string"
+          },
+          "cursor": {
+            "description": "Cursor for the next page; absent on the last page.",
+            "type": "string"
+          },
+          "data": {
+            "items": {
+              "$ref": "#/components/schemas/CompanyActiveListing"
+            },
+            "type": "array"
+          },
+          "status": {
+            "description": "`timeout`: the listing check did not finish in this run, so the previous run's rows and counts are kept (or none, on a first run).",
+            "enum": [
+              "ok",
+              "timeout"
+            ],
+            "type": "string"
+          },
+          "total": {
+            "description": "Rows matching the filter, across all pages.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "companyNmlsId",
+          "computedAt",
+          "status",
+          "data",
+          "total"
+        ],
+        "type": "object"
+      },
+      "CompanyActiveListingsSummary": {
+        "description": "Retained borrowers listed for sale now, on loans by the company's own LOs: the count and top LOs (rows: `GET /companies/{nmlsId}/retention/active-listings`). Same for every window. Null until the weekly batch has checked listings for this company.",
+        "nullable": true,
+        "properties": {
+          "computedAt": {
+            "description": "When the listings were checked (ISO-8601) — the run that wrote the rows. Listings are as of this time, not live.",
+            "type": "string"
+          },
+          "parcelsChecked": {
+            "description": "Retained parcels whose latest company loan was written by an LO the company employed on it — the population checked for listings.",
+            "type": "integer"
+          },
+          "status": {
+            "description": "`timeout`: the listing check did not finish in this run, so the previous run's rows and counts are kept (or none, on a first run).",
+            "enum": [
+              "ok",
+              "timeout"
+            ],
+            "type": "string"
+          },
+          "topOriginators": {
+            "description": "Top 10 LOs by active listings.",
+            "items": {
+              "properties": {
+                "count": {
+                  "type": "integer"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "nmlsId": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "nmlsId",
+                "name",
+                "count"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "total": {
+            "description": "Retained borrowers whose home is listed for sale right now, on loans written by the company's own LOs.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "computedAt",
+          "status",
+          "total",
+          "parcelsChecked",
+          "topOriginators"
+        ],
+        "type": "object"
+      },
       "CompanyBranch": {
         "properties": {
           "branchNmlsId": {
@@ -15691,6 +15846,9 @@
       },
       "CompanyRetentionSnapshot": {
         "properties": {
+          "activeListings": {
+            "$ref": "#/components/schemas/CompanyActiveListingsSummary"
+          },
           "book": {
             "description": "Rows the computation read (sizing / provenance).",
             "properties": {
@@ -16347,6 +16505,7 @@
           "capturingTotals",
           "originatorRetention",
           "previous",
+          "activeListings",
           "book"
         ],
         "type": "object"
@@ -29661,7 +29820,9 @@
               "veteranIndicator",
               "hmdaActionTaken",
               "selfEmployed",
-              "currentHomeOwner"
+              "currentHomeOwner",
+              "lenderType",
+              "lenderVolumeClass"
             ],
             "type": "string"
           }
@@ -30616,6 +30777,660 @@
         ],
         "type": "object"
       },
+      "MarketSignalsRequest": {
+        "additionalProperties": false,
+        "properties": {
+          "flatFilters": {
+            "$ref": "#/components/schemas/MarketFlatFilters"
+          },
+          "lookbackMonths": {
+            "maximum": 120,
+            "minimum": 6,
+            "type": "integer"
+          },
+          "previous": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/MarketSignalsWindow"
+              },
+              {
+                "description": "Comparison window; defaults to the preceding equal-length one."
+              }
+            ]
+          },
+          "stats": {
+            "items": {
+              "enum": [
+                "funnel",
+                "refiMix",
+                "affordability",
+                "pipeline",
+                "status",
+                "refiOpportunity"
+              ],
+              "type": "string"
+            },
+            "minItems": 1,
+            "type": "array"
+          },
+          "thresholdBps": {
+            "maximum": 500,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "window": {
+            "$ref": "#/components/schemas/MarketSignalsWindow"
+          }
+        },
+        "required": [
+          "window",
+          "stats"
+        ],
+        "type": "object"
+      },
+      "MarketSignalsResponse": {
+        "properties": {
+          "affordability": {
+            "properties": {
+              "current": {
+                "properties": {
+                  "medianAnnualIncome": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "medianLoanAmount": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "sampleCount": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "medianLoanAmount",
+                  "medianAnnualIncome",
+                  "sampleCount"
+                ],
+                "type": "object"
+              },
+              "monthly": {
+                "items": {
+                  "properties": {
+                    "medianAnnualIncome": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "medianLoanAmount": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "month": {
+                      "type": "string"
+                    },
+                    "sampleCount": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "medianLoanAmount",
+                    "medianAnnualIncome",
+                    "sampleCount",
+                    "month"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "previous": {
+                "properties": {
+                  "medianAnnualIncome": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "medianLoanAmount": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "sampleCount": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "medianLoanAmount",
+                  "medianAnnualIncome",
+                  "sampleCount"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "current",
+              "previous",
+              "monthly"
+            ],
+            "type": "object"
+          },
+          "funnel": {
+            "properties": {
+              "reLock": {
+                "properties": {
+                  "reLockedCount": {
+                    "type": "number"
+                  },
+                  "sampleCount": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "reLockedCount",
+                  "sampleCount"
+                ],
+                "type": "object"
+              },
+              "timeToClose": {
+                "properties": {
+                  "p25": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "p50": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "p75": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "sampleCount": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "p25",
+                  "p50",
+                  "p75",
+                  "sampleCount"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "timeToClose",
+              "reLock"
+            ],
+            "type": "object"
+          },
+          "pipeline": {
+            "properties": {
+              "expected": {
+                "properties": {
+                  "next30Days": {
+                    "type": "number"
+                  },
+                  "next60Days": {
+                    "type": "number"
+                  },
+                  "next90Days": {
+                    "type": "number"
+                  },
+                  "weekly": {
+                    "items": {
+                      "properties": {
+                        "count": {
+                          "type": "number"
+                        },
+                        "weekStart": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "weekStart",
+                        "count"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "next30Days",
+                  "next60Days",
+                  "next90Days",
+                  "weekly"
+                ],
+                "type": "object"
+              },
+              "funnel": {
+                "properties": {
+                  "application": {
+                    "type": "number"
+                  },
+                  "closing": {
+                    "type": "number"
+                  },
+                  "funded": {
+                    "type": "number"
+                  },
+                  "locked": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "application",
+                  "locked",
+                  "closing",
+                  "funded"
+                ],
+                "type": "object"
+              },
+              "transitions": {
+                "properties": {
+                  "appToLock": {
+                    "properties": {
+                      "converted": {
+                        "type": "number"
+                      },
+                      "p25": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "p50": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "p75": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "priorP50": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "priorSampleCount": {
+                        "type": "number"
+                      },
+                      "reached": {
+                        "type": "number"
+                      },
+                      "sampleCount": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "p25",
+                      "p50",
+                      "p75",
+                      "sampleCount",
+                      "priorP50",
+                      "priorSampleCount",
+                      "reached",
+                      "converted"
+                    ],
+                    "type": "object"
+                  },
+                  "closeToFunding": {
+                    "properties": {
+                      "converted": {
+                        "type": "number"
+                      },
+                      "p25": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "p50": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "p75": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "priorP50": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "priorSampleCount": {
+                        "type": "number"
+                      },
+                      "reached": {
+                        "type": "number"
+                      },
+                      "sampleCount": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "p25",
+                      "p50",
+                      "p75",
+                      "sampleCount",
+                      "priorP50",
+                      "priorSampleCount",
+                      "reached",
+                      "converted"
+                    ],
+                    "type": "object"
+                  }
+                },
+                "required": [
+                  "appToLock",
+                  "closeToFunding"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "transitions",
+              "funnel",
+              "expected"
+            ],
+            "type": "object"
+          },
+          "refiMix": {
+            "properties": {
+              "cashOut": {
+                "properties": {
+                  "medianAmount": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "sampleCount": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "medianAmount",
+                  "sampleCount"
+                ],
+                "type": "object"
+              },
+              "purposes": {
+                "items": {
+                  "properties": {
+                    "count": {
+                      "type": "number"
+                    },
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "count"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "purposes",
+              "cashOut"
+            ],
+            "type": "object"
+          },
+          "refiOpportunity": {
+            "properties": {
+              "baseline": {
+                "nullable": true,
+                "type": "number"
+              },
+              "byLoanType": {
+                "items": {
+                  "properties": {
+                    "count": {
+                      "type": "number"
+                    },
+                    "key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "count"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "byState": {
+                "items": {
+                  "properties": {
+                    "avgRate": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "avgSpreadBps": {
+                      "nullable": true,
+                      "type": "number"
+                    },
+                    "count": {
+                      "type": "number"
+                    },
+                    "state": {
+                      "type": "string"
+                    },
+                    "totalVolume": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "state",
+                    "count",
+                    "totalVolume",
+                    "avgRate",
+                    "avgSpreadBps"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "byVintage": {
+                "items": {
+                  "properties": {
+                    "count": {
+                      "type": "number"
+                    },
+                    "year": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "year",
+                    "count"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "lookbackMonths": {
+                "type": "number"
+              },
+              "medianSpreadBps": {
+                "nullable": true,
+                "type": "number"
+              },
+              "spreadHistogram": {
+                "items": {
+                  "properties": {
+                    "count": {
+                      "type": "number"
+                    },
+                    "spreadBps": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "spreadBps",
+                    "count"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "thresholdBps": {
+                "type": "number"
+              },
+              "topStateConcentrationPct": {
+                "type": "number"
+              },
+              "totals": {
+                "properties": {
+                  "count": {
+                    "type": "number"
+                  },
+                  "medianLoanAmount": {
+                    "nullable": true,
+                    "type": "number"
+                  },
+                  "totalVolume": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "count",
+                  "totalVolume",
+                  "medianLoanAmount"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "baseline",
+              "thresholdBps",
+              "lookbackMonths",
+              "totals",
+              "byState",
+              "spreadHistogram",
+              "medianSpreadBps",
+              "byVintage",
+              "byLoanType",
+              "topStateConcentrationPct"
+            ],
+            "type": "object"
+          },
+          "status": {
+            "properties": {
+              "applications": {
+                "properties": {
+                  "current": {
+                    "type": "number"
+                  },
+                  "prior": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "current",
+                  "prior"
+                ],
+                "type": "object"
+              },
+              "approvals": {
+                "properties": {
+                  "current": {
+                    "type": "number"
+                  },
+                  "prior": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "current",
+                  "prior"
+                ],
+                "type": "object"
+              },
+              "expectedClosings": {
+                "type": "number"
+              },
+              "locks": {
+                "properties": {
+                  "current": {
+                    "type": "number"
+                  },
+                  "prior": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "current",
+                  "prior"
+                ],
+                "type": "object"
+              },
+              "timeToClose": {
+                "properties": {
+                  "current": {
+                    "properties": {
+                      "median": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "sampleCount": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "median",
+                      "sampleCount"
+                    ],
+                    "type": "object"
+                  },
+                  "prior": {
+                    "properties": {
+                      "median": {
+                        "nullable": true,
+                        "type": "number"
+                      },
+                      "sampleCount": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "median",
+                      "sampleCount"
+                    ],
+                    "type": "object"
+                  }
+                },
+                "required": [
+                  "current",
+                  "prior"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "applications",
+              "locks",
+              "approvals",
+              "timeToClose",
+              "expectedClosings"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "MarketSignalsWindow": {
+        "description": "`[gte, lt)` window, YYYY-MM-DD.",
+        "properties": {
+          "gte": {
+            "format": "date",
+            "type": "string"
+          },
+          "lt": {
+            "format": "date",
+            "type": "string"
+          }
+        },
+        "required": [
+          "gte",
+          "lt"
+        ],
+        "type": "object"
+      },
       "MarketSliceDimension": {
         "enum": [
           "state",
@@ -30633,7 +31448,9 @@
           "veteranIndicator",
           "hmdaActionTaken",
           "selfEmployed",
-          "currentHomeOwner"
+          "currentHomeOwner",
+          "lenderType",
+          "lenderVolumeClass"
         ],
         "type": "string"
       },
@@ -44803,7 +45620,7 @@
   "info": {
     "description": "ModelMatch API — mortgage and real-estate market data.\n\n## Bulk delivery limits\n\nThe `POST /{entity}/bulk-delivery` endpoints export a full result set to\nS3 as NDJSON, JSON, CSV, or Parquet.\n\n- **Up to 5,000 rows per delivery: no entitlement required.** Available to\n  every authenticated caller.\n- **Above 5,000 rows: requires the entity's `bulk-delivery.{entity}`\n  entitlement** (e.g. `bulk-delivery.loans`). The grant's scope sets your\n  row ceiling and may also restrict which rows and fields you receive.\n\nA delivery that would exceed the limit available to you is rejected with\n`403 entitlement_missing`, reporting the matched row count and the ceiling\nthat applied. To stay under the limit, pass `limit` — the job then delivers\n(and bills for) only the first `limit` rows of a broader query.\n\n**Need a higher limit?** Email support@modelmatch.com to request the\nentitlement. Limits are raised per organization and per entity.\n\nBulk delivery is billed at 1 credit per delivered row whether or not\nan entitlement is held.\n\nInstead of a download, a delivery can be sent to a push target configured\non your workspace: pass `destination: { type: \"push-target\", targetId }`.\nThe same limits and billing apply.",
     "title": "ModelMatch API",
-    "version": "3.123.1"
+    "version": "3.125.0"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -55618,16 +56435,119 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Monthly loan officer headcount, hires and exits for a company",
+        "summary": "Monthly loan officer headcount, hires and exits for a company",
+        "tags": [
+          "Companies"
+        ]
+      }
+    },
+    "/v1/companies/{nmlsId}/markets": {
+      "post": {
+        "description": "The company's market footprint for a period: a units-weighted summary, the ZIP-level markets, and the city / county / state rollups, computed from the company's recorded transactions. Optionally narrow to a set of ZIP codes and/or a custom date window. Shares are percentages on a 0–100 scale. The summary also carries a Community Lending mix — what kind of neighborhood the book lands in, as U.S. Census tract-level aggregates describing whole neighborhoods, never individual or applicant attributes. Unfiltered, it is the company's own whole-period mix; any ZIP, date or transaction filter recomputes it over the markets in scope, and `summary.communityLending.basis` says which you got.",
+        "operationId": "companyMarkets",
+        "parameters": [
+          {
+            "description": "Company NMLS ID",
+            "in": "path",
+            "name": "nmlsId",
+            "required": true,
+            "schema": {
+              "description": "Company NMLS ID",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompanyMarketsRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompanyMarketsResponse"
+                }
+              }
+            },
+            "description": "Blended market footprint"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error. Includes unresolvable location filters: a `city`/`county`/`state`/`zip` value that does not match a recognized location returns 400 rather than an empty result set. Resolve the name with `instantSearch` (use an id from its `results.locations[]`) or `suggestLocations` (use the `id` of a `source: \"dictionary\"` result), then pass that id back as the filter value."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Where a company lends — blended market footprint",
         "tags": [
           "Companies"
         ]
       }
     },
-    "/v1/companies/{nmlsId}/markets": {
-      "post": {
-        "description": "The company's market footprint for a period: a units-weighted summary, the ZIP-level markets, and the city / county / state rollups, computed from the company's recorded transactions. Optionally narrow to a set of ZIP codes and/or a custom date window. Shares are percentages on a 0–100 scale. The summary also carries a Community Lending mix — what kind of neighborhood the book lands in, as U.S. Census tract-level aggregates describing whole neighborhoods, never individual or applicant attributes. Unfiltered, it is the company's own whole-period mix; any ZIP, date or transaction filter recomputes it over the markets in scope, and `summary.communityLending.basis` says which you got.",
-        "operationId": "companyMarkets",
+    "/v1/companies/{nmlsId}/mover-production": {
+      "get": {
+        "description": "The window's hires and complete departures, each side's combined production across ALL employers recorded inside the production window (default: the same window). Pass a prior window's movers with the current production window to see how past hires and exits perform now.",
+        "operationId": "companyMoverProduction",
         "parameters": [
           {
             "description": "Company NMLS ID",
@@ -55638,27 +56558,78 @@
               "description": "Company NMLS ID",
               "type": "string"
             }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/CompanyMarketsRequest"
-              }
+          },
+          {
+            "description": "Preset window when `from`/`to` are not given (default `last12Months`). Rolling periods start on the FIRST day of the month N months back and end today; a year is Jan 1 – Dec 31; `allTime` starts 2017-01-01, the earliest reliable registration data. Also selects the production period for volume/units.",
+            "in": "query",
+            "name": "period",
+            "required": false,
+            "schema": {
+              "allOf": [
+                {
+                  "$ref": "#/components/schemas/Period"
+                },
+                {
+                  "description": "Preset window when `from`/`to` are not given (default `last12Months`). Rolling periods start on the FIRST day of the month N months back and end today; a year is Jan 1 – Dec 31; `allTime` starts 2017-01-01, the earliest reliable registration data. Also selects the production period for volume/units."
+                }
+              ]
+            }
+          },
+          {
+            "description": "Window start, inclusive (YYYY-MM-DD). Overrides `period`.",
+            "in": "query",
+            "name": "from",
+            "required": false,
+            "schema": {
+              "description": "Window start, inclusive (YYYY-MM-DD). Overrides `period`.",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Window end, inclusive (YYYY-MM-DD). Overrides `period`.",
+            "in": "query",
+            "name": "to",
+            "required": false,
+            "schema": {
+              "description": "Window end, inclusive (YYYY-MM-DD). Overrides `period`.",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Production window start, inclusive (YYYY-MM-DD). Defaults to the mover window's start.",
+            "in": "query",
+            "name": "productionFrom",
+            "required": false,
+            "schema": {
+              "description": "Production window start, inclusive (YYYY-MM-DD). Defaults to the mover window's start.",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Production window end, inclusive (YYYY-MM-DD). Defaults to the mover window's end.",
+            "in": "query",
+            "name": "productionTo",
+            "required": false,
+            "schema": {
+              "description": "Production window end, inclusive (YYYY-MM-DD). Defaults to the mover window's end.",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "type": "string"
             }
           }
-        },
+        ],
         "responses": {
           "200": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CompanyMarketsResponse"
+                  "$ref": "#/components/schemas/CompanyMoverProductionResponse"
                 }
               }
             },
-            "description": "Blended market footprint"
+            "description": "Hires' and exits' production"
           },
           "400": {
             "content": {
@@ -55668,7 +56639,7 @@
                 }
               }
             },
-            "description": "Validation error. Includes unresolvable location filters: a `city`/`county`/`state`/`zip` value that does not match a recognized location returns 400 rather than an empty result set. Resolve the name with `instantSearch` (use an id from its `results.locations[]`) or `suggestLocations` (use the `id` of a `source: \"dictionary\"` result), then pass that id back as the filter value."
+            "description": "Validation error"
           },
           "401": {
             "content": {
@@ -55721,16 +56692,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Where a company lends — blended market footprint",
+        "summary": "Combined production of a company's hires and exits",
         "tags": [
           "Companies"
         ]
       }
     },
-    "/v1/companies/{nmlsId}/mover-production": {
+    "/v1/companies/{nmlsId}/retention": {
       "get": {
-        "description": "The window's hires and complete departures, each side's combined production across ALL employers recorded inside the production window (default: the same window). Pass a prior window's movers with the current production window to see how past hires and exits perform now.",
-        "operationId": "companyMoverProduction",
+        "description": "How well a company keeps its borrowers when they refinance: kept (refinanced again by ANY LO at the company) vs lost to other companies, with the capturing companies and LOs, timing, the trend, a verdict, and per-LO retention for the company's own loan officers. Precomputed weekly — `computedAt` says when. 404 means not computed (no loans since 2017, or not reached yet), never zero retention.",
+        "operationId": "companyRetention",
         "parameters": [
           {
             "description": "Company NMLS ID",
@@ -55743,62 +56714,17 @@
             }
           },
           {
-            "description": "Preset window when `from`/`to` are not given (default `last12Months`). Rolling periods start on the FIRST day of the month N months back and end today; a year is Jan 1 – Dec 31; `allTime` starts 2017-01-01, the earliest reliable registration data. Also selects the production period for volume/units.",
-            "in": "query",
-            "name": "period",
-            "required": false,
-            "schema": {
-              "allOf": [
-                {
-                  "$ref": "#/components/schemas/Period"
-                },
-                {
-                  "description": "Preset window when `from`/`to` are not given (default `last12Months`). Rolling periods start on the FIRST day of the month N months back and end today; a year is Jan 1 – Dec 31; `allTime` starts 2017-01-01, the earliest reliable registration data. Also selects the production period for volume/units."
-                }
-              ]
-            }
-          },
-          {
-            "description": "Window start, inclusive (YYYY-MM-DD). Overrides `period`.",
-            "in": "query",
-            "name": "from",
-            "required": false,
-            "schema": {
-              "description": "Window start, inclusive (YYYY-MM-DD). Overrides `period`.",
-              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Window end, inclusive (YYYY-MM-DD). Overrides `period`.",
-            "in": "query",
-            "name": "to",
-            "required": false,
-            "schema": {
-              "description": "Window end, inclusive (YYYY-MM-DD). Overrides `period`.",
-              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Production window start, inclusive (YYYY-MM-DD). Defaults to the mover window's start.",
-            "in": "query",
-            "name": "productionFrom",
-            "required": false,
-            "schema": {
-              "description": "Production window start, inclusive (YYYY-MM-DD). Defaults to the mover window's start.",
-              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-              "type": "string"
-            }
-          },
-          {
-            "description": "Production window end, inclusive (YYYY-MM-DD). Defaults to the mover window's end.",
+            "description": "`last12Months` (the trailing 12 months to the computation date, with the 12 months before as `previous`) or `allTime` (2017-01-01 on). Default `last12Months`.",
             "in": "query",
-            "name": "productionTo",
+            "name": "window",
             "required": false,
             "schema": {
-              "description": "Production window end, inclusive (YYYY-MM-DD). Defaults to the mover window's end.",
-              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "default": "last12Months",
+              "description": "`last12Months` (the trailing 12 months to the computation date, with the 12 months before as `previous`) or `allTime` (2017-01-01 on). Default `last12Months`.",
+              "enum": [
+                "last12Months",
+                "allTime"
+              ],
               "type": "string"
             }
           }
@@ -55808,11 +56734,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CompanyMoverProductionResponse"
+                  "$ref": "#/components/schemas/CompanyRetentionSnapshot"
                 }
               }
             },
-            "description": "Hires' and exits' production"
+            "description": "The stored snapshot"
           },
           "400": {
             "content": {
@@ -55875,16 +56801,16 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Combined production of a company's hires and exits",
+        "summary": "Company borrower retention (weekly snapshot)",
         "tags": [
           "Companies"
         ]
       }
     },
-    "/v1/companies/{nmlsId}/retention": {
+    "/v1/companies/{nmlsId}/retention/active-listings": {
       "get": {
-        "description": "How well a company keeps its borrowers when they refinance: kept (refinanced again by ANY LO at the company) vs lost to other companies, with the capturing companies and LOs, timing, the trend, a verdict, and per-LO retention for the company's own loan officers. Precomputed weekly — `computedAt` says when. 404 means not computed (no loans since 2017, or not reached yet), never zero retention.",
-        "operationId": "companyRetention",
+        "description": "The company's retained borrowers (their latest loan is still the company's) whose home is listed for sale right now, each with the company loan officer who wrote that loan — only LOs the company employed on the loan, not brokers' LOs on loans it only funded. Newest listing first; filter to one LO with `originator`. \"Listed now\" is the LO Borrower Retention tab's rule: an active MLS listing event in the last 90 days, list price at least $20k, not under contract. Checked weekly with the retention snapshot — `computedAt` says when. 404 means not computed for this company yet.",
+        "operationId": "companyRetentionActiveListings",
         "parameters": [
           {
             "description": "Company NMLS ID",
@@ -55897,17 +56823,36 @@
             }
           },
           {
-            "description": "`last12Months` (the trailing 12 months to the computation date, with the 12 months before as `previous`) or `allTime` (2017-01-01 on). Default `last12Months`.",
+            "description": "Only rows whose loan was written by this LO (NMLS id) — e.g. one of `activeListings.topOriginators`.",
             "in": "query",
-            "name": "window",
+            "name": "originator",
             "required": false,
             "schema": {
-              "default": "last12Months",
-              "description": "`last12Months` (the trailing 12 months to the computation date, with the 12 months before as `previous`) or `allTime` (2017-01-01 on). Default `last12Months`.",
-              "enum": [
-                "last12Months",
-                "allTime"
-              ],
+              "description": "Only rows whose loan was written by this LO (NMLS id) — e.g. one of `activeListings.topOriginators`.",
+              "pattern": "^\\d+$",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Page size (1-100, default 25).",
+            "in": "query",
+            "name": "size",
+            "required": false,
+            "schema": {
+              "description": "Page size (1-100, default 25).",
+              "example": 25,
+              "maximum": 100,
+              "minimum": 1,
+              "type": "integer"
+            }
+          },
+          {
+            "description": "Opaque cursor from the previous page's `cursor`.",
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "description": "Opaque cursor from the previous page's `cursor`.",
               "type": "string"
             }
           }
@@ -55917,11 +56862,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CompanyRetentionSnapshot"
+                  "$ref": "#/components/schemas/CompanyActiveListingsResponse"
                 }
               }
             },
-            "description": "The stored snapshot"
+            "description": "One page of listing rows"
           },
           "400": {
             "content": {
@@ -55984,7 +56929,7 @@
             "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
           }
         },
-        "summary": "Company borrower retention (weekly snapshot)",
+        "summary": "Retained borrowers listed for sale now (weekly)",
         "tags": [
           "Companies"
         ]
@@ -74764,6 +75709,96 @@
         ]
       }
     },
+    "/v1/market/signals": {
+      "post": {
+        "operationId": "marketSignals",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/MarketSignalsRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MarketSignalsResponse"
+                }
+              }
+            },
+            "description": "The requested stats"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Validation error"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unauthorized"
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Forbidden (authenticated, but missing required context — e.g. no active organization)"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Not found"
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PayloadTooLarge"
+                }
+              }
+            },
+            "description": "Response payload too large — detail endpoint capped to fit Lambda response limits"
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchUnavailable"
+                }
+              }
+            },
+            "description": "Search timed out or the cluster is overloaded — retry after `Retry-After` seconds."
+          }
+        },
+        "summary": "Market Signals card stats (web app feed)",
+        "tags": [
+          "Market"
+        ]
+      }
+    },
     "/v1/me": {
       "get": {
         "description": "Identity, active organization + membership role, and how the caller authenticated.\n\nExtended profile fields (`nmlsId`, `jobRole`, the contact-card block) are resolved for every caller type — session-cookie, API-key, and OAuth-bearer alike. `auth.profileResolved` is `true` on any successful read; it is retained for compatibility and no longer varies by the credential the caller presented.",