Clore GigaSPOT
    Clore GigaSPOT
    • GET Market
      GET
    • Create GigaSPOT orders
      POST
    • Edit GigaSPOT orders
      POST
    • Cancel Many Orders
      POST

      GET Market

      GET
      https://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"
      }
    ],
    "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#

      KeyTypeDescription
      bidsArrayList of active bids (orders) on GigaSPOT with the machine. Empty if no bids exist.
      on_demand_rentedBooleanIndicates whether the machine is rented on-demand (true or false).
      onlineBooleanSpecifies if the machine is online and operational (true or false).
      cpuStringCPU model used in the machine.
      coresIntegerNumber of physical CPU cores.
      threadsIntegerNumber of CPU threads available.
      ramFloatTotal RAM (in GB).
      gpusArrayList of GPU details (explained below).
      working_properlyBooleanGPUs have passed GPU check, ⚠️ we recommend renting only machines with working_properly: true
      cudaStringCUDA version installed on the machine.
      max_rental_lengthIntegerMaximal rental length (order time till expiry) in seconds. ⚠️ If equals 0, means machine can't be rented ⚠️
      CCStringCountry code of location of machine in ISO 3166-1 alpha-2
      hostIntegerID of hosting provider
      reliabilityFloat% Uptime of machine in last 14 days
      min_bidFloatMinimal bid value (in CLORE Blockchain)
      energy_priceFloatEnergy price (in dollars per KWh)

      Field Details#

      bids#

      KeyTypeDescription
      ownerIntegerID of the user who placed the bid
      idIntegerUnique identifier for the bid (order ID)
      activeBooleanIndicates if the bid (order) is currently active (true or false)
      to_cacheBooleanWhether the bid can and will be cached on the machine
      cachedBooleanIndicates if the bid is cached on the machine
      priceFloatBid price in the specified currency
      currencyStringCurrency used for the bid (e.g., "CLORE-Blockchain")
      plIntegerPower limit (in watts) associated with the bid

      gpus#

      KeyTypeDescription
      plArrayAllowed power limit range (W) ([min, max])
      mem_lockArrayAllowed memory lock range (MHz) ([min, max])
      core_lockArrayAllowed core clock range (MHz) ([min, max])
      mem_offsetArrayAllowed memory clock offset range (MHz) ([min, max])
      core_offsetArrayAdjustable core clock offset range (MHz) ([min, max])
      modelStringGPU 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

      🟢200Success
      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
}
      🟠401Unauthorized
      Modified at 2025-01-19 18:02:45
      Next
      Create GigaSPOT orders
      Built with