{"openapi":"3.1.0","info":{"title":"GPU discovery API","version":"1.0.0","description":"Read fresh stored GPU comparison offers and provider handoffs. No account or provider credentials required. Availability is a provider report, never a reservation."},"servers":[{"url":"https://api.reliqua.ai"}],"paths":{"/api/v1/compute/offers":{"get":{"operationId":"findGpuOffers","summary":"Find the cheapest matching fresh GPU packages","security":[],"parameters":[{"name":"gpu","in":"query","required":false,"schema":{"type":"string","maxLength":100,"description":"GPU family, for example H100 or RTX 4090. Original variants remain in results."}},{"name":"gpu_model","in":"query","required":false,"schema":{"type":"string","maxLength":120,"description":"Exact reported GPU model, case insensitive."}},{"name":"provider","in":"query","required":false,"schema":{"type":"string","enum":["lium","targon","prime","verda","vultr","runpod","vast","lambda","hyperstack"]}},{"name":"region","in":"query","required":false,"schema":{"type":"string","maxLength":256,"description":"Exact location label from region and country, as shown by the comparator."}},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter country code."}},{"name":"type","in":"query","required":false,"schema":{"type":"string","maxLength":100,"description":"Exact provider tier label."}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":160,"description":"Text search over model, provider, region, country and tier."}},{"name":"id","in":"query","required":false,"schema":{"type":"string","maxLength":4096,"description":"Exact comparator offer ID, for a fresh snapshot lookup."}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1024,"description":"Exact number of GPUs in the minimum rentable package, on one node."}},{"name":"vram","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0,"maximum":100000,"description":"Minimum VRAM in GB per GPU. Unknown memory does not match."}},{"name":"budget","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":100000,"description":"Maximum USD per whole package-hour, before unreported extras."}},{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["live","published","all"],"default":"live","description":"Live means fresh provider-reported stock. Published rates have unknown stock."}},{"name":"pricing","in":"query","required":false,"schema":{"type":"string","enum":["all","on_demand","spot","unknown"],"default":"all"}},{"name":"rank","in":"query","required":false,"schema":{"type":"string","enum":["cheapest","best","bittensor"],"default":"cheapest","description":"Cheapest orders by price; best and bittensor apply the comparator preferences."}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["package","gpu"],"default":"package","description":"Price basis. With hours, ranking uses total whole-package job cost."}},{"name":"hours","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0,"maximum":8760,"description":"Requested job duration. Estimates respect the minimum prepaid duration."}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"A bounded ranked page, with source coverage and optional provider-native handoff metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"400":{"description":"Unknown, duplicate or invalid query parameter."},"405":{"description":"Use GET or HEAD."}}}}},"components":{"schemas":{"Offer":{"type":"object","required":["id","provider","providerOfferId","gpu","gpuCount","availableUnits","priceMicroUsdPerGpuHour","priceMicroUsdPerHour","providerUrl","linkKind","observedAt","rateKind"],"properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["lium","targon","prime","verda","vultr","runpod","vast","lambda","hyperstack"]},"providerOfferId":{"type":"string"},"gpu":{"type":"string"},"gpuCount":{"type":"integer","minimum":1},"vramGb":{"type":["number","null"]},"cpuCores":{"type":["number","null"]},"ramGb":{"type":["number","null"]},"diskGb":{"type":["number","null"]},"region":{"type":"string"},"country":{"type":"string"},"tier":{"type":"string"},"availableUnits":{"type":["integer","null"],"description":"Null means unknown stock, not zero. Qualitative provider stock remains qualitative."},"availability":{"type":"string"},"rateKind":{"enum":["live","published"]},"pricingMode":{"enum":["on_demand","spot","unknown"]},"priceMicroUsdPerGpuHour":{"type":"integer","description":"USD micro-units per GPU-hour. Divide by 1000000 for USD."},"priceMicroUsdPerHour":{"type":"integer","description":"USD micro-units per whole rentable package-hour."},"estimatedCostMicroUsd":{"type":["integer","null"],"description":"Whole-package compute estimate for hours, respecting minimumHours; null when hours is omitted."},"minimumHours":{"type":"number"},"underlyingProvider":{"type":"string"},"providerUrl":{"type":"string","format":"uri"},"linkKind":{"enum":["offer","catalog"]},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"verifiedAt":{"type":["string","null"]},"additionalCharges":{"type":"string"},"handoff":{"type":"object","description":"Optional public provider-native selection. Lium: nodeId and gpuCount. Prime: cloudId, gpuType, gpuCount and known provider/socket/location/security/images/resources. This is selection metadata, not a complete provisioning request; the caller supplies its own account, image and price ceiling.","required":["marketplace","url","linkKind","apiDocsUrl","selection"],"properties":{"marketplace":{"enum":["lium","prime"]},"url":{"type":"string","format":"uri"},"linkKind":{"enum":["offer","catalog"]},"apiDocsUrl":{"type":"string","format":"uri"},"selection":{"type":"object"}},"oneOf":[{"properties":{"marketplace":{"const":"lium"},"selection":{"$ref":"#/components/schemas/LiumSelection"}}},{"properties":{"marketplace":{"const":"prime"},"selection":{"$ref":"#/components/schemas/PrimeSelection"}}}]}}},"LiumSelection":{"type":"object","required":["nodeId","gpuCount"],"additionalProperties":false,"properties":{"nodeId":{"type":"string"},"gpuCount":{"type":"integer","minimum":1}}},"PrimeSelection":{"type":"object","required":["cloudId","gpuType","gpuCount"],"additionalProperties":false,"properties":{"provider":{"type":"string"},"cloudId":{"type":"string"},"gpuType":{"type":"string"},"socket":{"type":"string"},"gpuCount":{"type":"integer","minimum":1},"dataCenterId":{"type":"string"},"country":{"type":"string"},"security":{"enum":["secure_cloud","community_cloud"]},"images":{"type":"array","items":{"type":"string"}},"isSpot":{"type":"boolean"},"resources":{"type":"object","additionalProperties":false,"properties":{"disk":{"type":"number"},"vcpu":{"type":"number"},"memory":{"type":"number"},"sharedDisk":{"type":"number"}}}}},"SearchResult":{"type":"object","required":["offers","sources","observedAt","pagination","coverage","pricing","query"],"properties":{"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"},"maxItems":100},"sources":{"type":"array","items":{"type":"object","required":["provider","state","observedAt","offerCount","message","url"],"description":"Provider state, source observation/expiry, health and bounded collection coverage.","properties":{"provider":{"type":"string","enum":["lium","targon","prime","verda","vultr","runpod","vast","lambda","hyperstack"]},"state":{"enum":["live","published","unavailable","not_connected"]},"observedAt":{"type":["string","null"]},"fetchedAt":{"type":"string"},"expiresAt":{"type":"string"},"offerCount":{"type":"integer"},"message":{"type":"string"},"url":{"type":"string"},"health":{"enum":["ok","empty","partial","degraded"]},"coverage":{"type":"object"}}}},"observedAt":{"type":"string","format":"date-time"},"query":{"type":"object"},"pagination":{"type":"object","required":["limit","offset","total","nextOffset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"},"nextOffset":{"type":["integer","null"]}}},"coverage":{"type":"object","required":["complete","freshProviders","incompleteProviders"],"properties":{"complete":{"type":"boolean"},"freshProviders":{"type":"array","items":{"type":"string"}},"incompleteProviders":{"type":"array","items":{"type":"string"}}}},"pricing":{"type":"object","required":["currency","unit","scale","scope","basis","hours","excludes"],"description":"USD micro-units, listed compute scope, declared ranking basis, requested duration and excluded charges.","properties":{"currency":{"const":"USD"},"unit":{"const":"micro_usd"},"scale":{"const":1000000},"scope":{"const":"listed_compute"},"basis":{"enum":["package_hour","gpu_hour","package_job"]},"hours":{"type":["number","null"]},"excludes":{"type":"array","items":{"type":"string"}}}}}}}}}