Ocean Mining Pool - Exergy Home Assistant Integration

Monitor your Ocean mining pool earnings and statistics directly in Home Assistant.

Before You Start

Before installing this integration:

Home Assistant with HACS installed - This is a custom integration distributed via HACS. See our system configuration guide if you need to set up Home Assistant and HACS.
Already mining to Ocean - Your miners must be configured to mine to Ocean pool. The integration pulls data from Ocean’s API based on your wallet address.
Your Ocean wallet address - The bitcoin address you configured in your miner’s pool settings.

What is Ocean?

Ocean is a bitcoin mining pool focused on decentralization and transparency. Key features:

Transparent - Block template selection visible (or build your own with DATUM)
No KYC - Privacy-respecting
TIDES payout - Fair reward distribution (similar to PPLNS)

Integration Features

The Exergy Ocean integration provides:

Sensors

Sensor	Description
Mining Account Hashrate (60s)	Current hashrate (60-second average) in TH/s
Mining Account Hashrate (300s)	Current hashrate (300-second average) in TH/s
Mining Account Shares (60s)	Shares submitted in last 60 seconds
Mining Account Shares (300s)	Shares submitted in last 300 seconds
Mining Account Shares in Tides	Total shares in TIDES
Mining Account Estimated Earnings Next Block	Estimated BTC earnings for next block
Mining Account Estimated Bonus Next Block	Estimated bonus BTC for next block
Mining Account Estimated Total Earnings Next Block	Total estimated earnings for next block
Mining Account Estimated Payout Next Block	Estimated payout for next block
Mining Account Unpaid Balance	Unpaid BTC balance
Mining Account Unpaid Balance USD	Unpaid balance converted to USD (requires sensor.exchange_rate_1_btc)
Mining Account Last Share Timestamp	Timestamp of last submitted share
Mining Account Active Workers	Count of currently active workers
Mining Account Lifetime Earnings	Total lifetime BTC earnings (scraped from website)

Workers are automatically discovered - if you have 3 workers, you’ll get sensors and binary sensors for each. Each worker appears as its own device under the main mining account device. For each worker detected, the following entities are created dynamically:

Sensor	Description
{worker_name} Hashrate (60s)	Worker’s hashrate (60-second average) in TH/s
{worker_name} Hashrate (300s)	Worker’s hashrate (300-second average) in TH/s
{worker_name} Last Share	Timestamp of worker’s last submitted share
{worker_name} Estimated Earnings Next Block	Worker’s estimated BTC earnings for next block
{worker_name} Lifetime Earnings	Worker’s total lifetime BTC earnings (scraped from website)

Worker Binary Sensors

Binary Sensor	Description
{worker_name} Online	Worker online/offline status (on = connected, off = disconnected)

Note: Entity IDs are automatically generated based on your wallet address. Find your actual entity IDs at Settings > Devices & Services > Exergy Ocean > [your device].

Installation

Step 1: Install via HACS

Open Home Assistant
Navigate to HACS → Integrations
Click + Explore & Download Repositories
Search for “Exergy Ocean”
Click Download
Restart Home Assistant

Step 2: Add Integration

Go to Settings → Devices & Services
Click + Add Integration
Search for “Exergy Ocean”
Enter your Ocean wallet address
Click Submit

Step 3: Verify

The integration creates sensors for your mining statistics. Check the device page to see all available entities.

Dashboard Integration

Display your mining earnings alongside miner status:

type: entities
title: Mining Stats
entities:
  # Entity IDs vary based on your wallet address
  # Find yours at Settings → Devices & Services → Exergy Ocean
  - entity: sensor.ocean_mining_account_hashrate_60s
    name: My Hashrate
  - entity: sensor.ocean_mining_account_estimated_earnings_next_block
    name: Est. Earnings
  - entity: sensor.ocean_mining_account_unpaid_balance
    name: Unpaid Balance

Automation Ideas

Low Hashrate Alert

Notify when your pool hashrate drops (indicates miner issues):

automation:
  - alias: "Low hashrate alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.ocean_hashrate_24h
        below: 30  # TH/s threshold
        for:
          hours: 2
    action:
      - service: notify.mobile_app
        data:
          message: "Mining hashrate dropped below threshold"

Daily Earnings Summary

Send a daily summary of mining earnings:

automation:
  - alias: "Daily mining summary"
    trigger:
      - platform: time
        at: "20:00:00"
    action:
      - service: notify.mobile_app
        data:
          message: >
            Today's mining: ~{{ states('sensor.ocean_estimated_daily') }} sats
            Unpaid: {{ states('sensor.ocean_unpaid_balance') }} sats