Price a machine - CostGraph Documentation

POST

pricing

compute

Price a machine

curl --request POST \
  --url https://pricing.baselinehq.cloud/v1/pricing/compute \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "availability_zone": "<string>",
  "fallback_to_base_pricing": true,
  "id": "<string>",
  "instance_type": "<string>",
  "operating_system": "<string>",
  "region": "<string>",
  "vm": {
    "cpu_cores": 123,
    "ram_gb": 123
  }
}
'

import requests

url = "https://pricing.baselinehq.cloud/v1/pricing/compute"

payload = {
    "availability_zone": "<string>",
    "fallback_to_base_pricing": True,
    "id": "<string>",
    "instance_type": "<string>",
    "operating_system": "<string>",
    "region": "<string>",
    "vm": {
        "cpu_cores": 123,
        "ram_gb": 123
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    availability_zone: '<string>',
    fallback_to_base_pricing: true,
    id: '<string>',
    instance_type: '<string>',
    operating_system: '<string>',
    region: '<string>',
    vm: {cpu_cores: 123, ram_gb: 123}
  })
};

fetch('https://pricing.baselinehq.cloud/v1/pricing/compute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://pricing.baselinehq.cloud/v1/pricing/compute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'availability_zone' => '<string>',
    'fallback_to_base_pricing' => true,
    'id' => '<string>',
    'instance_type' => '<string>',
    'operating_system' => '<string>',
    'region' => '<string>',
    'vm' => [
        'cpu_cores' => 123,
        'ram_gb' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://pricing.baselinehq.cloud/v1/pricing/compute"

	payload := strings.NewReader("{\n  \"availability_zone\": \"<string>\",\n  \"fallback_to_base_pricing\": true,\n  \"id\": \"<string>\",\n  \"instance_type\": \"<string>\",\n  \"operating_system\": \"<string>\",\n  \"region\": \"<string>\",\n  \"vm\": {\n    \"cpu_cores\": 123,\n    \"ram_gb\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://pricing.baselinehq.cloud/v1/pricing/compute")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"availability_zone\": \"<string>\",\n  \"fallback_to_base_pricing\": true,\n  \"id\": \"<string>\",\n  \"instance_type\": \"<string>\",\n  \"operating_system\": \"<string>\",\n  \"region\": \"<string>\",\n  \"vm\": {\n    \"cpu_cores\": 123,\n    \"ram_gb\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://pricing.baselinehq.cloud/v1/pricing/compute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"availability_zone\": \"<string>\",\n  \"fallback_to_base_pricing\": true,\n  \"id\": \"<string>\",\n  \"instance_type\": \"<string>\",\n  \"operating_system\": \"<string>\",\n  \"region\": \"<string>\",\n  \"vm\": {\n    \"cpu_cores\": 123,\n    \"ram_gb\": 123\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "architecture": "<string>",
  "availability_zone": "<string>",
  "cost_per_hour": 123,
  "cpu_cores": 123,
  "cpu_cores_cost_per_hour": 123,
  "created_at": "<string>",
  "currency": "<string>",
  "gpu_cost_per_hour": 123,
  "gpu_count": 123,
  "gpu_type": "<string>",
  "id": "<string>",
  "instance_type": "<string>",
  "native_cost_per_hour": 123,
  "operating_system": "<string>",
  "period_billing_hours": 123,
  "provider": "<string>",
  "ram_gb": 123,
  "ram_gb_cost_per_hour": 123,
  "raw_pricing_data": {},
  "region": "<string>",
  "resizable": true,
  "service": "<string>",
  "tags": {},
  "updated_at": "<string>",
  "usage_type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

Authorizations

X-API-Key

string

header

required

API key with "bl_" prefix (e.g. "bl_<api_key>")

Query Parameters

persist

boolean

Save a price computed for a shape the catalogue does not list, so later lookups return the same row. Defaults to true; false returns the same price without saving it.

Body

application/json

Machine to price

availability_zone

string

fallback_to_base_pricing

boolean

string

instance_type

string

operating_system

string

provider

enum<string>

Available options:

GCP,

AWS,

DigitalOcean,

Azure,

Hetzner,

OVHCloud,

PlanetScale,

STACKIT,

Linode,

Apple,

Base,

Akash,

Alibaba,

Baseten,

Beam,

Blaxel,

Cloudflare,

CodeSandbox,

Daytona,

E2B,

Runloop,

Vercel,

Cerebrium,

CIRunners,

Civo,

Clore,

CoreWeave,

Crusoe,

CUDO,

DataCrunch,

DeepInfra,

Denvr,

E2ENetworks,

Exoscale,

Fal,

HotAisle,

Hyperbolic,

Hyperstack,

IBM,

Lambda,

Latitude,

MassedCompute,

Modal,

Nebius,

Northflank,

Novita,

Oblivus,

OCI,

OpenTelekom,

PrimeIntellect,

Replicate,

RunPod,

Salad,

Scaleway,

Sesterce,

Shadeform,

ThunderCompute,

UpCloud,

Vast,

Vultr

region

string

service

enum<string>

Available options:

ComputeEngine,

AmazonEC2,

Droplet,

AzureCompute,

AzureManagedDisks,

HetznerCompute,

OVHPublicCloud,

BaseCompute,

BaseDisks,

AmazonEBS,

AmazonRDS,

AuroraDSQL,

CloudSQL,

AlloyDB,

CloudSpanner,

AzureDatabaseForPostgreSQL,

AzureDatabaseForMySQL,

AzureSQLDatabase,

AzureSQLManagedInstance,

PlanetScale,

ComputeEnginePersistentDisk,

STACKITCompute,

STACKITBlockStorage,

STACKITDatabase,

AkamaiLinode,

AkamaiBlockStorage,

AkamaiDatabase,

AppleMac,

AkashCompute,

AlibabaCompute,

AlibabaBlockStorage,

BasetenCompute,

BeamCompute,

BlaxelCompute,

CloudflareCompute,

CodeSandboxCompute,

DaytonaCompute,

E2BCompute,

RunloopCompute,

VercelCompute,

CerebriumCompute,

CivoCompute,

CivoBlockStorage,

CloreCompute,

CoreWeaveCompute,

CrusoeCompute,

CUDOCompute,

DataCrunchCompute,

DeepInfraCompute,

DenvrCompute,

E2ENetworksCompute,

ExoscaleCompute,

ExoscaleBlockStorage,

FalCompute,

HotAisleCompute,

HyperbolicCompute,

HyperstackCompute,

IBMCompute,

IBMBlockStorage,

LambdaCompute,

LatitudeCompute,

MassedComputeCompute,

ModalCompute,

NebiusCompute,

NorthflankCompute,

NorthflankVolume,

NovitaCompute,

OblivusCompute,

OCICompute,

OCIBlockStorage,

OpenTelekomCompute,

PrimeIntellectCompute,

ReplicateCompute,

RunPodCompute,

SaladCompute,

ScalewayCompute,

ScalewayBlockStorage,

SesterceCompute,

ShadeformCompute,

ThunderComputeCompute,

UpCloudCompute,

UpCloudBlockStorage,

VastCompute,

VultrCompute,

VultrBlockStorage

usage_type

enum<string>

Available options:

SPOT_PREEMPTIBLE,

ONDEMAND,

RESERVED,

ONDEMAND_CUSTOM,

SPOT_PREEMPTIBLE_CUSTOM,

RESERVED_CUSTOM,

SOLE_TENANCY,

CUSTOM,

EXTENDED

object

Show child attributes

Response

The resolved price

architecture

string

availability_zone

string

cost_per_hour

number

On-demand-equivalent hourly USD; multiply by provider_pricing_rules.month_hours for monthly.

cpu_cores

number

cpu_cores_cost_per_hour

number

created_at

string

currency

string

Currency the provider published this price in. Cost columns are always normalized USD.

gpu_cost_per_hour

number

gpu_count

number

gpu_type

string

instance_type

string

native_cost_per_hour

number

cost_per_hour as published, before FX normalization. Zero when currency is USD.

operating_system

string

period_billing_hours

number

Commitment term the raw price covers: 1=hourly on-demand; 8640/25920/43200=1mo/3mo/1yr buckets. cost_per_hour is already normalized to hourly.

provider

string

ram_gb

number

ram_gb_cost_per_hour

number

raw_pricing_data

object

region

string

resizable

boolean | null

True when the row carries per-vCPU and per-GB rates for a shape sized at launch; resolution stores and returns a row priced at the requested vCPU and memory. NULL or false is a fixed-size shape.

service

string

tags

object

updated_at

string

usage_type

string

Pricing tier token (ONDEMAND, RESERVED, SPOT_*, *_HBP, *_BYOL, Commit1Yr/3Yr). Filter to ONDEMAND for normal pricing.

Price a machine

curl --request POST \
  --url https://pricing.baselinehq.cloud/v1/pricing/compute \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "availability_zone": "<string>",
  "fallback_to_base_pricing": true,
  "id": "<string>",
  "instance_type": "<string>",
  "operating_system": "<string>",
  "region": "<string>",
  "vm": {
    "cpu_cores": 123,
    "ram_gb": 123
  }
}
'

import requests

url = "https://pricing.baselinehq.cloud/v1/pricing/compute"

payload = {
    "availability_zone": "<string>",
    "fallback_to_base_pricing": True,
    "id": "<string>",
    "instance_type": "<string>",
    "operating_system": "<string>",
    "region": "<string>",
    "vm": {
        "cpu_cores": 123,
        "ram_gb": 123
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    availability_zone: '<string>',
    fallback_to_base_pricing: true,
    id: '<string>',
    instance_type: '<string>',
    operating_system: '<string>',
    region: '<string>',
    vm: {cpu_cores: 123, ram_gb: 123}
  })
};

fetch('https://pricing.baselinehq.cloud/v1/pricing/compute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://pricing.baselinehq.cloud/v1/pricing/compute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'availability_zone' => '<string>',
    'fallback_to_base_pricing' => true,
    'id' => '<string>',
    'instance_type' => '<string>',
    'operating_system' => '<string>',
    'region' => '<string>',
    'vm' => [
        'cpu_cores' => 123,
        'ram_gb' => 123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://pricing.baselinehq.cloud/v1/pricing/compute"

	payload := strings.NewReader("{\n  \"availability_zone\": \"<string>\",\n  \"fallback_to_base_pricing\": true,\n  \"id\": \"<string>\",\n  \"instance_type\": \"<string>\",\n  \"operating_system\": \"<string>\",\n  \"region\": \"<string>\",\n  \"vm\": {\n    \"cpu_cores\": 123,\n    \"ram_gb\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://pricing.baselinehq.cloud/v1/pricing/compute")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"availability_zone\": \"<string>\",\n  \"fallback_to_base_pricing\": true,\n  \"id\": \"<string>\",\n  \"instance_type\": \"<string>\",\n  \"operating_system\": \"<string>\",\n  \"region\": \"<string>\",\n  \"vm\": {\n    \"cpu_cores\": 123,\n    \"ram_gb\": 123\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://pricing.baselinehq.cloud/v1/pricing/compute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"availability_zone\": \"<string>\",\n  \"fallback_to_base_pricing\": true,\n  \"id\": \"<string>\",\n  \"instance_type\": \"<string>\",\n  \"operating_system\": \"<string>\",\n  \"region\": \"<string>\",\n  \"vm\": {\n    \"cpu_cores\": 123,\n    \"ram_gb\": 123\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "architecture": "<string>",
  "availability_zone": "<string>",
  "cost_per_hour": 123,
  "cpu_cores": 123,
  "cpu_cores_cost_per_hour": 123,
  "created_at": "<string>",
  "currency": "<string>",
  "gpu_cost_per_hour": 123,
  "gpu_count": 123,
  "gpu_type": "<string>",
  "id": "<string>",
  "instance_type": "<string>",
  "native_cost_per_hour": 123,
  "operating_system": "<string>",
  "period_billing_hours": 123,
  "provider": "<string>",
  "ram_gb": 123,
  "ram_gb_cost_per_hour": 123,
  "raw_pricing_data": {},
  "region": "<string>",
  "resizable": true,
  "service": "<string>",
  "tags": {},
  "updated_at": "<string>",
  "usage_type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "affected": [
    {
      "id": "<string>",
      "kind": "<string>",
      "name": "<string>"
    }
  ],
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "detail": "<string>",
      "pointer": "<string>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}