> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altss.com/llms.txt
> Use this file to discover all available pages before exploring further.

# US state house price index

> Up to four quarterly all-transactions index levels and year-over-year changes from FHFA.

Up to four quarterly all-transactions index levels and year-over-year changes from FHFA.

**Operation ID:** `real_estate.price_index`. **Family:** [Real Estate & Assets](https://docs.altss.com/console/families/real-estate-assets.md).

[Read the live operation contract (JSON)](https://console.altss.com/v1/console/capabilities/real_estate.price_index) for the current input and output schemas, price, limits and required scopes.

**Status:** Available (`AVAILABLE`). **Supported interfaces:** REST, MCP.

**Commercial status:** Available. Receive the structured result and receipt in Console after the run settles.

**Execution interfaces:** UI, REST, MCP.

## When to use it

Read the four quarterly FHFA All-Transactions House Price Index observations for New York in 2025.

## Price and billing unit

Request a quote for one US state house price index. Review its inputs, delivery plan, use terms and maximum charge before accepting. Retrying the same purchase uses the same idempotency key.

**Price:** \$0.05. **Billing unit:** per successful delivery.

**Charge condition:** The authorized execution delivers a validated result and settles once. Failed pre-settlement executions are not charged; reservation release must be confirmed. Retrieve the same run if charge state is uncertain.

**Execution budget:** Maximum \$0.05 per accepted execution.

Fund your Console wallet, review the quote and approve the charge before execution.

## Inputs

US state and year

```json theme={null}
{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "enum": [
        "AL",
        "AK",
        "AZ",
        "AR",
        "CA",
        "CO",
        "CT",
        "DE",
        "DC",
        "FL",
        "GA",
        "HI",
        "ID",
        "IL",
        "IN",
        "IA",
        "KS",
        "KY",
        "LA",
        "ME",
        "MD",
        "MA",
        "MI",
        "MN",
        "MS",
        "MO",
        "MT",
        "NE",
        "NV",
        "NH",
        "NJ",
        "NM",
        "NY",
        "NC",
        "ND",
        "OH",
        "OK",
        "OR",
        "PA",
        "RI",
        "SC",
        "SD",
        "TN",
        "TX",
        "UT",
        "VT",
        "VA",
        "WA",
        "WV",
        "WI",
        "WY"
      ]
    },
    "year": {
      "type": "integer",
      "minimum": 1975,
      "maximum": 2100
    }
  },
  "required": [
    "state",
    "year"
  ],
  "additionalProperties": false
}
```

## Result and output schema

Up to four quarterly all-transactions index levels and year-over-year changes from FHFA.

```json theme={null}
{
  "$ref": "https://console.altss.com/openapi.json#/components/schemas/Result_real_estate_price_index"
}
```

## Examples

Illustrative request and result for this scope. The names, values and record references are examples. Actual delivery depends on the published availability and agreed scope.

### Example input

```json theme={null}
{
  "state": "NY",
  "year": 2025
}
```

### Example structured output

```json theme={null}
{
  "quarters": [
    {
      "quarter": 1,
      "index": 1088.07,
      "priorYearIndex": 1012.1,
      "annualChangePercent": 7.51
    }
  ]
}
```

## API example and execution

[Verified production contract](https://console.altss.com/openapi.json) · Base URL: `https://console.altss.com/v1/console`. Quote first. Obtain explicit approval of the price, plan and use terms before sending accept:true. Reuse the same purchase idempotency key on retries.

Required scope: `company.read`. Organization authority, funding checks and spending limits apply to paid execution.

Supply credentials in the documented authorization header. Replace a placeholder run ID with an actual authorized run ID.

```json theme={null}
{
  "method": "POST",
  "url": "https://console.altss.com/v1/console/quote",
  "body": {
    "toolId": "real_estate.price_index",
    "input": {
      "state": "NY",
      "year": 2025
    }
  }
}
```

This example requests a quote. A paid run requires the unchanged returned quote, explicit acceptance and a stable idempotency key.

## MCP and A2A

**Supported interfaces:** REST, MCP. Current MCP tools: `altss_quote`, `altss_run`, `altss_get_run`. Inspect tools/list and inputSchema before use. Paid A2A execution is unavailable. The separate anonymous A2A reader serves public information.

[REST guide](https://docs.altss.com/console/rest.md) · [MCP guide](https://docs.altss.com/console/mcp.md) · [A2A scope](https://docs.altss.com/console/a2a.md) · [Authentication and credentials](https://docs.altss.com/console/authentication.md)

## Sources, evidence and freshness

* Public records and official sources
* Altss intelligence and source collections

Retain source attribution, observation and event dates, evidence and explicit unknowns where supplied. A record update is not independent verification.

Historical source collection dates describe when the material was observed. Coverage and freshness depend on each returned source. Preserve its observation date and use restrictions with the result.

## Limits and permitted use

* Includes: Get quarterly FHFA all-transactions house price index levels for one state and year, with annual percentage changes against the same quarter a year earlier where available.; Public source and retrieval date. Excludes: Contact details; Raw public records. Requires scope company.read. Source: public registry.
* A timeout does not establish the final charge. Retrieve the existing run before retrying.

Use is limited by the accepted quote or agreed delivery scope, source restrictions and privacy controls. Storage, attribution, retention, redistribution and training permissions do not expand through normalization.

## Next step

[Try Console](https://console.altss.com/signup?src=buyer-intent\&cta=capability\&capability=real_estate.price_index) · [Open Console workspace](https://console.altss.com/console/playground/new?capability=real_estate.price_index) · [View the capability on Altss](https://altss.com/console/capabilities/real_estate.price_index) · [Wallet and billing](https://docs.altss.com/console/billing.md)

[Back to Real Estate & Assets](https://docs.altss.com/console/families/real-estate-assets.md) · [All capabilities](https://docs.altss.com/console/capabilities.md) · [Price schedule](https://docs.altss.com/console/prices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.