Miners Endpoint
This API endpoint provides relation in between Filecoin Miner IDs and their EVP reports that include Greenscores.
Get All Miners and their EVP reports
Please note that this endpoint supports pagination and only shows 100 EVP report records at a time by default. Below is an example of how to use with and without pagination as well as how to filter by date.
//Default example: this will return 100 records from the first page
curl -X GET 'https://api.novaenergy.ai/api/miners' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json'
//Example with pagination: this will return 20 records from page 2
curl -X GET 'https://api.novaenergy.ai/api/miners?page=2&limit=20' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json'
//Example with filtering by date
curl -X GET 'https://api.novaenergy.ai/api/miners?date=2022-09-21' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json'
200: OK JSON response example
{
"data": [
{
"node_id": "3f2359b2-a2d9-4073-8b50-05430eaa0ba8",
"documents": [
{
"data": {
"audit_document": {
"evp_report": {
"miner_ids": [
"f01959735"
],
"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": "MongoStorage",
"report_end_date": "2023-03-20T08:31:00.000Z",
"energy_production": {
"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": "Rooftop Solar",
"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": 11640000,
"renewable_electricity_purchased_docs": "N/A",
"renewable_electricity_purchased_source": "N/A"
},
"report_start_date": "2023-02-21T08:31:00.000Z",
"water_consumption": {
"end_date": "2023-03-20T08:31:00.000Z",
"reference": "N/A",
"start_date": "2023-02-21T08:31:00.000Z",
"water_usage": false,
"water_company": "N/A",
"water_consumed": 0,
"is_historic_data": true,
"water_bill_files": []
},
"location_information": {
"provider_city": "Chino",
"entity_company": null,
"provider_state": null,
"is_historic_data": true,
"provider_country": "US",
"provider_zipcode": "91710",
"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"
},
"is_historic_data": true
},
"electricity_consumption": {
"end_date": "2023-03-20T08:31:00.000Z",
"reference": "N/A",
"start_date": "2023-02-21T08:31:00.000Z",
"is_historic_data": true,
"electricity_company": "N/A",
"electricity_bill_files": [],
"estimation_methodology": null,
"annual_electricity_usage": 188300990,
"actual_electricity_consumed": 1027,
"actual_electricity_returned": 265,
"actual_electricity_delivered": 1292,
"electricity_not_powering_infrastructure": 1027,
"total_electricity_used_for_node_operations": 265
},
"renewable_energy_procurement": {
"end_date": "2023-03-20T08:31:00.000Z",
"start_date": "2023-02-21T08:31:00.000Z",
"energy_usage": true,
"document_files": [],
"is_historic_data": true,
"supporting_files": [],
"renewable_energy_type": "Rooftop Solar",
"actual_electricity_returned": 0,
"actual_electricity_delivered": 0,
"network_renewable_energy_purchases": 11640000
},
"preliminary_results_rec_matching": {
"end_date": "2023-03-20T08:31:00.000Z",
"start_date": "2023-02-21T08:31:00.000Z",
"time_period": "N/A",
"supporting_file": null,
"total_emissions": 0,
"emissions_factor": 436,
"is_historic_data": true,
"actual_electricity_consumed": 1027,
"actual_electricity_returned": 265,
"actual_electricity_delivered": 1292
}
},
"greenscore": {
"other": {
"co2_storage_block_cid": "bafyreiht7mghjnwdmcrry7m74jjtwkgyj3ylid7p2jf2qzxl3qm72kwnxe",
"notes_on_data_sources": "Monthly power bills, Metering Logs from Tesla App",
"co2_storage_content_cid": "bafyreifycihnmy7ei6qx6ef6osww7zt65qm4m4j6mpbu53nash66sc3kty",
"co2_storage_previous_asset_cid": null,
"information_about_greenscore_mesurement_type": "Electricity and Water data for Green Score"
},
"miner_ids": [
"f01959735"
],
"document_id": null,
"green_score": 55.505,
"provider_city": "Chino",
"entity_company": "MongoStorage",
"location_score": 0.418,
"emissions_score": 0.314,
"report_end_date": "2023-03-20T08:31:00.000Z",
"confidence_score": 0.933,
"is_historic_data": true,
"provider_country": "US",
"provider_location": null,
"report_start_date": "2023-02-21T08:31:00.000Z",
"grid_emissions_factor": null,
"provider_network_type": 1,
"provider_location_code": "91710",
"confidence_score_details": {
"node_id_confidence": 1,
"hardware_confidence": 1,
"location_confidence": 0.65,
"water_use_confidence": null,
"energy_use_confidence": 1,
"node_id_confidence_percentage_information": "Auditor verifies no discrepancies (100%)",
"hardware_confidence_percentage_information": "Photo and video evidence provided to further verify claims (100%)",
"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 matches granular (100%)"
},
"marginal_emissions_factor": null,
"network_marginal_emissions": {
"network_marginal_emissions": 108642984,
"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": 1281.84,
"scope2_emissions_calculation": {
"scope2_emissions": 912.22,
"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": 77024190,
"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"
}
}
}
},
],
"success": true,
"pagination": {
"currentPage": 1,
"limit": 100,
"totalMiners": 100
}
}Get the EVP report data for a Specific Miner by its Miner ID
By passing in the miner_id you will see the EVP data for that miner.
This endpoint also supports filtering by date.
Query Parameters
Name
Type
Description
miner_id
String
the id string of the miner, for example, f01234
date
String
optional string param to filter by date if needed
curl -X GET 'https://api.novaenergy.ai/api/miners/f01813052' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json'
// Filtering by date
curl -X GET 'https://api.novaenergy.ai/api/miners/f01813052?date=2022-09-21' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json'
200 OK Response
{
"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"
}
},
],
"success": true
}Filter By Date
https://api.novaenergy.ai/api/miners/?date=2022-09-21
Last updated