{"openapi":"3.1.0","info":{"title":"SiliconTicker Public Data API","version":"2.4.0","description":"Public, unauthenticated compute-market, news, source-provenance and connector-health data published by SiliconTicker. Values are reference information, not executable quotes or investment advice. CL-FCR and existing schema identifiers remain stable. Prefer update_policy.check_cadence, X-Data-Freshness, and editorial publisher/content_type; legacy branded fields remain compatibility aliases.","termsOfService":"https://siliconticker.com/terms","contact":{"name":"SiliconTicker corrections","url":"https://siliconticker.com/about#corrections"},"license":{"name":"Endpoint-specific; inspect provenance and source registry","url":"https://siliconticker.com/api/sources"}},"servers":[{"url":"https://siliconticker.com","description":"Canonical request origin"}],"security":[],"paths":{"/api/compare":{"get":{"operationId":"getComparisonCatalog","summary":"Get classified GPU rental offers for comparison","description":"Schema 1.0 uses camelCase offer fields. Public listings and Azure Spot tariffs are not confirmed available inventory. This catalog is separate from CL-FCR.","tags":["Markets"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComparisonResponse"}}}}}}},"/api/markets":{"get":{"operationId":"getMarketSnapshot","summary":"Get normalized public GPU market data and CL-FCR","description":"Returns schema 2.0 reference data. Cached for one hour; inspect observation and freshness fields before use.","tags":["Markets"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResponse"}}}}}}},"/api/markets/azure-spot":{"get":{"operationId":"getAzureSpotSnapshot","summary":"Get official Azure H100 and A100 Spot retail prices by region","description":"Returns schema 1.0 capacity-contingent Azure Spot retail tariffs for two representative Linux GPU VMs. Values are not executable quotes or guaranteed capacity.","tags":["Markets"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AzureSpotResponse"}}}}}}},"/api/news":{"get":{"operationId":"getNews","summary":"Get original analysis and first-party compute releases","description":"Returns schema 2.1 news data from SiliconTicker and connected official sources.","tags":["News"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsResponse"}}}}}}},"/api/sources":{"get":{"operationId":"getSources","summary":"Get the source, rights and connector registry","tags":["Trust"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourcesResponse"}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Get current public connector health","tags":["Trust"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}}},"components":{"schemas":{"ComparisonResponse":{"type":"object","required":["schema_version","offers","sourceCount","observedAt","self_url"],"properties":{"schema_version":{"const":"1.0"},"checkedAt":{"type":"string","format":"date-time"},"observedAt":{"type":"string","format":"date"},"sourceCount":{"type":"integer"},"excludedCount":{"type":"integer"},"unavailableSources":{"type":"array","items":{"type":"string"}},"offers":{"type":"array","items":{"type":"object","required":["id","provider","gpu","gpuCount","totalHourlyUsd","pricingType","availability","sourceUrl","observedAt","status"],"properties":{"id":{"type":"string"},"provider":{"type":"string"},"planId":{"type":"string"},"gpu":{"type":"string"},"variant":{"type":"string"},"gpuCount":{"type":"integer","minimum":1},"totalHourlyUsd":{"type":"number","exclusiveMinimum":0},"perGpuHourlyUsd":{"type":"number","exclusiveMinimum":0},"pricingType":{"enum":["on-demand","public-list","spot"]},"availability":{"const":"unconfirmed"},"locations":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"sourceUrl":{"type":"string","format":"uri"},"specificationUrl":{"type":"string","format":"uri"},"observedAt":{"type":"string","description":"Source observation date or ISO timestamp; check source cadence."},"status":{"enum":["fresh","stale","fallback"]},"vramGb":{"type":["number","null"]},"cpuCount":{"type":["number","null"]},"ramGb":{"type":["number","null"]},"diskGb":{"type":["number","null"]}}}},"self_url":{"type":"string","format":"uri"},"methodology_url":{"type":"string","format":"uri"},"scope":{"type":"string"},"attribution":{"type":"string"}}},"Timestamp":{"type":"string","format":"date-time"},"ObservationDate":{"type":"string","format":"date"},"AbsoluteUrl":{"type":"string","format":"uri"},"MarketResponse":{"type":"object","required":["schema_version","checked_at","observed_at","freshness_status","indices","quotes","offers","provenance","self_url"],"properties":{"schema_version":{"const":"2.0"},"name":{"type":"string"},"checked_at":{"$ref":"#/components/schemas/Timestamp"},"next_check_at":{"$ref":"#/components/schemas/Timestamp"},"observed_at":{"$ref":"#/components/schemas/ObservationDate"},"source_generated_at":{"$ref":"#/components/schemas/Timestamp"},"freshness_status":{"type":"string","enum":["fresh","stale","fallback"]},"currency":{"const":"USD"},"update_policy":{"type":"object","properties":{"check_cadence":{"type":"string","description":"Publisher check cadence; distinct from upstream publication cadence."},"compute_ledger_check_cadence":{"type":"string","deprecated":true,"description":"Compatibility alias for check_cadence."}},"additionalProperties":true},"coverage":{"type":"object","additionalProperties":true},"indices":{"type":"array","items":{"$ref":"#/components/schemas/Index"}},"listed_market_roadmap":{"type":"array","items":{"type":"object","additionalProperties":true}},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}},"history":{"type":"object","additionalProperties":true},"provenance":{"$ref":"#/components/schemas/Provenance"},"excluded_by_design":{"type":"array","items":{"type":"string"}},"disclaimers":{"type":"array","items":{"type":"string"}},"self_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"methodology_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"sources_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"health_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"terms_url":{"$ref":"#/components/schemas/AbsoluteUrl"}},"additionalProperties":true},"Index":{"type":"object","required":["symbol","value","unit","observed_at","source_url","tradeable"],"properties":{"symbol":{"type":"string","examples":["CL-FCR"]},"name":{"type":"string"},"value":{"type":"number"},"display_value":{"type":"string"},"unit":{"type":"string"},"observed_at":{"$ref":"#/components/schemas/ObservationDate"},"freshness_status":{"type":"string"},"source_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"coverage_status":{"type":"string"},"provider_count":{"type":"integer"},"offer_count":{"type":"integer"},"tradeable":{"const":false}},"additionalProperties":true},"Quote":{"type":"object","required":["symbol","value","unit","observed_at","source_url"],"properties":{"symbol":{"type":"string"},"value":{"type":"number"},"display_value":{"type":"string"},"unit":{"type":"string"},"observed_at":{"$ref":"#/components/schemas/ObservationDate"},"source_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"freshness_status":{"type":"string"}},"additionalProperties":true},"Offer":{"type":"object","required":["provider","gpu_model","gpu_count","total_hourly_usd","per_gpu_hourly_usd"],"properties":{"provider":{"type":"string"},"plan_id":{"type":"string"},"gpu_model":{"type":"string"},"gpu_count":{"type":"integer","minimum":1},"total_hourly_usd":{"type":"number","minimum":0},"per_gpu_hourly_usd":{"type":"number","minimum":0},"locations":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"Provenance":{"type":"object","required":["mode","attribution","license","source_url","methodology"],"properties":{"mode":{"type":"string"},"attribution":{"type":"string"},"license":{"type":"string"},"source_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"methodology":{"type":"string"}},"additionalProperties":false},"AzureSpotResponse":{"type":"object","required":["schema_version","self_url","checked_at","observed_at","freshness_status","coverage_status","market_type","tradeable","availability_guaranteed","source","summaries","observations"],"properties":{"schema_version":{"const":"1.0"},"self_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"methodology_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"sources_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"health_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"checked_at":{"$ref":"#/components/schemas/Timestamp"},"next_check_at":{"$ref":"#/components/schemas/Timestamp"},"observed_at":{"$ref":"#/components/schemas/Timestamp"},"freshness_status":{"type":"string","enum":["fresh","stale","unavailable"]},"coverage_status":{"type":"string","enum":["complete","partial","unavailable"]},"provenance_mode":{"type":"string","enum":["live","last_known_good","unavailable"]},"market_type":{"const":"capacity_contingent_spot_retail"},"currency":{"const":"USD"},"tradeable":{"const":false},"availability_guaranteed":{"const":false},"source":{"type":"object","additionalProperties":true},"summaries":{"type":"array","items":{"$ref":"#/components/schemas/AzureSpotSummary"}},"observations":{"type":"array","items":{"$ref":"#/components/schemas/AzureSpotObservation"}}},"additionalProperties":true},"AzureSpotSummary":{"type":"object","required":["symbol","gpu_variant","arm_sku_name","gpu_count","region_count","low_per_gpu_hourly_usd","median_per_gpu_hourly_usd","high_per_gpu_hourly_usd","capacity_note"],"properties":{"symbol":{"type":"string","enum":["AZ-H100-SPOT","AZ-A100-SPOT"]},"gpu_family":{"type":"string"},"gpu_variant":{"type":"string"},"arm_sku_name":{"type":"string"},"gpu_count":{"type":"integer","minimum":1},"region_count":{"type":"integer","minimum":1},"low_per_gpu_hourly_usd":{"type":"number","exclusiveMinimum":0},"median_per_gpu_hourly_usd":{"type":"number","exclusiveMinimum":0},"high_per_gpu_hourly_usd":{"type":"number","exclusiveMinimum":0},"regional_spread_usd":{"type":"number","minimum":0},"cheapest_region":{"type":"string"},"cheapest_location":{"type":"string"},"capacity_note":{"type":"string"}},"additionalProperties":false},"AzureSpotObservation":{"type":"object","required":["symbol","arm_sku_name","gpu_count","region","total_vm_hourly_usd","per_gpu_hourly_usd","currency","unit","effective_start_date","observed_at","tradeable","availability_guaranteed","capacity_note"],"properties":{"symbol":{"type":"string"},"gpu_family":{"type":"string"},"gpu_variant":{"type":"string"},"arm_sku_name":{"type":"string"},"gpu_count":{"type":"integer","minimum":1},"region":{"type":"string"},"location":{"type":"string"},"total_vm_hourly_usd":{"type":"number","exclusiveMinimum":0},"per_gpu_hourly_usd":{"type":"number","exclusiveMinimum":0},"currency":{"const":"USD"},"unit":{"const":"USD per GPU-hour"},"effective_start_date":{"$ref":"#/components/schemas/Timestamp"},"observed_at":{"$ref":"#/components/schemas/Timestamp"},"tradeable":{"const":false},"availability_guaranteed":{"const":false},"specification_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"capacity_note":{"type":"string"}},"additionalProperties":false},"NewsResponse":{"type":"object","required":["schema_version","checked_at","service_status","editorial","source_health","official_signals","self_url"],"properties":{"schema_version":{"const":"2.1"},"self_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"checked_at":{"$ref":"#/components/schemas/Timestamp"},"service_status":{"type":"string","enum":["operational","degraded"]},"update_policy":{"type":"object","additionalProperties":true},"editorial":{"type":"array","items":{"type":"object","additionalProperties":true}},"source_health":{"type":"array","items":{"type":"object","additionalProperties":true}},"official_signals":{"type":"array","items":{"type":"object","additionalProperties":true}},"methodology_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"terms_url":{"$ref":"#/components/schemas/AbsoluteUrl"}},"additionalProperties":true},"SourcesResponse":{"type":"object","required":["schema_version","name","self_url","sources","policy"],"properties":{"schema_version":{"const":"2.0"},"name":{"type":"string"},"self_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"policy":{"type":"object","additionalProperties":true}},"additionalProperties":true},"HealthResponse":{"type":"object","required":["schema_version","service","self_url","status","checked_at","market","azure_spot","news"],"properties":{"schema_version":{"const":"2.0"},"service":{"type":"string"},"self_url":{"$ref":"#/components/schemas/AbsoluteUrl"},"status":{"type":"string","enum":["operational","degraded"]},"checked_at":{"$ref":"#/components/schemas/Timestamp"},"market":{"type":"object","additionalProperties":true},"azure_spot":{"type":"object","additionalProperties":true},"news":{"type":"object","additionalProperties":true}},"additionalProperties":true}}},"externalDocs":{"description":"Complete SiliconTicker agent guide","url":"https://siliconticker.com/llms-full.txt"}}