{"uid":"cap_C3WTfS488OlPdaAzkAXFw","slug":"corpusai-cloud-pricing-spot-price-snapshot-562a7f93","name":"corpusAI Cloud Pricing: Spot Price Snapshot","description":"corpusAI Cloud Pricing: Current price of every instance type, zone and product in a whole region, in one call.","url":"https://cloud.trycorpus.ai/v1/spot/snapshot?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["provider","region"],"properties":{"region":{"type":"string","examples":["us-east-1"],"description":"Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`."},"provider":{"enum":["aws","gcp","azure"],"type":"string","description":"Cloud provider. One of `aws`, `gcp`, `azure`."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"as_of":{"type":"string","format":"date-time","description":"Newest event in the region; the snapshot is current to this time."},"count":{"type":"integer"},"prices":{"type":"array","items":{"type":"object","properties":{"az":{"type":"string"},"price":{"type":"number","description":"USD per hour."},"since":{"type":"string","format":"date-time","description":"When this price took effect."},"product":{"type":"string"},"instance":{"type":"string"},"age_seconds":{"type":"integer","description":"Seconds since `since`, at response time."}}}},"region":{"type":"string"},"provider":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HrQ0167G81-oYXSk1Pl2F","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current spot/on-demand instance prices for all products in a given cloud provider region, with timestamps indicating when each price took effect.","exampleAgentPrompt":"What are the current spot instance prices for AWS in us-east-1? I want to see all the instance types and their USD-per-hour rates right now.","exampleUseCases":[{"title":"Real-time cost optimization for autoscaler","prompt":"Pull the current AWS spot prices in us-east-1 so I can find the cheapest instance type available right now for our autoscaling workload."},{"title":"Multi-region cloud spend comparison","prompt":"Get me the current GCP spot instance prices in us-central1 — I want to compare them against what we're paying now to see if we should shift regions."},{"title":"FinOps dashboard price refresh","prompt":"Fetch the latest Azure instance prices for the eastus region so I can update our cloud cost dashboard with today's rates."}],"resultDescription":"A JSON object containing the provider name, region, a timestamp of the newest pricing event ('as_of'), a count of price entries, and an array of price records each with instance type, product name, availability zone, USD-per-hour price, the datetime the price took effect, and how many seconds ago that was.","failureModes":["Missing or invalid 'provider' query param returns an error (must be one of aws, gcp, azure)","Missing or invalid 'region' slug returns an error — region must match the provider's catalog format (e.g. us-east-1 for AWS, not 'us-east')","Payment of 0.1 USDC via x402 not included or fails — request is rejected with 402 Payment Required","Region has no current pricing data — may return empty prices array","Network timeout or service unavailability — no snapshot returned"],"whenToPreferThis":"Use this endpoint when you need a real-time snapshot of all current spot/on-demand instance prices for a specific cloud provider region (AWS, GCP, or Azure). It is ideal for cost optimization agents, FinOps dashboards, autoscalers, and infra provisioning tools that need up-to-date per-instance pricing with timestamps. Prefer this over scraping cloud provider pricing pages or using stale static price lists. Best when you already know the provider and region and want a full set of prices in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:42:33.803Z","isFirstParty":false,"canonicalSlug":"corpusai-cloud-pricing-spot-price-snapshot-562a7f93"}