GET Market

Returns url to json on cdn with latest snapshot of GigaSPOT marketplace, reason for this is to save on resources.
The snapshot includes all machines on GigaSPOT and all bids on them.

Example snapshot

{
  "35083": {
    "bids": [],
    "on_demand_rented": false,
    "online": true,
    "cpu": "Intel(R) Celeron(R) CPU B815 @ 1.60GHz",
    "cores": 2,
    "threads": 2,
    "ram": 3.8036,
    "gpus": [
      {
        "pl": [70, 100],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 90],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 90],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 100],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 100],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 100],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 100],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      },
      {
        "pl": [70, 100],
        "mem_lock": [405, 7001],
        "core_lock": [300, 1470],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 100],
        "model": "GTX 1660 SUPER"
      }
    ],
    "working_properly": true,
    "cuda": "11.6",
    "max_rental_length": 792000,
    "cc": "RU",
    "host": 2525,
    "reliability": 0.974,
    "min_bid": 13.5067,
    "energy_price": 0.05
  },
  "40329": {
    "bids": [
      {
        "owner": 2,
        "id": 542567,
        "active": true,
        "to_cache": true,
        "cached": true,
        "price": 0.2,
        "currency": "CLORE-Blockchain",
        "pl": 400
      }
    ],
    "on_demand_rented": false,
    "online": false,
    "cpu": "Intel(R) Xeon(R) CPU E5-2698 v3 @ 2.30GHz",
    "cores": 32,
    "threads": 64,
    "ram": 128.8009,
    "gpus": [
      {
        "pl": [150, 450],
        "mem_lock": [405, 10501],
        "core_lock": [210, 2450],
        "mem_offset": [-2000, 2000],
        "core_offset": [-1000, 200],
        "model": "RTX 4090"
      }
    ],
    "working_properly": true,
    "cuda": "12.4",
    "max_rental_length": 864000,
    "cc": "KZ",
    "host": 1,
    "reliability": 0.6436,
    "min_bid": 13.4796,
    "energy_price": 0.042
  }
}

Snapsot explanation

Highest Level Keys

It's server IDs, in this example there are servers ID 35083 and 40329

Top-Level Keys

Key	Type	Description
`bids`	Array	List of active bids (orders) on GigaSPOT with the machine. Empty if no bids exist.
`on_demand_rented`	Boolean	Indicates whether the machine is rented on-demand (`true` or `false`).
`online`	Boolean	Specifies if the machine is online and operational (`true` or `false`).
`cpu`	String	CPU model used in the machine.
`cores`	Integer	Number of physical CPU cores.
`threads`	Integer	Number of CPU threads available.
`ram`	Float	Total RAM (in GB).
`gpus`	Array	List of GPU details (explained below).
`working_properly`	Boolean	GPUs have passed GPU check, ⚠️ we recommend renting only machines with `working_properly: true`
`cuda`	String	CUDA version installed on the machine.
`max_rental_length`	Integer	Maximal rental length (order time till expiry) in seconds. ⚠️ If equals 0, means machine can't be rented ⚠️
`CC`	String	Country code of location of machine in ISO 3166-1 alpha-2
`host`	Integer	ID of hosting provider
`reliability`	Float	% Uptime of machine in last 14 days
`min_bid`	Float	Minimal bid value (in CLORE Blockchain)
`energy_price`	Float	Energy price (in dollars per KWh)

Field Details

`bids`

Key	Type	Description
`owner`	Integer	ID of the user who placed the bid
`id`	Integer	Unique identifier for the bid (order ID)
`active`	Boolean	Indicates if the bid (order) is currently active (`true` or `false`)
`to_cache`	Boolean	Whether the bid can and will be cached on the machine
`cached`	Boolean	Indicates if the bid is cached on the machine
`price`	Float	Bid price in the specified `currency`
`currency`	String	Currency used for the bid (e.g., "CLORE-Blockchain")
`pl`	Integer	Power limit (in watts) associated with the bid

`gpus`

Key	Type	Description
`pl`	Array	Allowed power limit range (W) (`[min, max]`)
`mem_lock`	Array	Allowed memory lock range (MHz) (`[min, max]`)
`core_lock`	Array	Allowed core clock range (MHz) (`[min, max]`)
`mem_offset`	Array	Allowed memory clock offset range (MHz) (`[min, max]`)
`core_offset`	Array	Adjustable core clock offset range (MHz) (`[min, max]`)
`model`	String	GPU model name

⚠️ Core Offset, Mem Offset is in real MHz, which means will see 50% of value you will input for example in HiveOS or nVidia linux driver. You will see values for like MSI afterburner on windows

application/json

Body

my_user_id

integer

required

Your user ID, useful to see your bids in the snapshot

v1_snapshot_url

string

required

Link to last snapshot on CDN

creation_fees

object

required

GigaSPOT order creation fees by currency

CLORE-Blockchain

number

required

code

integer

required

clore.ai status code

Example

{
  "my_user_id": 3,
  "v1_snapshot_url": "https://gigaspot-snapshots.clore.ai/prod_6K80i2Tyvm_1735176176.json",
  "creation_fees": {
    "CLORE-Blockchain": 0.045
  },
  "code": 0
}

Example snapshot

Snapsot explanation

Highest Level Keys

Top-Level Keys

Field Details

`bids`

`gpus`

Request

Responses

GET Market

Example snapshot#

Snapsot explanation#

Highest Level Keys#

Top-Level Keys#

Field Details#

bids#

gpus#

Request

Responses

Example snapshot

Snapsot explanation

Highest Level Keys

Top-Level Keys

Field Details

`bids`

`gpus`