Clore GigaSPOT

GET Market

GEThttps://api.clore.ai/v1/get_gigaspot

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"
      }
    ],
    "cuda": "11.6",
    "max_rental_length": 792000,
    "cc": "RU",
    "host": 2525,
    "reliability": 0.974,
    "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"
      }
    ],
    "cuda": "12.4",
    "max_rental_length": 864000,
    "cc": "KZ",
    "host": 1,
    "reliability": 0.6436,
    "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).
`cuda`	String	CUDA version installed on the machine.
`max_rental_length`	Integer	Maximal rental length (order time till expiry) in seconds
`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
`energy_price`	Float	Energy price (in dollars per unit).

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

Request

Header Params

Content-Type

string

required

Example:

application/json

auth

string

required

clore.ai api token

Example:

NXj2bHUXHwzvd5-Lm6UfvgGtnNwaHxLu

Responses

Success(200)

Unauthorized(401)

HTTP Code: 200

Content Type : JSONapplication/json

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

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

Last modified: 7 days ago