Luxor Documentation Hub Logo
Energy

Getting Started

Our Signal Engine automates economic dispatch and high-value ancillary market participation—optimizing your energy assets right from the same Luxor dashboard you use for Pool, Firmware, and Derivatives.

Luxor's Dispatch Signal

Our dispatch signal delivers real-time, actionable data to guide optimal dispatch decisions for every settlement interval. Built by miners for miners, it incorporates:

  • Market Conditions: Up-to-date power market dynamics to capitalize on power price fluctuations.
  • Site Obligations: Committed energy contracts and hourly power exposure.
  • Operational Constraints: Site-specific limitations to ensure seamless execution.

This comprehensive data stream allows your software to refine its configuration of entire fleets or facilities, balancing profitability with operational realities.

Why integrate with Luxor’s Dispatch Signal?

  • Enhanced Decision-Making: Our signal provides rich, real-time data to inform your software’s dispatch logic, complementing your existing optimization capabilities.
  • Market-Leading Design: Developed with deep mining expertise, the signal leverages Luxor’s understanding of energy markets and mining operations.
  • Seamless Execution with LuxOS: When paired with Luxor’s firmware, the signal benefits from best-in-class control, automated thermal management, and rapid profile switching, ensuring flawless execution of dispatch decisions.

How to Get Started in 4 Steps

Set Up Your Energy Assets

First, register your energy facilities in the system. Each site represents a physical asset with specific operational characteristics.

POST /api/v1/energy/sites
Content-Type: application/json
Authorization: Bearer your-token
 
{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "min_load_kw": "1000.0",
    "max_load_kw": "5000.0",
    "settlement_point_id": "settlement-point-uuid",
    "comments": "West Texas Solar Farm - 5MW AC"
}

Configure Your Commercial Arrangements

Add your energy contracts to compute all-in costs and track revenue streams. Retail Adders and Transmission & Distribution charges (T&D) are key inputs for accurate decision making. This may include PPAs, Options, and Day-Ahead trades.

POST /api/v1/energy/contracts
Content-Type: application/json
Authorization: Bearer your-token
 
{
    "contract": {
        "site_id": "550e8400-e29b-41d4-a716-446655440000",
        "type": "REP_Adder",
        "subtype": "FIXED",
        "price": "1.50",
        "start_time": "2025-01-01T00:00:00Z",
        "end_time": "2030-12-31T23:59:59Z",
        "counterparty": "ABC Energy"
    }
}

Start Reporting Operational Data

Begin sending real-time operational data to track performance and enable market participation.

POST /api/v1/energy/sites/550e8400-e29b-41d4-a716-446655440000/report_energy
Content-Type: application/json
Authorization: Bearer your-token
 
{
    "reports": [
        {
        "load_kw": "3250.5",
        "timestamp": "2025-06-30T12:00:00Z"
        }
    ]
}

Process Site Conditions

Use the following two endpoints to pull every data point necessary to calculate all-in energy price and machine profitability:

Fetch Most Recent Site Conditions

This pulls the most recent market prices, along with any relevant operational constraints.

# Fetch site conditions
GET /api/v1/energy/site-conditions
  site_id="550e8400-e29b-41d4-a716-446655440000",
  start_date="2025-06-01T00:00:00Z",
  end_date="2025-07-01T00:00:00Z",
  page_number=1,
  page_size=100

The most recent site_condition contains the most recent market prices.

# Successful response for site conditions
{
  "site_conditions": [
    {
      "site_id": "550e8400-e29b-41d4-a716-446655440000",
      "min_load_kw": 2000,
      "max_load_kw": 5000,
      "hashprice": 0.05292,
      "energy_price_spot": 33.54,
      "timestamp": "2025-07-01T16:14:00.291Z",
 
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created_at": "2025-07-01T16:14:00.291Z"
    }
  ],
  "pagination": {
    "page_number": 1,
    "page_size": 100,
    "item_count": 1
  }
  • hashprice & energy_price_spot are the most recent market prices, which determine profitability and optimal state.

  • min_load_kw & max_load_kw are operation constraints, often caused by DR programs and obligations.

Fetch Relevent Commercial Terms

This pulls contracts belonging to a site, including REP_Adder and T_D_Adder which determine realized_energy_cost.

# Retrieve commercial terms for all-in cost
GET /api/v1/energy/contracts
  site_id="550e8400-e29b-41d4-a716-446655440000",
  page_number=1,
  page_size=100

An agent should use energy_price_spot from the site conditions and applicable adders (e.g., T_D_Adder) drawn from the listed contracts to compute the all-in energy price:

The hashprice (in $/TH/Day) represents the value of the machine’s compute capacity. By combining the current spot hashprice with the realized energy cost, an agent can calculate breakeven power price and profitability, along with the optimal LuxOS profile.

This enables dynamic, data-driven dispatch decisions that optimize your fleet for both revenue and cost efficiency.

On this page