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"
}
},
],
}Last updated