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