DocsUser Guide
User Guide

Rateplane operating guide

Use Rateplane to compare normalized cloud pricing, connect billing data, govern budgets, review forecasts, allocate spend, and export cost data for operating reviews.

Product truth

Know what works before and after setup

Rateplane separates public pricing research from connected-account workflows, integration-required work, configured controls, admin-only operations, and partial or future-facing features. Use the product map when you need buyer-facing boundaries for what works before and after setup.

Public catalog

Pricing research, provider comparison, filters, public docs, and methodology.

Connected-account

Spend dashboards, budgets, forecasts, allocation, recommendations, and reports after sync.

Integration-required

APIs, notifications, webhooks, SaaS connectors, and partner tools that need setup.

Configured controls

SSO, roles, auditability, billing, security review, and rollout support by plan.

Admin-only

Operator health, catalog refresh, job, sync, and dependency controls.

Partial/future

Labs and partially wired features labeled separately from generally available workflows.

Open the full product map
Quick start

Up and running in 3 steps

1
Create a free account
Go to rateplane.com/register and sign up with your email. The Starter plan includes catalog browsing, saved compare boards, price alerts, saved filters, and expression filters up to the plan limits.
2
Browse or connect
The Catalog is available immediately: search normalized AWS, Azure, GCP, OCI, Linode, and Vultr pricing without connecting cloud credentials. If you want spend data from your own cloud accounts for budgets, forecasts, allocation, and reporting, go to Cloud accounts and follow the connection guide for your provider.
3
Set a price alert or save a filter
Find an instance you care about and click the bell icon to create a price alert — you'll get an email when the price crosses your threshold. Or use Saved filters to bookmark a view (e.g. "8+ vCPU, under $0.40/hr, AWS us-east-1") and share it with your team.
Features

Core workflows

Jump directly to the workflow you need for a pricing, budget, or spend review.

Catalog

Pricing catalog

The catalog is the core of Rateplane. It normalizes pricing data from AWS, Azure, GCP, OCI, Linode, and Vultr into a single table with consistent column names, units, and currency so you can make apples-to-apples comparisons without switching between three different pricing pages.

Browsing and filtering

Search box — type any instance name, family, or description keyword. Results update as you type.
Provider toggles — click the AWS / Azure / GCP pills to show only those providers. Multiple providers can be active simultaneously.
Filter bar — set region, family category (General, Compute, Memory, GPU…), vCPU range, memory range, and max hourly price using the sliders and dropdowns.
Price type — switch between On-demand, Spot, Reserved 1yr, and Reserved 3yr to see different pricing tiers in the table where those rates are available.
Currency selector — pick from supported currencies. Exchange rates are cached from frankfurter.app and refresh every hour.

Columns you'll see

ColumnWhat it means
ProviderAWS, Azure, or GCP
InstanceThe SKU name (e.g. m7i.large, Standard_D4s_v5)
vCPUVirtual CPU count
MemoryRAM in GiB
On-demandHourly list price in your selected currency
SpotSpot/preemptible hourly price (where available)
Spot savings %Discount vs on-demand
Reserved 1yr1-year reserved price (no upfront)
Reserved 3yr3-year reserved price (no upfront)
NetworkBandwidth estimate (Gbps)
CoreMarkRelative CPU performance score where available
Spot interrupt %AWS spot interruption frequency (5 buckets)
Archx86-64, ARM / Graviton
RegionCloud region name
OSLinux or Windows pricing variant

Exporting to CSV

Any filtered view can be exported as a CSV file. Click the Export CSV button in the toolbar. The export respects active filters and endpoint limits.

Instance detail page

Click any instance row to open the detail page. It shows all price variants (on-demand, spot, all reserved terms), specs, architecture, network, storage info, and provider/source context where available. From there you can add the instance to a compare board or create a price alert.

Find Similar
On any instance detail page, click Find Similar to run a catalog search with +/-20% vCPU and memory tolerance. This is useful for exploring right-sized alternatives across providers.
Compare

Side-by-side comparison

The compare board lets you pin selected offers and view specs and prices side by side across providers, regions, or price types.

How to compare instances

  1. 1Browse the catalog and click the checkbox on any instance row to add it to the compare tray.
  2. 2Repeat for the offers you want to evaluate. You can mix AWS, Azure, GCP, OCI, Linode, and Vultr freely.
  3. 3Click Open compare board or navigate to Dashboard → Compare.
  4. 4Use the board to review specs, on-demand, spot, and reserved prices, and choose the best fit.
  5. 5Save the board with a name — it persists in your workspace and can be shared with team members.
Saved compare boards
Saved boards count toward your plan limit (Starter: 3, Team: 25, Business: 100, Enterprise: 250). Unsaved boards are session-only. Share a board permalink by clicking the share icon — recipients see the same instances without needing to be signed in.
Calculator

Pricing calculator

The pricing calculator lets you build a multi-cloud stack — combine multiple instances, regions, and price types to estimate a total monthly and yearly cost.

Building a stack

  1. 1Navigate to Dashboard → Calculator.
  2. 2Click Add instance and search for the instance type you want.
  3. 3Set the quantity, region, price type (on-demand / spot / reserved 1yr / 3yr), and hours per month.
  4. 4Repeat for each instance or service tier in your workload.
  5. 5The summary panel shows total monthly cost, yearly cost, and a per-line breakdown.
  6. 6Export the stack to CSV for sharing with finance or your team.
Catalog-backed estimates
Calculator results are estimates based on available catalog rows and the quantities you enter. Use connected spend reports for actual billing review.
Alerts

Price alerts

Price alerts send you an email whenever the on-demand or spot price of any instance crosses a threshold you set. They're evaluated once per hour.

Creating an alert

  1. 1Open an instance detail page (click any row in the catalog).
  2. 2Click Set price alert in the action bar.
  3. 3Choose the price type (on-demand or spot), condition (below / above), and your target price in USD/hr.
  4. 4Enter the email address to notify — it doesn't need to be your account email.
  5. 5Save. You'll receive a confirmation email immediately.

Managing alerts

All your active and triggered alerts are listed under Dashboard → Alerts. You can toggle alerts on/off without deleting them, or delete alerts you no longer need. Triggered alerts show the event history including the price at the time of trigger.

PlanActive alerts
StarterUp to 5
TeamUp to 100
BusinessUp to 500
EnterpriseUp to 1,000
Alert cooldown
To prevent email floods, alerts have a 24-hour cooldown after triggering. If the price bounces, you won't receive a second notification until the cooldown expires.
Budgets

Monthly budgets

Budgets let you set a monthly spend cap per cloud provider and receive an email when your actual spend approaches that threshold. They require a connected cloud account so actual spend data can be read.

Creating a budget

  1. 1Make sure you have at least one cloud account connected (Dashboard → Cloud accounts).
  2. 2Navigate to Dashboard → Budgets and click New budget.
  3. 3Select the provider (AWS, Azure, or GCP) and the month.
  4. 4Set the budget amount in USD.
  5. 5Set the alert threshold — e.g. 80% means you'll be notified when spend reaches 80% of the budget.
  6. 6Add a notification email address and save.
Budget snapshots
Budget variance views compare the budget target with available spend data. They are useful for review and planning once billing syncs have populated the workspace.
Saved filters

Saved filters

Saved filters let you bookmark any catalog view — provider, region, family, vCPU/memory range, price type, and expression — as a named snapshot you can revisit with one click.

Saving a view

  1. 1Set up your filters in the catalog (provider, region, sliders, expression bar).
  2. 2Click Save filter in the toolbar and give it a name (e.g. "AWS GPU us-east-1 under $2").
  3. 3The filter appears in Dashboard → Saved filters.
  4. 4Click any saved filter to restore the catalog to that view.
  5. 5Use the share icon to generate a permalink — anyone with the link can view the same filtered catalog, no login required.
Team sharing
Saved filters are visible to everyone in your workspace on Team, Business, and Enterprise. Starter users can save filters privately. Share a filter link with anyone — even people outside your workspace — using the public share URL.
Expression filters

Expression filter syntax

The expression bar sits below the main filter row and accepts SQL-like tokens to narrow the catalog with precision. Tokens are applied in addition to any active dropdowns.

Syntax reference

TokenOperatorsExampleWhat it filters
vcpu>, >=, <, <=, =vcpu>=8vCPU count
memory>, >=, <, <=, =memory<=32Memory in GiB
price>, >=, <, <=, =price<0.5On-demand hourly price (USD)
gpu>, >=, <, <=, =gpu>=1GPU count
name: (prefix match)name:m7iInstance name
provider: (exact match)provider:AWSCloud provider
family: (prefix match)family:computeFamily category
region: (prefix match)region:us-eastRegion name
arch: (exact match)arch:armCPU architecture

Examples

8+ vCPUs, max 32 GiB memory, under $0.50/hr
vcpu>=8 memory<=32 price<0.5
AWS GPU instances only
provider:AWS gpu>=1
ARM / Graviton instances with 4+ vCPUs
arch:arm vcpu>=4
Memory-optimised, us-east region, under $1/hr
family:memory region:us-east price<1
Quick-filter presets
Click the dropdown arrow on the expression bar to see 12 built-in presets for common workloads — web server, ML training, database, GPU rendering, and more. Selecting a preset populates the expression bar and applies the filter.
Cloud accounts

Connecting cloud accounts

Connecting a cloud billing account unlocks spend analytics for trends, service breakdowns, budget tracking, forecasts, allocation, and optimization review. Connections are read-only; Rateplane never provisions or modifies cloud resources.

Supported providers

Security model

All credentials are encrypted at rest and never logged.
Rateplane requests the minimum permissions needed — read-only billing access only.
We recommend using dedicated IAM users, service principals, or cross-account roles scoped to billing reads.
Credentials are stored per-workspace. Team members can see sync status but not credential values.
You can disconnect and delete credentials at any time from Dashboard → Cloud accounts.
Spend analytics

Spend analytics suite

After successful billing, usage, or resource syncs, the following dashboards have workspace-specific data.

Optimization

Cost optimization signals

The Optimization dashboard surfaces reviewable cost-reduction opportunities derived from connected spend, resource signals, and catalog benchmarks.

Anomaly detection

Spend spikes and custom anomaly rules are reviewed by scheduled checks.

Concentration risk

Services that account for a disproportionate share of total spend, suggesting potential for reserved or spot savings.

Rightsizing signals

Instances that appear over-provisioned based on cost-per-service trends and catalog benchmarks.

Spot savings estimate
In the catalog, the Spot savings % column shows the discount vs on-demand. Use the expression filter price<0.5 and switch price type to Spot to quickly find eligible spot candidates for your workload.
API access

REST API & API keys

The Rateplane REST API lets you query the pricing catalog, export data, and manage alerts programmatically. API keys are available on Team, Business, and Enterprise plans.

Creating an API key

  1. 1Navigate to Dashboard → API Keys.
  2. 2Click New API key and give it a descriptive name (e.g. "CI pipeline", "Grafana datasource").
  3. 3Copy the key immediately — it is shown only once and hashed on save.
  4. 4Use the key by adding it as a Bearer token in your requests.

Authenticating requests

curl "https://rateplane.com/api/instances?provider=AWS&minVcpus=8" \
  -H "Authorization: Bearer rp_live_your_api_key_here"
Full API reference
See the API documentation for all available endpoints, query parameters, response schemas, and per-plan rate limits.
Team & workspace

Team & workspace management

Rateplane is workspace-based. Everything — saved filters, compare boards, cloud accounts, budgets, alerts — belongs to the workspace. Team members share access to workspace resources based on their role.

Inviting team members

  1. 1Navigate to Dashboard → Team.
  2. 2Click Invite member and enter their email address.
  3. 3They receive an invite link. When they accept, they join your workspace.
  4. 4Assign roles: Member (read access) or Admin (full access including billing and account connections).

Workspace settings

Under Dashboard → Settings you can change the workspace name, configure notification channels (email, webhook), manage billing, and open the billing portal to view invoices or update payment details.

RoleWhat they can do
AdminFull access: manage accounts, billing, team members, alerts, budgets, and all workspace settings
MemberRead access: browse catalog, view saved filters, compare boards, and spend dashboards. Cannot change settings or billing.
Plans

Plans at a glance

FeatureStarterTeamBusinessEnterprise
Price$0$49/mo$249/moCustom
Catalog access
Compare boards3 saved25 saved100 saved250 saved
Price alerts5 active100 active500 active1000 active
Saved filters51005001000
Budgets350200500
Spend analytics
Allocation / chargeback
API keys5 keys25 keys100 keys
Team members1Up to 25Up to 75Up to 200
Virtual tag rules51005001000
Annotations10500250010000
SSO / SAMLSAML SSO
Priority support
Data

Catalog data & freshness

Pricing catalog

Pulled from AWS, Azure, GCP, OCI, Linode, and Vultr pricing sources and normalized into a single schema. Updated daily. Covers on-demand, spot, and reserved rates where provider data is available.

Spot interruption frequencies

AWS spot interruption data is shown where imported from AWS Spot Advisor data.

Exchange rates

Fetched from frankfurter.app on demand and cached for 1 hour. Rates are approximate — for budgeting guidance, not accounting.

Connected spend data

Imported from connected cloud billing accounts through manual sync, account sync jobs, and configured scheduled jobs.

Help

More resources