Nodes Endpoint

This API endpoint provides all nodes of different provider network types and their associated Energy Validation Process (EVP) data.

Current Supported Provider Types

Provider types that exist:

• If you are a Filecoin Miner, miner_id - your Network Type is 1

• If you are an ETH Validator, Eth Validator id - your Network Type is 2

• If you are a Solana Validator, Solana ID - your Network Type is 3

• If you are an ICP Node Operator, id - your Network Type is 4

• If you are a Bitcoin Miner, id - your Network Type is 5

Get a list of all nodes with associated EVP data

GET

curl -X GET 'https://api.novaenergy.ai/api/nodes' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -H 'network: YOUR_NETWORK_TYPE' \
  -H 'Content-Type: application/json'
  
  
// Optional Filter by date 

curl -X GET 'https://api.novaenergy.ai/api/nodes?date=2022-09-21' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -H 'network: YOUR_NETWORK_TYPE' \
  -H 'Content-Type: application/json'

200 Response OK Example for Filecoin Miners 

{
  "data": [
    {
      "created_at": "2023-03-01T08:31:00.000Z",
      "evp_report": {
        "miner_ids": [
          "f01971600",
          "f033462",
          "f01985775",
          "f01988794",
          "f01985745",
          "f01992630",
          "f010202",
          "f01149873",
          "f01086808",
          "f01813052",
          "f010038",
          "f01996825",
          "f02002141",
          "f02005421",
          "f02009630",
          "f01135819",
          "f02029592",
          "f0145060",
          "f060805",
          "f0134867",
          "f02023473",
          "f082730"
        ],
        "created_at": "2023-03-01T08:31:00.000Z",
        "updated_at": "2023-03-31T08:31:00.000Z",
        "audit_review": {
          "report_option": 1,
          "review_status": 3,
          "is_historic_data": true,
          "provider_evp_status": 3,
          "auditor_evp_submission_date": "2024-08-29T23:33:51.593Z"
        },
        "entity_company": "Greaterheat",
        "report_end_date": "2023-03-31T08:31:00.000Z",
        "energy_production": {
          "created_at": "2024-08-29T23:48:49.438Z",
          "updated_at": "2024-08-29T23:48:49.438Z",
          "purchase_files": [],
          "inspection_date": "N/A",
          "solar_watt_peak": 0,
          "inspection_files": [],
          "is_historic_data": true,
          "installation_date": "N/A",
          "solar_panel_brand": "N/A",
          "method_of_mesurement": "",
          "number_of_solar_panels": 0,
          "renewable_energy_usage": true,
          "frequency_of_mesurement": "N/A",
          "solar_panel_modal_number": "N/A",
          "total_electricity_controlled": 0,
          "renewable_electricity_purchased": 0,
          "network_renewable_energy_purchases": 0,
          "renewable_electricity_purchased_docs": "N/A",
          "renewable_electricity_purchased_source": "N/A"
        },
        "report_start_date": "2023-03-01T08:31:00.000Z",
        "water_consumption": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "reference": "N/A",
          "created_at": "2023-03-01T08:31:00.000Z",
          "start_date": "2023-03-01T08:31:00.000Z",
          "updated_at": "2023-03-31T08:31:00.000Z",
          "water_usage": false,
          "water_company": "N/A",
          "water_consumed": 0,
          "is_historic_data": true,
          "water_bill_files": []
        },
        "location_information": {
          "created_at": "2024-08-29T23:33:51.593Z",
          "updated_at": "2024-08-29T23:33:51.593Z",
          "provider_city": "Dallas",
          "entity_company": null,
          "provider_state": null,
          "is_historic_data": true,
          "provider_country": "US",
          "provider_zipcode": null,
          "address_confirmed": true,
          "provider_location": "N/A"
        },
        "provider_network_type": 1,
        "hardware_configuration": {
          "hardware": {
            "description": "N/A",
            "hardware_type": "N/A",
            "supporting_file": [],
            "hardware_details": "N/A"
          },
          "created_at": "2024-08-29T23:33:51.593Z",
          "updated_at": "2024-08-29T23:33:51.593Z",
          "is_historic_data": true
        },
        "electricity_consumption": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "reference": "N/A",
          "start_date": "2023-03-01T08:31:00.000Z",
          "is_historic_data": true,
          "electricity_company": "N/A",
          "electricity_bill_files": [],
          "estimation_methodology": null,
          "annual_electricity_usage": 184630000,
          "actual_electricity_consumed": 211680,
          "actual_electricity_returned": 302400,
          "actual_electricity_delivered": 514080,
          "electricity_not_powering_infrastructure": 211680,
          "total_electricity_used_for_node_operations": 302400
        },
        "renewable_energy_procurement": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "created_at": "2024-08-29T23:48:49.438Z",
          "start_date": "2023-03-01T08:31:00.000Z",
          "updated_at": "2024-08-29T23:48:49.438Z",
          "energy_usage": true,
          "document_files": [],
          "is_historic_data": true,
          "supporting_files": [],
          "renewable_energy_type": "",
          "actual_electricity_returned": 0,
          "actual_electricity_delivered": 0,
          "network_renewable_energy_purchases": 0
        },
        "preliminary_results_rec_matching": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "created_at": "2024-08-29T23:48:49.438Z",
          "start_date": "2023-03-01T08:31:00.000Z",
          "updated_at": "2024-08-29T23:48:49.438Z",
          "time_period": "N/A",
          "supporting_file": null,
          "total_emissions": 0,
          "emissions_factor": 436,
          "is_historic_data": true,
          "actual_electricity_consumed": 211680,
          "actual_electricity_returned": 302400,
          "actual_electricity_delivered": 514080
        }
      },
      "greenscore": {
        "other": {
          "co2_storage_block_cid": "bafyreiapn7sjh34x6g6l3fv5mzltcdjrxq53olnu3bjqh2mpcb46e7fs5y",
          "notes_on_data_sources": "SP provided monthly power bills.",
          "co2_storage_content_cid": "bafyreibch5qzgxw2lydpihsupudg4uqt6ztctfyjg5mqjfoor4tnqahn5u",
          "co2_storage_previous_asset_cid": null,
          "information_about_greenscore_mesurement_type": "Electricity and Water data for Green Score"
        },
        "miner_ids": [
          "f01971600",
          "f033462",
          "f01985775",
          "f01988794",
          "f01985745",
          "f01992630",
          "f010202",
          "f01149873",
          "f01086808",
          "f01813052",
          "f010038",
          "f01996825",
          "f02002141",
          "f02005421",
          "f02009630",
          "f01135819",
          "f02029592",
          "f0145060",
          "f060805",
          "f0134867",
          "f02023473",
          "f082730"
        ],
        "green_score": 69.549,
        "provider_city": "Dallas",
        "entity_company": "Greaterheat",
        "location_score": 0.851,
        "emissions_score": 0.825,
        "report_end_date": "2023-03-31T08:31:00.000Z",
        "confidence_score": 0.411,
        "is_historic_data": true,
        "provider_country": "US",
        "provider_location": null,
        "report_start_date": "2023-03-01T08:31:00.000Z",
        "grid_emissions_factor": null,
        "provider_network_type": 1,
        "provider_location_code": null,
        "confidence_score_details": {
          "node_id_confidence": 1,
          "hardware_confidence": 0.3,
          "location_confidence": 0.65,
          "water_use_confidence": null,
          "energy_use_confidence": 0.4,
          "node_id_confidence_percentage_information": "Auditor verifies no discrepancies (100%)",
          "hardware_confidence_percentage_information": "Self Reported by SP (30%)",
          "location_information_percentage_information": "Reported on Utility Bill or other third-party document (65%)",
          "water_use_confidence_percentage_information": "No data (0%)",
          "energy_use_confidence_percentage_information": "Power Bill (40%)"
        },
        "marginal_emissions_factor": null,
        "network_marginal_emissions": {
          "network_marginal_emissions": 113543760,
          "global_average_grid_emissions_factor": null,
          "total_network_electricity_consumption": null,
          "total_network_renewable_energy_production": null,
          "global_average_grid_emissions_factor_source": "https://ourworldindata.org/grapher/carbon-intensity-electricity?tab=table"
        },
        "benchmark_emission_intensity": null,
        "marginal_emissions_intensity": 327045.6,
        "scope2_emissions_calculation": {
          "scope2_emissions": 232742.16,
          "grid_emissions_factor_value": null,
          "actual_net_power_consumed_value": null,
          "renewable_energy_consumption_value": null,
          "average_data_storage_capacity_value": null
        },
        "emission_intensity_calculation": null,
        "normalized_emissions_intensity": null,
        "global_average_grid_emissions_factor": 436,
        "network_scope2_emissions_calculation": {
          "network_scope2_emissions": 80498680,
          "estimate_cumulative_energy_use_per_time": null,
          "global_average_grid_emissions_factor_value": 436,
          "network_average_renewable_energy_purchases_value": null,
          "average_raw_byte_capacity_for_reporting_time_value": null
        },
        "benchmark_marginal_emission_intensity": null,
        "normalized_marginal_emission_intensity": null,
        "global_average_marginal_emission_factor": 614.98,
        "global_average_marginal_emissions_factor_source": "https://unfccc.int/sites/default/files/resource/IFI%20Default%20Grid%20Factors%202021%20v3.1_unfccc.xlsx"
      }
    },
 ],
}

Retrieve a specific Node by provider network type's node id.

Provider types that exist:

• If you are a Filecoin Miner, please type your miner_id - your Network Type is 1

• If you are an ETH Validator, please type your Eth Validator id - your Network Type is 2

• If you are a Solana Validator, please type your Solana ID - your Network Type is 3

• If you are an ICP Node Operator, please type your id - your Network Type is 4

• If you are a Bitcoin Miner, please type your id - your Network Type is 5

GET

curl -X GET 'https://api.novaenergy.ai/api/nodes/[id]' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -H 'network: YOUR_NETWORK_TYPE' \
  -H 'Content-Type: application/json'
  
  
// Optional Filter by date 

curl -X GET 'https://api.novaenergy.ai/api/nodes/[id]?date=2022-09-21' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -H 'network: YOUR_NETWORK_TYPE' \
  -H 'Content-Type: application/json'

200 Response OK Example for Filecoin Miners 

{
  "data": [
    {
      "created_at": "2023-03-01T08:31:00.000Z",
      "evp_report": {
        "miner_ids": [
          "f01971600",
          "f033462",
          "f01985775",
          "f01988794",
          "f01985745",
          "f01992630",
          "f010202",
          "f01149873",
          "f01086808",
          "f01813052",
          "f010038",
          "f01996825",
          "f02002141",
          "f02005421",
          "f02009630",
          "f01135819",
          "f02029592",
          "f0145060",
          "f060805",
          "f0134867",
          "f02023473",
          "f082730"
        ],
        "created_at": "2023-03-01T08:31:00.000Z",
        "updated_at": "2023-03-31T08:31:00.000Z",
        "audit_review": {
          "report_option": 1,
          "review_status": 3,
          "is_historic_data": true,
          "provider_evp_status": 3,
          "auditor_evp_submission_date": "2024-08-29T23:33:51.593Z"
        },
        "entity_company": "Greaterheat",
        "report_end_date": "2023-03-31T08:31:00.000Z",
        "energy_production": {
          "created_at": "2024-08-29T23:48:49.438Z",
          "updated_at": "2024-08-29T23:48:49.438Z",
          "purchase_files": [],
          "inspection_date": "N/A",
          "solar_watt_peak": 0,
          "inspection_files": [],
          "is_historic_data": true,
          "installation_date": "N/A",
          "solar_panel_brand": "N/A",
          "method_of_mesurement": "",
          "number_of_solar_panels": 0,
          "renewable_energy_usage": true,
          "frequency_of_mesurement": "N/A",
          "solar_panel_modal_number": "N/A",
          "total_electricity_controlled": 0,
          "renewable_electricity_purchased": 0,
          "network_renewable_energy_purchases": 0,
          "renewable_electricity_purchased_docs": "N/A",
          "renewable_electricity_purchased_source": "N/A"
        },
        "report_start_date": "2023-03-01T08:31:00.000Z",
        "water_consumption": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "reference": "N/A",
          "created_at": "2023-03-01T08:31:00.000Z",
          "start_date": "2023-03-01T08:31:00.000Z",
          "updated_at": "2023-03-31T08:31:00.000Z",
          "water_usage": false,
          "water_company": "N/A",
          "water_consumed": 0,
          "is_historic_data": true,
          "water_bill_files": []
        },
        "location_information": {
          "created_at": "2024-08-29T23:33:51.593Z",
          "updated_at": "2024-08-29T23:33:51.593Z",
          "provider_city": "Dallas",
          "entity_company": null,
          "provider_state": null,
          "is_historic_data": true,
          "provider_country": "US",
          "provider_zipcode": null,
          "address_confirmed": true,
          "provider_location": "N/A"
        },
        "provider_network_type": 1,
        "hardware_configuration": {
          "hardware": {
            "description": "N/A",
            "hardware_type": "N/A",
            "supporting_file": [],
            "hardware_details": "N/A"
          },
          "created_at": "2024-08-29T23:33:51.593Z",
          "updated_at": "2024-08-29T23:33:51.593Z",
          "is_historic_data": true
        },
        "electricity_consumption": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "reference": "N/A",
          "start_date": "2023-03-01T08:31:00.000Z",
          "is_historic_data": true,
          "electricity_company": "N/A",
          "electricity_bill_files": [],
          "estimation_methodology": null,
          "annual_electricity_usage": 184630000,
          "actual_electricity_consumed": 211680,
          "actual_electricity_returned": 302400,
          "actual_electricity_delivered": 514080,
          "electricity_not_powering_infrastructure": 211680,
          "total_electricity_used_for_node_operations": 302400
        },
        "renewable_energy_procurement": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "created_at": "2024-08-29T23:48:49.438Z",
          "start_date": "2023-03-01T08:31:00.000Z",
          "updated_at": "2024-08-29T23:48:49.438Z",
          "energy_usage": true,
          "document_files": [],
          "is_historic_data": true,
          "supporting_files": [],
          "renewable_energy_type": "",
          "actual_electricity_returned": 0,
          "actual_electricity_delivered": 0,
          "network_renewable_energy_purchases": 0
        },
        "preliminary_results_rec_matching": {
          "end_date": "2023-03-31T08:31:00.000Z",
          "created_at": "2024-08-29T23:48:49.438Z",
          "start_date": "2023-03-01T08:31:00.000Z",
          "updated_at": "2024-08-29T23:48:49.438Z",
          "time_period": "N/A",
          "supporting_file": null,
          "total_emissions": 0,
          "emissions_factor": 436,
          "is_historic_data": true,
          "actual_electricity_consumed": 211680,
          "actual_electricity_returned": 302400,
          "actual_electricity_delivered": 514080
        }
      },
      "greenscore": {
        "other": {
          "co2_storage_block_cid": "bafyreiapn7sjh34x6g6l3fv5mzltcdjrxq53olnu3bjqh2mpcb46e7fs5y",
          "notes_on_data_sources": "SP provided monthly power bills.",
          "co2_storage_content_cid": "bafyreibch5qzgxw2lydpihsupudg4uqt6ztctfyjg5mqjfoor4tnqahn5u",
          "co2_storage_previous_asset_cid": null,
          "information_about_greenscore_mesurement_type": "Electricity and Water data for Green Score"
        },
        "miner_ids": [
          "f01971600",
          "f033462",
          "f01985775",
          "f01988794",
          "f01985745",
          "f01992630",
          "f010202",
          "f01149873",
          "f01086808",
          "f01813052",
          "f010038",
          "f01996825",
          "f02002141",
          "f02005421",
          "f02009630",
          "f01135819",
          "f02029592",
          "f0145060",
          "f060805",
          "f0134867",
          "f02023473",
          "f082730"
        ],
        "green_score": 69.549,
        "provider_city": "Dallas",
        "entity_company": "Greaterheat",
        "location_score": 0.851,
        "emissions_score": 0.825,
        "report_end_date": "2023-03-31T08:31:00.000Z",
        "confidence_score": 0.411,
        "is_historic_data": true,
        "provider_country": "US",
        "provider_location": null,
        "report_start_date": "2023-03-01T08:31:00.000Z",
        "grid_emissions_factor": null,
        "provider_network_type": 1,
        "provider_location_code": null,
        "confidence_score_details": {
          "node_id_confidence": 1,
          "hardware_confidence": 0.3,
          "location_confidence": 0.65,
          "water_use_confidence": null,
          "energy_use_confidence": 0.4,
          "node_id_confidence_percentage_information": "Auditor verifies no discrepancies (100%)",
          "hardware_confidence_percentage_information": "Self Reported by SP (30%)",
          "location_information_percentage_information": "Reported on Utility Bill or other third-party document (65%)",
          "water_use_confidence_percentage_information": "No data (0%)",
          "energy_use_confidence_percentage_information": "Power Bill (40%)"
        },
        "marginal_emissions_factor": null,
        "network_marginal_emissions": {
          "network_marginal_emissions": 113543760,
          "global_average_grid_emissions_factor": null,
          "total_network_electricity_consumption": null,
          "total_network_renewable_energy_production": null,
          "global_average_grid_emissions_factor_source": "https://ourworldindata.org/grapher/carbon-intensity-electricity?tab=table"
        },
        "benchmark_emission_intensity": null,
        "marginal_emissions_intensity": 327045.6,
        "scope2_emissions_calculation": {
          "scope2_emissions": 232742.16,
          "grid_emissions_factor_value": null,
          "actual_net_power_consumed_value": null,
          "renewable_energy_consumption_value": null,
          "average_data_storage_capacity_value": null
        },
        "emission_intensity_calculation": null,
        "normalized_emissions_intensity": null,
        "global_average_grid_emissions_factor": 436,
        "network_scope2_emissions_calculation": {
          "network_scope2_emissions": 80498680,
          "estimate_cumulative_energy_use_per_time": null,
          "global_average_grid_emissions_factor_value": 436,
          "network_average_renewable_energy_purchases_value": null,
          "average_raw_byte_capacity_for_reporting_time_value": null
        },
        "benchmark_marginal_emission_intensity": null,
        "normalized_marginal_emission_intensity": null,
        "global_average_marginal_emission_factor": 614.98,
        "global_average_marginal_emissions_factor_source": "https://unfccc.int/sites/default/files/resource/IFI%20Default%20Grid%20Factors%202021%20v3.1_unfccc.xlsx"
      }
    },
 ],
}