# get-pricing

Free and unauthenticated. Previews the actual allocation and price for a server. Creates no reservation or record.

## Input

| Field | Required | Notes |
|---|---|---|
| `vcpu` | yes | Minimum vCPU, 2-16. |
| `ramGiB` | yes | Minimum RAM in GiB, 1-64. |
| `storageGiB` | yes | Exact disk size in GiB, 16-512. Fixed for the server's lifetime. |
| `cpu` | no | `dedicated` (default): every vCPU may run at 100% all the time. `burstable`: a cheaper size that guarantees a baseline share of each vCPU (`baselineCpuPercent`) and bursts above it; sustained load above the baseline is slowed, never charged extra. Suits websites and other light workloads. |
| `hours` | yes | Rental hours, 1-720. |

## Result artifact — `hosting_pricing`

```jsonc
{
  "available": true,
  "purchasable": true,
  "reason": null,
  "planId": "hc2-0123456789abcdef.standard-2x8.64",
  "catalogVersion": "hc2-0123456789abcdef",
  "location": { "id": "us-east", "name": "US East" },
  "allocation": { "size": "standard-2x8", "vcpu": 2, "ramGiB": 8, "storageGiB": 64, "architecture": "x86_64",
                  "cpu": "dedicated", "baselineCpuPercent": null },
  "hourlyRate": { "amount": "166340", "display": "0.16634 USDC" },
  "rentalPrice": { "amount": "7984320", "display": "7.98432 USDC" },
  "retentionFee": { "amount": "403671", "display": "0.403671 USDC" },
  "totalPrice": { "amount": "8390000", "display": "8.39 USDC" },
  "dailyOutboundGiB": 100
}
```

Amounts are atomic USDC (6 decimals). `hourlyRate`, `rentalPrice` (`hourlyRate` × `hours`) and `retentionFee` are exact; `totalPrice`, the amount `create-server` charges, is their sum rounded up to the next whole cent (0.01 USDC), so it can exceed the sum by less than one cent. The rental time bought is exactly `hours`; the rounding is not extra credit. The allocation is the cheapest offered size of the requested CPU class meeting both minimums and may exceed them. `dailyOutboundGiB` is that size's daily outbound allowance; `options` lists every size with its class, baseline and allowance. The retention fee is charged once at creation and pays for keeping the disk and IP for 24 hours after expiry; it is not prepaid credit. `purchasable: false` with `reason` (`sales_paused`, `capacity_limit`) means new sales are currently refused.

## Next step

Buy `create-server` with the same resources and hours, this `planId` and your SSH public key. When prices or the catalog change, the plan reference is refused; preview again.