Homecastr
    MarketsIntegrationsCode & APIMethodologyCompany
    MarketsOpen Map

    Explore Homecastr.

    View parcel and neighborhood forecasts, compare markets, or build with the API.

    Get Free API KeyGet My ForecastBrowse Markets
    DocsStart HereForecastsData CatalogBenchmarksREST Quickstart
    Homecastr

    The foundation model of physical development.

    Product

    Explore
    • Forecast Map
    • Browse Markets
    • Prompt Library
    Build
    • API
    • MCP Server

    Documentation

    Learn
    • Start Here
    • Forecasts
    • REST Quickstart
    Reference
    • Full API Reference
    • MCP Tools
    SDKs
    • TypeScript SDK
    • Python SDK

    Research

    Models and data
    • Methodology
    • Data Catalog
    • Benchmarks
    • Schema Reference
    Reliability
    • Status

    Company

    Organization
    • About
    • Careers
    • Pitch deck
    • Credits
    Help
    • FAQ
    • Support

    Legal

    Policies
    • Privacy
    • Terms
    Email
    daniel@homecastr.com
    Phone
    +1 (713) 371-7875
    Address
    South Park Commons
    36 Cooper Sq, Fl 6
    New York, NY 10003
    Hours

    Mon-Fri
    10am-6pm ET

    Copyright 2026 Homecastr. All rights reserved.
    Canonical schema reference

    One vocabulary from raw source to forecast delivery.

    The hc.*.v1 contracts keep entity, time, metric, version, provenance, and policy fields stable across REST, MCP, OpenAPI, and SDKs.

    Open schema JSON Browse data assets
    Universal keys
    • Identity
      entity type, ID, namespace, geography vintage
    • Time
      period, publication, retrieval, availability, origin
    • Metric
      metric ID, units, value kind, aggregation
    • Version
      schema, transform, feature set, model, snapshot
    • Policy
      visibility, license, allowed use, sensitivity
    Lifecycle

    The contracts most consumers encounter

    Raw
    hc.source_snapshot.v1

    Immutable source payload identity, retrieval time, terms evidence, and content hash.

    Normalized
    hc.observation.v1

    Entity, time, metric, unit, value, missingness, and source-record references.

    Engineered
    hc.feature_record.v1

    Versioned transforms, parent records, quality flags, and leakage checks.

    Panelized
    hc.panel_row.v1

    Point-in-time entity-period rows with feature-set and split identity.

    Forecast
    hc.forecast_series.v1

    Origin, horizon, model version, quantiles, and scenario identity.

    Benchmark
    hc.benchmark_result.v1

    Pinned datasets, cutoffs, baselines, score rows, and sample counts.

    Delivery
    hc.dataset_asset.v1

    Discovery, policy, provenance, files, and access independently from payloads.

    Complete registry

    All canonical schemas

    26 contracts

    AccessPolicy

    hc.access_policy.v1
    11 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, prediction_market_input, product_internal, provenance_manifest, research_internal, schema, source_metadata, training_panel
    Required fields and machine contract

    Required: policy_id, visibility, sensitivity, license_status, allowed_uses, denied_uses, row_level_floor

    Open schema definition

    ArtifactManifest

    hc.artifact_manifest.v1
    0 fields

    Used by: backtest_output, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, research_internal, schema, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    BenchmarkResult

    hc.benchmark_result.v1
    0 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, model_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    BenchmarkScore

    hc.benchmark_score.v1
    9 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: metric_name, value, aggregation_level

    Open schema definition

    ContractMetadata

    hc.contract_metadata.v1
    8 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: schema_id, schema_version, record_id, asset_id, data_snapshot_id, created_at

    Open schema definition

    DataAccessSummary

    hc.data_access_summary.v1
    5 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: visibility, support_level, sensitivity, training_eligibility, license_status

    Open schema definition

    DataCoverageSummary

    hc.data_coverage_summary.v1
    15 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: source_count, lineage_edge_count, panel_count, official_link_count, missing_official_url_count, source_coverage_index_count, by_source_tier, by_source_status, by_source_family, by_license_status, by_geography, by_resolution, source_index, map, panels

    Open schema definition

    DatasetAsset

    hc.dataset_asset.v1
    0 fields

    Used by: benchmark_metadata, provenance_manifest, schema, source_metadata
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    EntityReference

    hc.entity_reference.v1
    6 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: entity_type, entity_id

    Open schema definition

    FeatureRecord

    hc.feature_record.v1
    0 fields

    Used by: context_input, input_panel, prediction_market_input, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ForecastPoint

    hc.forecast_point.v1
    10 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: forecast_time, horizon, p50

    Open schema definition

    ForecastSeries

    hc.forecast_series.v1
    0 fields

    Used by: forecast_output
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ForecastVintage

    hc.forecast_vintage.v1
    0 fields

    Used by: backtest_output, forecast_output
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    MetricReference

    hc.metric_reference.v1
    8 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: metric_id, value_kind, unit

    Open schema definition

    ModelArtifact

    hc.model_artifact.v1
    0 fields

    Used by: model_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    Observation

    hc.observation.v1
    0 fields

    Used by: benchmark_panel, context_input, geography_reference, input_panel, prediction_market_input, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    OperationalRecord

    hc.operational_record.v1
    0 fields

    Used by: ops_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    PanelLineage

    hc.panel_lineage.v1
    13 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: panel_id, panel_name, source_id, source_role, join_keys, join_method, transform_id, availability_rule, output_fields, status, evidence_file

    Open schema definition

    PanelRow

    hc.panel_row.v1
    0 fields

    Used by: benchmark_panel, context_input, input_panel, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ProductEvent

    hc.product_event.v1
    0 fields

    Used by: ops_internal, product_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ProvenanceManifest

    hc.provenance_manifest.v1
    0 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, prediction_market_input, product_internal, provenance_manifest, research_internal, schema, source_metadata, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    PublicRecordsAcquisition

    hc.public_records_acquisition.v1
    19 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: lane_id, source_family, source_families, geography, geography_tokens, current_status, durable_cloud_evidence, object_count, byte_count, public_route_evidence, records_law_gate, holdbacks, next_step, fold_in_source, benchmark_role, training_eligibility, related_artifact_ids, access, _links

    Open schema definition

    SourceInventory

    hc.source_inventory.v1
    29 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: source_id, source_name, source_family, source_status, panel_status, official_urls, license_status, sensitivity, geography, resolution, public_readiness, training_eligibility, provenance_id, evidence_file

    Open schema definition

    SourceSnapshot

    hc.source_snapshot.v1
    0 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, prediction_market_input, product_internal, provenance_manifest, research_internal, schema, source_metadata, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    SyntheticRecord

    hc.synthetic_record.v1
    0 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    TimeReference

    hc.time_reference.v1
    8 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: period_start, period_end, available_at

    Open schema definition
    Database compatibility notes

    These table mappings are implementation bridges, not public wire contracts. Public consumers should bind to the canonical schemas above.

    geo_county_us.geoid

    Source: geo_county20_us.county_fips

    County forecasts expect a normalized geography key.

    geo_tabblock20_us.geoid

    Source: geo_tabblock20_us.geoid

    Production tabblocks use the national table; Texas-specific tables remain compatibility fallbacks.

    geo_state_us.geoid

    Source: state_forecast_by_year.geoid

    State forecast rows join on the normalized geography key.

    tract_name_cache

    Source: geo_tract20_us

    Tract labels and autocomplete values are derived from the canonical tract geography.

    Documentation

    Start with the job you need to do, then move into the complete interface reference.

    Start and build

    Choose a task before choosing a protocol.

    Start HereForecastsData CatalogBenchmarks

    Interfaces

    REST, MCP, and typed client references.

    REST QuickstartFull API ReferenceMCP ToolsTypeScript SDKPython SDK

    Trust and operations

    Contracts, methodology, and live health.

    Schema ReferenceStatusMethodology
    Canonical schema reference

    One vocabulary from raw source to forecast delivery.

    The hc.*.v1 contracts keep entity, time, metric, version, provenance, and policy fields stable across REST, MCP, OpenAPI, and SDKs.

    Open schema JSON Browse data assets
    Universal keys
    • Identity
      entity type, ID, namespace, geography vintage
    • Time
      period, publication, retrieval, availability, origin
    • Metric
      metric ID, units, value kind, aggregation
    • Version
      schema, transform, feature set, model, snapshot
    • Policy
      visibility, license, allowed use, sensitivity
    Lifecycle

    The contracts most consumers encounter

    Raw
    hc.source_snapshot.v1

    Immutable source payload identity, retrieval time, terms evidence, and content hash.

    Normalized
    hc.observation.v1

    Entity, time, metric, unit, value, missingness, and source-record references.

    Engineered
    hc.feature_record.v1

    Versioned transforms, parent records, quality flags, and leakage checks.

    Panelized
    hc.panel_row.v1

    Point-in-time entity-period rows with feature-set and split identity.

    Forecast
    hc.forecast_series.v1

    Origin, horizon, model version, quantiles, and scenario identity.

    Benchmark
    hc.benchmark_result.v1

    Pinned datasets, cutoffs, baselines, score rows, and sample counts.

    Delivery
    hc.dataset_asset.v1

    Discovery, policy, provenance, files, and access independently from payloads.

    Complete registry

    All canonical schemas

    26 contracts

    AccessPolicy

    hc.access_policy.v1
    11 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, prediction_market_input, product_internal, provenance_manifest, research_internal, schema, source_metadata, training_panel
    Required fields and machine contract

    Required: policy_id, visibility, sensitivity, license_status, allowed_uses, denied_uses, row_level_floor

    Open schema definition

    ArtifactManifest

    hc.artifact_manifest.v1
    0 fields

    Used by: backtest_output, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, research_internal, schema, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    BenchmarkResult

    hc.benchmark_result.v1
    0 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, model_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    BenchmarkScore

    hc.benchmark_score.v1
    9 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: metric_name, value, aggregation_level

    Open schema definition

    ContractMetadata

    hc.contract_metadata.v1
    8 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: schema_id, schema_version, record_id, asset_id, data_snapshot_id, created_at

    Open schema definition

    DataAccessSummary

    hc.data_access_summary.v1
    5 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: visibility, support_level, sensitivity, training_eligibility, license_status

    Open schema definition

    DataCoverageSummary

    hc.data_coverage_summary.v1
    15 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: source_count, lineage_edge_count, panel_count, official_link_count, missing_official_url_count, source_coverage_index_count, by_source_tier, by_source_status, by_source_family, by_license_status, by_geography, by_resolution, source_index, map, panels

    Open schema definition

    DatasetAsset

    hc.dataset_asset.v1
    0 fields

    Used by: benchmark_metadata, provenance_manifest, schema, source_metadata
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    EntityReference

    hc.entity_reference.v1
    6 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: entity_type, entity_id

    Open schema definition

    FeatureRecord

    hc.feature_record.v1
    0 fields

    Used by: context_input, input_panel, prediction_market_input, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ForecastPoint

    hc.forecast_point.v1
    10 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: forecast_time, horizon, p50

    Open schema definition

    ForecastSeries

    hc.forecast_series.v1
    0 fields

    Used by: forecast_output
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ForecastVintage

    hc.forecast_vintage.v1
    0 fields

    Used by: backtest_output, forecast_output
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    MetricReference

    hc.metric_reference.v1
    8 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: metric_id, value_kind, unit

    Open schema definition

    ModelArtifact

    hc.model_artifact.v1
    0 fields

    Used by: model_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    Observation

    hc.observation.v1
    0 fields

    Used by: benchmark_panel, context_input, geography_reference, input_panel, prediction_market_input, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    OperationalRecord

    hc.operational_record.v1
    0 fields

    Used by: ops_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    PanelLineage

    hc.panel_lineage.v1
    13 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: panel_id, panel_name, source_id, source_role, join_keys, join_method, transform_id, availability_rule, output_fields, status, evidence_file

    Open schema definition

    PanelRow

    hc.panel_row.v1
    0 fields

    Used by: benchmark_panel, context_input, input_panel, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ProductEvent

    hc.product_event.v1
    0 fields

    Used by: ops_internal, product_internal
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    ProvenanceManifest

    hc.provenance_manifest.v1
    0 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, prediction_market_input, product_internal, provenance_manifest, research_internal, schema, source_metadata, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    PublicRecordsAcquisition

    hc.public_records_acquisition.v1
    19 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: lane_id, source_family, source_families, geography, geography_tokens, current_status, durable_cloud_evidence, object_count, byte_count, public_route_evidence, records_law_gate, holdbacks, next_step, fold_in_source, benchmark_role, training_eligibility, related_artifact_ids, access, _links

    Open schema definition

    SourceInventory

    hc.source_inventory.v1
    29 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: source_id, source_name, source_family, source_status, panel_status, official_urls, license_status, sensitivity, geography, resolution, public_readiness, training_eligibility, provenance_id, evidence_file

    Open schema definition

    SourceSnapshot

    hc.source_snapshot.v1
    0 fields

    Used by: backtest_output, benchmark_metadata, benchmark_panel, context_input, forecast_output, geography_reference, input_panel, model_internal, ops_internal, prediction_market_input, product_internal, provenance_manifest, research_internal, schema, source_metadata, training_panel
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    SyntheticRecord

    hc.synthetic_record.v1
    0 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: No globally required fields

    Open schema definition

    TimeReference

    hc.time_reference.v1
    8 fields

    Used by: delivery metadata
    Required fields and machine contract

    Required: period_start, period_end, available_at

    Open schema definition
    Database compatibility notes

    These table mappings are implementation bridges, not public wire contracts. Public consumers should bind to the canonical schemas above.

    geo_county_us.geoid

    Source: geo_county20_us.county_fips

    County forecasts expect a normalized geography key.

    geo_tabblock20_us.geoid

    Source: geo_tabblock20_us.geoid

    Production tabblocks use the national table; Texas-specific tables remain compatibility fallbacks.

    geo_state_us.geoid

    Source: state_forecast_by_year.geoid

    State forecast rows join on the normalized geography key.

    tract_name_cache

    Source: geo_tract20_us

    Tract labels and autocomplete values are derived from the canonical tract geography.

    Documentation

    Start with the job you need to do, then move into the complete interface reference.

    Start and build

    Choose a task before choosing a protocol.

    Start HereForecastsData CatalogBenchmarks

    Interfaces

    REST, MCP, and typed client references.

    REST QuickstartFull API ReferenceMCP ToolsTypeScript SDKPython SDK

    Trust and operations

    Contracts, methodology, and live health.

    Schema ReferenceStatusMethodology