{"openapi":"3.1.0","info":{"title":"FINCO Model API","description":"Programmatic access to FINCO canonical reference models, capacity previews, and Radar equity data. All endpoints are read-only. No project is created by any call.","version":"1.0.0"},"paths":{"/api/v1/capabilities":{"get":{"summary":"Get Capabilities","description":"Return the canonical product-capability registry.\n\nRead-only, deterministic, user-state-free.  Sourced directly from\napp.product_capability — the single source of truth for what FINCO\nsupports today.","operationId":"get_capabilities_api_v1_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/model/references":{"get":{"summary":"List Model References","description":"List all canonical model references.","operationId":"list_model_references_api_v1_model_references_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferenceListEnvelope"}}}}}}},"/api/v1/model/references/{reference_key}":{"get":{"summary":"Get Model Reference","description":"Return full grouped reference detail for one canonical reference.","operationId":"get_model_reference_api_v1_model_references__reference_key__get","parameters":[{"name":"reference_key","in":"path","required":true,"schema":{"type":"string","title":"Reference Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferenceEnvelope"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/model/references/{reference_key}/capex":{"get":{"summary":"Get Model Reference Capex","description":"Return canonical CAPEX items for one reference.","operationId":"get_model_reference_capex_api_v1_model_references__reference_key__capex_get","parameters":[{"name":"reference_key","in":"path","required":true,"schema":{"type":"string","title":"Reference Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferenceEnvelope"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/model/references/{reference_key}/opex":{"get":{"summary":"Get Model Reference Opex","description":"Return canonical OPEX items for one reference.","operationId":"get_model_reference_opex_api_v1_model_references__reference_key__opex_get","parameters":[{"name":"reference_key","in":"path","required":true,"schema":{"type":"string","title":"Reference Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferenceEnvelope"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/model/references/{reference_key}/preview":{"post":{"summary":"Post Model Reference Preview","description":"Stateless capacity-scaling preview for one canonical reference.\n\nReturns scaled CAPEX/OPEX seed rows and preserved reference assumptions\nfor the requested capacity_mw. No project is created. No model runs.","operationId":"post_model_reference_preview_api_v1_model_references__reference_key__preview_post","parameters":[{"name":"reference_key","in":"path","required":true,"schema":{"type":"string","title":"Reference Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferencePreviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferencePreviewEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/model/references/{reference_key}/run":{"post":{"summary":"Post Model Reference Run","description":"Stateless production model run for one canonical reference at requested capacity.\n\nExecutes exactly one canonical production financial calculation (clean G2C engine).\nReturns summary KPIs. Zero project creation. Zero DB writes. Zero persistence.","operationId":"post_model_reference_run_api_v1_model_references__reference_key__run_post","parameters":[{"name":"reference_key","in":"path","required":true,"schema":{"type":"string","title":"Reference Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferenceRunRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelReferenceRunEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/tokenized":{"get":{"summary":"Crypto Tokenized Landing","description":"Cross-venue Tokenized Markets landing (tokenized.basic — public).","operationId":"crypto_tokenized_landing_api_v1_crypto_tokenized_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":60,"minimum":1},{"type":"null"}],"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/tokenized/{canonical_asset_id}":{"get":{"summary":"Crypto Tokenized Detail","description":"One canonical underlying: reference + representations + basis\n(tokenized.basic — public; premium fields redacted per access).","operationId":"crypto_tokenized_detail_api_v1_crypto_tokenized__canonical_asset_id__get","parameters":[{"name":"canonical_asset_id","in":"path","required":true,"schema":{"type":"string","title":"Canonical Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/tokenized/{canonical_asset_id}/signals":{"get":{"summary":"Crypto Tokenized Signals","description":"Full historical R5 signal evidence, requiring BOTH premium resources.\n\ncrypto.api is checked first. The lifecycle read is not imported or\nexecuted until history AND dislocation checks have passed. This changes\nnothing about the existing independently entitled /dislocations API.","operationId":"crypto_tokenized_signals_api_v1_crypto_tokenized__canonical_asset_id__signals_get","parameters":[{"name":"canonical_asset_id","in":"path","required":true,"schema":{"type":"string","title":"Canonical Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/tokenized/{canonical_asset_id}/integrity":{"get":{"summary":"Crypto Tokenized Integrity","description":"Canonical RWA Integrity evidence profile (read-only, acquisition-free).\n\nAccess is controlled only by crypto.api.  Browser/public Integrity evidence\nhas no separate token-holder entitlement resource in V1.","operationId":"crypto_tokenized_integrity_api_v1_crypto_tokenized__canonical_asset_id__integrity_get","parameters":[{"name":"canonical_asset_id","in":"path","required":true,"schema":{"type":"string","title":"Canonical Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/tokenized/{canonical_asset_id}/history":{"get":{"summary":"Crypto Tokenized History","description":"Canonical basis history (tokenized.history — holder resource).","operationId":"crypto_tokenized_history_api_v1_crypto_tokenized__canonical_asset_id__history_get","parameters":[{"name":"canonical_asset_id","in":"path","required":true,"schema":{"type":"string","title":"Canonical Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/tokenized/{canonical_asset_id}/dislocations":{"get":{"summary":"Crypto Tokenized Dislocations","description":"Cross-venue divergence + dislocation events\n(tokenized.dislocation — holder resource).","operationId":"crypto_tokenized_dislocations_api_v1_crypto_tokenized__canonical_asset_id__dislocations_get","parameters":[{"name":"canonical_asset_id","in":"path","required":true,"schema":{"type":"string","title":"Canonical Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/crypto/yield":{"get":{"summary":"Crypto Yield Landing","description":"Yield market intelligence (canonical history — read-only).","operationId":"crypto_yield_landing_api_v1_crypto_yield_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/crypto/yield/{canonical_id}":{"get":{"summary":"Crypto Yield Detail","description":"One Yield pool.\n\ncrypto.api ALLOW resolves first.  Then YieldResource.HISTORY is resolved\nBEFORE any protected history intelligence is built: denied callers get\nthe BASIC pool payload (identity + current registry observation fields +\nprovenance) and the history-derived intelligence is never constructed —\nnot built-then-redacted.  This mirrors the existing Yield UI contract.\nAn access-authority failure fails closed (typed unavailable, no 500).","operationId":"crypto_yield_detail_api_v1_crypto_yield__canonical_id__get","parameters":[{"name":"canonical_id","in":"path","required":true,"schema":{"type":"string","title":"Canonical Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/radar/assets":{"get":{"summary":"List Radar Assets","description":"List all canonical Radar assets from the current registry snapshot.","operationId":"list_radar_assets_api_v1_radar_assets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetListEnvelope"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}}}}}},"/api/v1/radar/assets/{economic_asset_uid}":{"get":{"summary":"Get Radar Asset","description":"Return canonical identity for one asset by its economic_asset_uid.\n\nTop-level state is always AVAILABLE when the registry resolves the UID.\nThe fundamentals_state field in data carries the equity DB availability.","operationId":"get_radar_asset_api_v1_radar_assets__economic_asset_uid__get","parameters":[{"name":"economic_asset_uid","in":"path","required":true,"schema":{"type":"string","title":"Economic Asset Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/radar/assets/{economic_asset_uid}/fundamentals":{"get":{"summary":"Get Radar Fundamentals","description":"Return latest TTM/quarterly/annual fundamentals + company profile.","operationId":"get_radar_fundamentals_api_v1_radar_assets__economic_asset_uid__fundamentals_get","parameters":[{"name":"economic_asset_uid","in":"path","required":true,"schema":{"type":"string","title":"Economic Asset Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/radar/assets/{economic_asset_uid}/financials":{"get":{"summary":"Get Radar Financials","description":"Return multi-period financial history (annual, quarterly, TTM).","operationId":"get_radar_financials_api_v1_radar_assets__economic_asset_uid__financials_get","parameters":[{"name":"economic_asset_uid","in":"path","required":true,"schema":{"type":"string","title":"Economic Asset Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/radar/assets/{economic_asset_uid}/corporate-actions":{"get":{"summary":"Get Radar Corporate Actions","description":"Return recent dividend and stock split history.","operationId":"get_radar_corporate_actions_api_v1_radar_assets__economic_asset_uid__corporate_actions_get","parameters":[{"name":"economic_asset_uid","in":"path","required":true,"schema":{"type":"string","title":"Economic Asset Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/radar/assets/{economic_asset_uid}/evidence":{"get":{"summary":"Get Radar Evidence","description":"Return source lineage / evidence for one asset.","operationId":"get_radar_evidence_api_v1_radar_assets__economic_asset_uid__evidence_get","parameters":[{"name":"economic_asset_uid","in":"path","required":true,"schema":{"type":"string","title":"Economic Asset Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadarEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/radar/assets/{economic_asset_uid}/execution-simulation":{"post":{"summary":"Post Execution Simulation","description":"Read-only execution simulation for a tokenized Robinhood equity.\n\nReturns canonical reference price, executable price, and directional GAP\nfor the requested direction and notional.  Does NOT submit an order,\nconnect a wallet, approve tokens, or recommend a trade direction.\n\nsimulation_only: true  — this is analytics, not execution.\norder_submitted: false — no transaction is sent or signed.","operationId":"post_execution_simulation_api_v1_radar_assets__economic_asset_uid__execution_simulation_post","parameters":[{"name":"economic_asset_uid","in":"path","required":true,"schema":{"type":"string","title":"Economic Asset Uid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionSimulationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionSimulationEnvelope"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Not Found"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/meta":{"get":{"summary":"Get Api Meta","description":"API version and capability declaration.","operationId":"get_api_meta_api_v1_meta_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ApiErrorEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"error":{"type":"string","title":"Error"},"detail":{"type":"string","title":"Detail"},"economic_asset_uid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Economic Asset Uid"}},"type":"object","required":["error","detail"],"title":"ApiErrorEnvelope"},"AssetListEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["state"],"title":"AssetListEnvelope"},"ExecutionSimulationEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"economic_asset_uid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Economic Asset Uid"},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Id"},"simulation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Simulation"},"identity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Identity"},"reference":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Reference"},"execution":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Execution"},"gap":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Gap"},"freshness":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Freshness"}},"type":"object","required":["state"],"title":"ExecutionSimulationEnvelope","description":"A2 POST /execution-simulation response envelope."},"ExecutionSimulationRequest":{"properties":{"direction":{"type":"string","enum":["BUY","SELL"],"title":"Direction","description":"Trade direction: 'BUY' or 'SELL'.","examples":["BUY","SELL"]},"notional_usd":{"type":"string","enum":["100","1000"],"title":"Notional Usd","description":"Requested notional in USD (exact string: '100' or '1000').","examples":["100","1000"]}},"type":"object","required":["direction","notional_usd"],"title":"ExecutionSimulationRequest","description":"A2 POST body: direction and notional_usd.\n\nBoth fields use Any internally so Pydantic never raises 422 for field\nvalue errors; the route handler owns all public validation and returns\n400 explicitly.\n\nPublic contract: STRICT STRING INPUT ONLY.\nValid:    \"100\", \"1000\" for notional_usd; \"BUY\", \"SELL\" for direction.\nInvalid:  integers, floats, booleans, null, arrays, objects — all → 400.\n\nOpenAPI schema is overridden via json_schema_extra to expose the correct\nstring enum contract while preserving the Any runtime type."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ModelReferenceEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"reference_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Key"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["state"],"title":"ModelReferenceEnvelope"},"ModelReferenceListEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["state"],"title":"ModelReferenceListEnvelope"},"ModelReferencePreviewEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"reference_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Key"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["state"],"title":"ModelReferencePreviewEnvelope"},"ModelReferencePreviewRequest":{"properties":{"capacity_mw":{"type":"number","maximum":10000.0,"exclusiveMinimum":0.0,"title":"Capacity Mw","description":"Requested capacity in MW. Must be a finite positive JSON number at most 10,000 MW.","examples":[64.0,100.0,250.5]}},"additionalProperties":false,"type":"object","required":["capacity_mw"],"title":"ModelReferencePreviewRequest","description":"A4 POST body: capacity_mw only.\n\nUses Any internally so Pydantic never raises 422 for field value errors;\nthe route handler owns all validation and returns 400 explicitly.\n\nextra='allow' enables model_extra detection so the handler can return 400\nfor unexpected fields instead of silently ignoring them.\n\nPublic contract: finite positive JSON number only, 0 < capacity_mw <= 10,000.\nInvalid: strings, booleans, null, arrays, objects, zero, negatives, non-finite.\nExtra fields: always 400 MODEL_PREVIEW_REQUEST_INVALID."},"ModelReferenceRunEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"reference_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Key"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["state"],"title":"ModelReferenceRunEnvelope"},"ModelReferenceRunRequest":{"properties":{"capacity_mw":{"type":"number","maximum":10000.0,"exclusiveMinimum":0.0,"title":"Capacity Mw","description":"Requested capacity in MW for this run. Must be a finite positive JSON number at most 10,000 MW. CAPEX and OPEX are proportionally scaled from the canonical reference.","examples":[64.0,100.0,250.5]}},"additionalProperties":false,"type":"object","required":["capacity_mw"],"title":"ModelReferenceRunRequest","description":"A5 POST body: capacity_mw only.\n\nUses Any internally so Pydantic never raises 422 for field value errors;\nthe route handler owns all validation and returns 400 explicitly.\n\nextra='allow' enables model_extra detection so the handler can return 400\nfor unexpected fields instead of silently ignoring them.\n\nPublic contract: finite positive JSON number only, 0 < capacity_mw <= 10,000.\nInvalid: strings, booleans, null, arrays, objects, zero, negatives, non-finite.\nExtra fields: always 400 MODEL_RUN_REQUEST_INVALID."},"RadarEnvelope":{"properties":{"api_version":{"type":"string","title":"Api Version","default":"v1"},"state":{"type":"string","title":"State"},"economic_asset_uid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Economic Asset Uid"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"freshness":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Freshness"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"}},"type":"object","required":["state"],"title":"RadarEnvelope"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}