API de Modelagem Financeira Pronta para Credores para Sistemas Híbridos API

API ID 13409

Aumente a confiança com nossa API de Modelagem Financeira Pronta para Credores para financiamento híbrido de projetos sem costura

Documentação da API

Endpoints

Requisição
Análise de pré-viabilidade de diesel para solar em local único: dimensionamento otimizado de PV+BESS, sequência de despacho, NPV/IRR/retorno, sinal de conformidade DSCR, rendimento de crédito de carbono e saúde térmica do gerador — sem o cronograma de fluxo de caixa completo de 25 anos. Construído para qualificação rápida no topo do funil. Resultados de DSCR/covenant assumem financiamento de projeto estilo SPV sem recurso e não são um veredicto de viabilidade para empréstimos corporativos com recurso
Endpoint ID: 28872
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28872/pre-feasibility+screening+report
PARÂMETROS DE ENTRADA

Relatório de Triagem de Pré-Viabilidade — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "financing_structure_scope": "This engine's DSCR / covenant bankability layer (see 'dscr' block below) assumes non-recourse, SPV-style project finance. It does not model corporate/balance-sheet-recourse financing structures, which are underwritten differently (consolidated financials, interest coverage) and are out of scope for this version.",
    "input": {
        "country": "Nigeria",
        "load_profile": "manufacturing",
        "avg_daily_load_kwh": 2400,
        "nameplate_kva": 500,
        "load_fraction": 0.75,
        "target_displacement_pct": 70,
        "backup_hours_target": 4
    },
    "country_context": {
        "irradiance_kwh_m2_yr": 1850,
        "grid_availability_pct": 45,
        "diesel_price_usd_l": 0.55,
        "grid_tariff_usd_kwh": 0.035,
        "currency": "NGN",
        "ambient_temp_c": 32,
        "source_irradiance": "NASA POWER MERRA-2; Fraunhofer ISE PV Report 2024",
        "source_diesel": "GIZ HERA (2019); NNPC pump price 2024"
    },
    "diesel_baseline": {
        "fuel_cost_usd_kwh": 0.1969,
        "maintenance_usd_kwh": 0.015,
        "replacement_amort_usd_kwh": 0.0292,
        "total_all_in_usd_kwh": 0.2411,
        "fuel_consumption_lph": 107.4,
        "load_kw": 300,
        "source_fuel_curve": "ISO 8528-1:2005 §13",
        "source_maintenance": "GIZ HERA (2019); Wood Mackenzie Africa C&I (2022)"
    },
    "generator_health": {
        "load_fraction": 0.75,
        "load_kw": 300,
        "wet_stack_risk": false,
        "warning": null,
        "source": "Cummins Power Generation Application Note (2002); GIZ HERA (2019) §4.3"
    },
    "grid_downtime_cost": {
        "grid_availability_pct": 45,
        "grid_down_hours_yr": 4818,
        "backup_energy_needed_kwh": 481800,
        "diesel_backup_cost_usd_yr": 116162,
        "productive_loss_usd_yr": null,
        "productive_loss_plausibility_flag": null,
        "total_downtime_cost_usd_yr": 116162,
        "source": "World Bank Enterprise Surveys (2023); ESMAP (2023); GIZ HERA (2019)"
    },
    "solar_sizing": {
        "pv_capacity_kw_dc": 689.5,
        "inverter_ac_capacity_kw": 574.6,
        "dc_ac_ratio": 1.2,
        "annual_pv_output_kwh_ac": 830375,
        "direct_solar_consumed_kwh": 597870,
        "solar_fraction_pct_sizing": 68.2,
        "note_solar_fraction": "This is the pre-BESS sizing estimate. dispatch_model.diesel_displacement_pct is the authoritative post-dispatch figure.",
        "curtailed_kwh_upper": 232505,
        "specific_yield_kwh_kwp": 1235,
        "thermal_derating_factor": 0.856,
        "system_pr": 0.78,
        "capex_usd_per_wp": 0.78,
        "pv_capex_usd": 537804,
        "source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
        "source_yield": "PVGIS-SARAH2; Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
        "source_thermal": "King et al. (2004) NREL; IEC 61215:2021 §11.5",
        "source_capex": "NREL ATB 2024 Commercial PV + Africa logistics premium (Wood Mackenzie 2024)"
    },
    "land_area": {
        "ground_mount_m2": 5516,
        "rooftop_m2": 4137,
        "ground_mount_ha": 0.55,
        "note": "Ground-mount includes inter-row spacing for 0°–30° latitude sites.",
        "source": "NREL Land-Use Requirements for Solar Power Plants (2013); Fraunhofer ISE 2024"
    },
    "bess_sizing": {
        "bess_usable_energy_kwh": 400,
        "bess_nameplate_energy_kwh": 522.9,
        "bess_power_kw": 261.4,
        "backup_hours_achieved": 4,
        "round_trip_efficiency_pct": 85,
        "depth_of_discharge_pct": 90,
        "daily_cycle_rate": 0.8,
        "pack_cost_usd": 94118,
        "bos_cost_usd": 31373,
        "bess_capex_usd": 125490,
        "effective_life_years": 12,
        "cycle_limited": true,
        "soh_degradation_curve": {
            "year_1": 98.3,
            "year_3": 95,
            "year_5": 91.7,
            "year_7": 88.3,
            "year_11": 81.6,
            "end_of_life_trigger": "80% SOH — replacement recommended"
        },
        "lcos_usd_per_mwh": 120,
        "lcos_benchmark_range": "USD 160–250/MWh for LFP (PNNL-33283; BloombergNEF 2024)",
        "source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162",
        "source_capex": "NREL ATB 2024 two-component formula; BloombergNEF BESS Survey 2024",
        "source_lcos": "Mongird et al. (2022) PNNL-33283 §5.1",
        "source_rte": "NREL ATB 2024 Storage — LFP round-trip efficiency",
        "source_soh": "Mongird et al. (2022) PNNL-33283 §4.2; CATL LFP datasheet"
    },
    "dispatch_model": {
        "annual_load_kwh": 876000,
        "solar_direct_kwh": 569400,
        "bess_charge_kwh": 81760,
        "bess_to_load_kwh": 69496,
        "generator_kwh": 237104,
        "curtailed_kwh": 179215,
        "solar_fraction_pct": 72.9,
        "diesel_displaced_kwh": 638896,
        "diesel_displacement_pct": 72.9,
        "source": "Lambert et al. (2006) HOMER merit-order dispatch; IEEE Std 1562-2007"
    },
    "financials": {
        "total_capex_usd": 729623,
        "base_capex_usd": 663294,
        "contingency_capex_usd": 66329,
        "pv_capex_usd": 537804,
        "bess_capex_usd": 125490,
        "tax_benefit_yr1_usd": 0,
        "tax_benefit_note": "No Pioneer Status tax holiday applied — this is the conservative base case. Pioneer Status under the NIPC Act requires a formal application, approval, and a gazetted qualifying sector — it is not automatic. If this project has confirmed Pioneer Status approval, rerun with pioneer_status_confirmed=true to model the 3-yr CIT holiday upside. Source: NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023.",
        "tax_benefit_treatment": "Tax holiday / accelerated depreciation benefit is realised as a one-time Year-1 operating cashflow addback (see cashflows_all_25yr[0]), not as a reduction of project capex. Debt and equity are sized against gross total_capex_usd. This matches conventional DFI/IFC project-finance treatment: construction is financed at full cost before any tax benefit is realised; the tax shield improves debt service coverage in the year it is claimed rather than reducing the amount financed.",
        "net_capex_after_tax_usd": 729623,
        "net_capex_after_tax_usd_note": "Memo figure only — shown for reference, not used in NPV, IRR, payback, or debt sizing. See tax_benefit_treatment above.",
        "annual_diesel_savings_usd": 154038,
        "annual_om_usd": 10577,
        "annual_insurance_usd": 3316,
        "npv_usd": 814913,
        "irr_pct": 21.3,
        "simple_payback_years": 5,
        "lcoe_solar_bess_usd_kwh": 0.0586,
        "diesel_allin_cost_usd_kwh": 0.2411,
        "lcoe_vs_diesel_usd_kwh": 0.1825,
        "co2_saved_tonnes_yr": 613,
        "co2_saved_tonnes_25yr": 15325,
        "diesel_saved_litres_yr": 228725,
        "discount_rate_pct": 10,
        "diesel_escalation_pct_yr": 3,
        "project_life_yr": 25,
        "source_irena": "IRENA (2023) Renewable Power Generation Costs §4",
        "source_tax": "NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023",
        "source_co2": "IPCC 2006 Guidelines Vol 2 Ch1 Table 1.4; EPA GHG emission factors",
        "source_ifc": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa"
    },
    "dscr": {
        "financing_structure": "non_recourse_project_finance_spv",
        "scope_note": "DSCR and covenant results assume non-recourse, SPV-style project finance. Not applicable as-is to corporate/balance-sheet-recourse financing, which is underwritten on consolidated financials and interest coverage, not isolated project CFADS.",
        "debt_fraction_pct": 70,
        "debt_amount_usd": 510736,
        "equity_amount_usd": 218887,
        "loan_tenor_yr": 10,
        "interest_rate_pct": 12,
        "annual_debt_service_usd": 90392,
        "dscr_year_1": 1.54,
        "dscr_minimum": 1.54,
        "dscr_minimum_year": 1,
        "lender_threshold": 1.3,
        "lender_bankability": "PASS",
        "note": "IFC minimum DSCR for green energy projects in Sub-Saharan Africa is 1.30. Projects below this require additional credit enhancement or concessional debt.",
        "source": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa; World Bank ESMAP project finance guidelines (2022)",
        "covenant_table": [
            {
                "year": 1,
                "cfads_usd": 139130,
                "annual_debt_service": 90392,
                "dscr": 1.54,
                "below_ifc_minimum": false,
                "lockup_triggered": false,
                "default_triggered": false,
                "distribution_allowed": true,
                "covenant_status": "COMPLIANT"
            },
            {
                "year": 2,
                "cfads_usd": 142689,
                "annual_debt_service": 90392,
                "dscr": 1.58,
                "below_ifc_minimum": false,
                "lockup_triggered": false,
                "default_triggered": false,
                "distribution_allowed": true,
                "covenant_status": "COMPLIANT"
            },
            {
                "year": 3,
                "cfads_usd": 146338,
                "annual_debt_service": 90392,
                "dscr": 1.62,
                "below_ifc_minimum": false,
                "lockup_triggered": false,
                "default_triggered": false
            }
        ]
    },
    "_note": "Response truncated for documentation purposes"
}
Relatório de Triagem de Pré-Viabilidade — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28872/pre-feasibility+screening+report' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "avg_daily_load_kwh": 2400,
  "backup_hours_target": 4,
  "country": "nigeria",
  "load_fraction": 0.75,
  "load_profile": "manufacturing",
  "nameplate_kva": 500,
  "target_diesel_displacement_pct": 70
}'

    
Requisição
Modelo de subscrição institucional com um cronograma de fluxo de caixa anual completo de 25 anos, degradação não linear do estado de saúde do BESS, estrutura de dívida configurável (prazo, taxa de juros, alavancagem), tabela de convenção de DSCR e contabilidade de registro de carbono - o pacote completo de engenharia e finanças que o comitê de crédito de um credor espera. Escopo: modelos de financiamento de projeto sem recurso, estilo SPV (dívida dimensionada e com convenção contra o CFADS isolado do projeto) - não uma metodologia de empréstimo com recurso a balanço corporativo. O tratamento fiscal da Seção 12B da África do Sul é limitado por capacidade por estatuto e não é uma taxa fixa. carbon_standard não é recuperado de nenhum endpoint - é um campo opcional que aceita exatamente dois valores fixos: "vcs" (Verra VCS VM0038, o padrão se omitido) ou "gold_standard" (Gold Standard AMS-I.D., que carrega um prêmio de preço sobre VCS). Escolha o registro sob o qual pretende certificar créditos; não há nada para pesquisar
Endpoint ID: 28873
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28873/lender-grade+full+underwriting+model
PARÂMETROS DE ENTRADA

Modelo de Subscrição Completa de Classe Credora — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "financing_structure_scope": "This engine's DSCR / covenant bankability layer (see 'dscr' block below) assumes non-recourse, SPV-style project finance. It does not model corporate/balance-sheet-recourse financing structures, which are underwritten differently (consolidated financials, interest coverage) and are out of scope for this version.",
    "input": {
        "country": "South Africa",
        "load_profile": "manufacturing",
        "avg_daily_load_kwh": 4800,
        "nameplate_kva": 1000,
        "load_fraction": 0.75,
        "target_displacement_pct": 75,
        "backup_hours_target": 6
    },
    "country_context": {
        "irradiance_kwh_m2_yr": 1950,
        "grid_availability_pct": 65,
        "diesel_price_usd_l": 1.1,
        "grid_tariff_usd_kwh": 0.135,
        "currency": "ZAR",
        "ambient_temp_c": 22,
        "source_irradiance": "PVGIS-SARAH2 (EU JRC); GeoSUN Africa atlas",
        "source_diesel": "SAPIA 2024"
    },
    "diesel_baseline": {
        "fuel_cost_usd_kwh": 0.3938,
        "maintenance_usd_kwh": 0.015,
        "replacement_amort_usd_kwh": 0.0292,
        "total_all_in_usd_kwh": 0.438,
        "fuel_consumption_lph": 214.8,
        "load_kw": 600,
        "source_fuel_curve": "ISO 8528-1:2005 §13",
        "source_maintenance": "GIZ HERA (2019); Wood Mackenzie Africa C&I (2022)"
    },
    "generator_health": {
        "load_fraction": 0.75,
        "load_kw": 600,
        "wet_stack_risk": false,
        "warning": null,
        "source": "Cummins Power Generation Application Note (2002); GIZ HERA (2019) §4.3"
    },
    "grid_downtime_cost": {
        "grid_availability_pct": 65,
        "grid_down_hours_yr": 3066,
        "backup_energy_needed_kwh": 613200,
        "diesel_backup_cost_usd_yr": 268582,
        "productive_loss_usd_yr": 3679200,
        "productive_loss_plausibility_flag": null,
        "total_downtime_cost_usd_yr": 3947782,
        "source": "World Bank Enterprise Surveys (2023); ESMAP (2023); GIZ HERA (2019)"
    },
    "solar_sizing": {
        "pv_capacity_kw_dc": 1331.7,
        "inverter_ac_capacity_kw": 1109.8,
        "dc_ac_ratio": 1.2,
        "annual_pv_output_kwh_ac": 1779375,
        "direct_solar_consumed_kwh": 1281150,
        "solar_fraction_pct_sizing": 73.1,
        "note_solar_fraction": "This is the pre-BESS sizing estimate. dispatch_model.diesel_displacement_pct is the authoritative post-dispatch figure.",
        "curtailed_kwh_upper": 498225,
        "specific_yield_kwh_kwp": 1370,
        "thermal_derating_factor": 0.901,
        "system_pr": 0.78,
        "capex_usd_per_wp": 0.78,
        "pv_capex_usd": 1038732,
        "source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
        "source_yield": "PVGIS-SARAH2; Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
        "source_thermal": "King et al. (2004) NREL; IEC 61215:2021 §11.5",
        "source_capex": "NREL ATB 2024 Commercial PV + Africa logistics premium (Wood Mackenzie 2024)"
    },
    "land_area": {
        "ground_mount_m2": 10654,
        "rooftop_m2": 7990,
        "ground_mount_ha": 1.07,
        "note": "Ground-mount includes inter-row spacing for 0°–30° latitude sites.",
        "source": "NREL Land-Use Requirements for Solar Power Plants (2013); Fraunhofer ISE 2024"
    },
    "bess_sizing": {
        "bess_usable_energy_kwh": 1200,
        "bess_nameplate_energy_kwh": 1568.6,
        "bess_power_kw": 784.3,
        "backup_hours_achieved": 6,
        "round_trip_efficiency_pct": 85,
        "depth_of_discharge_pct": 90,
        "daily_cycle_rate": 0.8,
        "pack_cost_usd": 282353,
        "bos_cost_usd": 94118,
        "bess_capex_usd": 376471,
        "effective_life_years": 12,
        "cycle_limited": true,
        "soh_degradation_curve": {
            "year_1": 98.3,
            "year_3": 95,
            "year_5": 91.7,
            "year_7": 88.3,
            "year_11": 81.6,
            "end_of_life_trigger": "80% SOH — replacement recommended"
        },
        "lcos_usd_per_mwh": 120,
        "lcos_benchmark_range": "USD 160–250/MWh for LFP (PNNL-33283; BloombergNEF 2024)",
        "source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162",
        "source_capex": "NREL ATB 2024 two-component formula; BloombergNEF BESS Survey 2024",
        "source_lcos": "Mongird et al. (2022) PNNL-33283 §5.1",
        "source_rte": "NREL ATB 2024 Storage — LFP round-trip efficiency",
        "source_soh": "Mongird et al. (2022) PNNL-33283 §4.2; CATL LFP datasheet"
    },
    "dispatch_model": {
        "annual_load_kwh": 1752000,
        "solar_direct_kwh": 1138800,
        "bess_charge_kwh": 245280,
        "bess_to_load_kwh": 208488,
        "generator_kwh": 404712,
        "curtailed_kwh": 395295,
        "solar_fraction_pct": 76.9,
        "diesel_displaced_kwh": 1347288,
        "diesel_displacement_pct": 76.9,
        "source": "Lambert et al. (2006) HOMER merit-order dispatch; IEEE Std 1562-2007"
    },
    "financials": {
        "total_capex_usd": 1556723,
        "base_capex_usd": 1415203,
        "contingency_capex_usd": 141520,
        "pv_capex_usd": 1038732,
        "bess_capex_usd": 376471,
        "tax_benefit_yr1_usd": 420315,
        "tax_benefit_note": "SA Income Tax Act §12B(1)(h) — solar PV not exceeding 1 MW. Nameplate 1000 kVA used as a proxy for generation capacity in kW (assumes power factor ~1.0 — confirm true kW rating before underwriting if this figure is within a few percent of the 1000 kVA / 1 MW threshold). Self-assessed allowance — no discretionary government approval required to claim, unlike Nigeria Pioneer Status or a Free Zone election. Trade-use requirement is satisfied by construction: this engine only models commercial/industrial load profiles, never residential. Ownership/instalment-credit-agreement and first-use conditions should still be confirmed with in-country counsel before underwriting — this figure assumes both are met. Reported value is the Year-1-present-value-equivalent of the 100% statutory schedule, not a flat rate.",
        "tax_benefit_treatment": "Tax holiday / accelerated depreciation benefit is realised as a one-time Year-1 operating cashflow addback (see cashflows_all_25yr[0]), not as a reduction of project capex. Debt and equity are sized against gross total_capex_usd. This matches conventional DFI/IFC project-finance treatment: construction is financed at full cost before any tax benefit is realised; the tax shield improves debt service coverage in the year it is claimed rather than reducing the amount financed.",
        "net_capex_after_tax_usd": 1136408,
        "net_capex_after_tax_usd_note": "Memo figure only — shown for reference, not used in NPV, IRR, payback, or debt sizing. See tax_benefit_treatment above.",
        "annual_diesel_savings_usd": 590112,
        "annual_om_usd": 23110,
        "annual_insurance_usd": 7076,
        "npv_usd": 4986480,
        "irr_pct": 46.3,
        "simple_payback_years": 3,
        "lcoe_solar_bess_usd_kwh": 0.0594,
        "diesel_allin_cost_usd_kwh": 0.438,
        "lcoe_vs_diesel_usd_kwh": 0.3786,
        "co2_saved_tonnes_yr": 1292.6,
        "co2_saved_tonnes_25yr": 32316,
        "diesel_saved_litres_yr": 482329,
        "cashflows_yr1_to_10": [
            976757,
            570490,
            584891,
            599652,
            614785,
            630296,
            646197,
            662496,
            679204,
            696331
        ],
        "cashflows_all_25yr": [
            976757,
            570490,
            584891,
            599652,
            614785,
            630296,
            646197,
            662496,
            679204,
            696331,
            713888,
            731885,
            750333,
            769243,
            788627,
            808497,
            828866,
            849744,
            871146,
            893085,
            915572,
            938624,
            962253,
            986474,
            1011301
        ],
        "discount_rate_pct": 10,
        "diesel_escalation_pct_yr": 3,
        "project_life_yr": 25,
        "source_irena": "IRENA (2023) Renewable Power Generation Costs §4",
        "source_tax": "SA Income Tax Act §12B (Act 58 of 1962, amended 2023)",
        "source_co2": "IPCC 2006 Guidelines Vol 2 Ch1 Table 1.4; EPA GHG emission factors",
        "source_ifc": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa"
    },
    "dscr": {
        "financing_structure": "non_recourse_project_finance_spv",
        "scope_note": "DSCR and covenant results assume non-recourse, SPV-style project finance. Not applicable as-is to corporate/balance-sheet-recourse financing, which is underwritten on consolidated financials and interest coverage, not isolated project CFADS.",
        "debt_fraction_pct": 70,
        "debt_amount_usd": 1089706,
        "equity_amount_usd": 467017,
        "loan_tenor_yr": 10,
        "interest_rate_pct": 12,
        "annual_debt_service_usd": 192861,
        "dscr_year_1": 5.06,
        "dscr_minimum": 2.96,
        "dscr_minimum_year": 2,
        "lender_threshold": 1.3,
        "lender_bankability": "PASS",
        "note": "IFC minimum DSCR for green energy projects in Sub-Saharan Africa is 1.30. Projects below this require additional credit enhancement or concessional debt."
    },
    "_note": "Response truncated for documentation purposes"
}
Modelo de Subscrição Completa de Classe Credora — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28873/lender-grade+full+underwriting+model' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "country": "south_africa",
  "load_profile": "manufacturing",
  "avg_daily_load_kwh": 4800,
  "nameplate_kva": 1000,
  "load_fraction": 0.75,
  "target_diesel_displacement_pct": 75,
  "backup_hours_target": 6,
  "project_life_yr": 25,
  "discount_rate_pct": 10,
  "revenue_per_operating_hour_usd": 1200,
  "debt_fraction_pct": 70,
  "loan_tenor_yr": 10,
  "interest_rate_pct": 12.0,
  "carbon_standard": "vcs"
}'

    
Requisição
Executa até 30 sites em uma chamada e retorna cada um classificado por IRR, juntamente com métricas totalizadas de portfólio - CAPEX agregado, receita de carbono misturada, contagens de aprovação/reprovação do DSCR e erros de validação - para desenvolvedores ou fundos que estão analisando um pipeline multissite de uma só vez. A aprovação/reprovação do DSCR de cada site assume financiamento de projeto no estilo SPV sem recurso, por site, e não dívida corporativa consolidada com recurso site_id não é recuperado de nenhum ponto final - é um rótulo que você escolhe para cada site na solicitação (por exemplo, "fábrica_ZA_001", "torre_NG_014"). É usado apenas para relacionar os resultados desse site de volta ao site que você enviou; não é validado contra nenhuma lista ou registro, então qualquer string não vazia funciona
Endpoint ID: 28874
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28874/portfolio+screening+and+fleet+ranking+report
PARÂMETROS DE ENTRADA

Relatório de Triagem de Portfólio e Classificação de Frota — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "sites_analysed": 3,
    "portfolio_summary": {
        "total_capex_usd": 3119874,
        "total_annual_savings_usd": 1294720,
        "total_co2_saved_tonnes_yr": 2896.9,
        "total_carbon_net_revenue_yr_usd": 31286,
        "avg_annual_savings_per_site_usd": 431573,
        "dscr_lender_pass_count": 2,
        "dscr_lender_fail_count": 1,
        "sites_errored_count": 0,
        "sites_successfully_analysed": 3,
        "sites_by_viability": {
            "marginal": 1,
            "excellent": 2
        }
    },
    "sites": [
        {
            "site_id": "factory_ZA_001",
            "country": "South Africa",
            "load_profile": "manufacturing",
            "pv_capacity_kw": 2130.7,
            "bess_energy_kwh": 1600,
            "diesel_displacement_pct": 72.9,
            "total_capex_usd": 2380325,
            "npv_usd": 10281945,
            "irr_pct": 57.3,
            "payback_years": 2,
            "dscr_lender_pass": true,
            "annual_savings_usd": 1147202,
            "co2_saved_tonnes_yr": 2506.7,
            "carbon_net_revenue_yr_usd": 27072,
            "lcoe_usd_kwh": 0.0478,
            "diesel_allin_usd_kwh": 0.4489,
            "fx_risk_level": "MEDIUM",
            "viability": "excellent"
        },
        {
            "site_id": "cold_KE_001",
            "country": "Kenya",
            "load_profile": "cold_chain",
            "pv_capacity_kw": 359.7,
            "bess_energy_kwh": 300,
            "diesel_displacement_pct": 66.4,
            "total_capex_usd": 459662,
            "npv_usd": 732648,
            "irr_pct": 25.8,
            "payback_years": 5,
            "dscr_lender_pass": true,
            "annual_savings_usd": 117081,
            "co2_saved_tonnes_yr": 268.6,
            "carbon_net_revenue_yr_usd": 2901,
            "lcoe_usd_kwh": 0.0812,
            "diesel_allin_usd_kwh": 0.4028,
            "fx_risk_level": "MEDIUM",
            "viability": "excellent"
        },
        {
            "site_id": "tower_NG_001",
            "country": "Nigeria",
            "load_profile": "telecoms_tower",
            "pv_capacity_kw": 226.9,
            "bess_energy_kwh": 160,
            "diesel_displacement_pct": 73.8,
            "total_capex_usd": 279887,
            "npv_usd": -2199,
            "irr_pct": null,
            "payback_years": 10,
            "dscr_lender_pass": false,
            "annual_savings_usd": 30437,
            "co2_saved_tonnes_yr": 121.6,
            "carbon_net_revenue_yr_usd": 1313,
            "lcoe_usd_kwh": 0.111,
            "diesel_allin_usd_kwh": 0.2354,
            "fx_risk_level": "HIGH",
            "viability": "marginal"
        }
    ],
    "source": "ISO 8528-1:2005 | NREL ATB 2024 | NREL/TP-5400-63162 | IRENA 2023 | PNNL-33283 | Jordan & Kurtz (2013) | IFC (2023) project finance | Verra VCS VM0038",
    "access": "entitled"
}
Relatório de Triagem de Portfólio e Classificação de Frota — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28874/portfolio+screening+and+fleet+ranking+report' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "sites": [
    {
      "site_id": "tower_NG_001",
      "country": "nigeria",
      "load_profile": "telecoms_tower",
      "avg_daily_load_kwh": 480,
      "nameplate_kva": 100,
      "load_fraction": 0.80,
      "target_diesel_displacement_pct": 80,
      "backup_hours_target": 8
    },
    {
      "site_id": "factory_ZA_001",
      "country": "south_africa",
      "load_profile": "manufacturing",
      "avg_daily_load_kwh": 9600,
      "nameplate_kva": 2000,
      "load_fraction": 0.70,
      "target_diesel_displacement_pct": 60,
      "backup_hours_target": 4
    },
    {
      "site_id": "cold_KE_001",
      "country": "kenya",
      "load_profile": "cold_chain",
      "avg_daily_load_kwh": 1200,
      "nameplate_kva": 250,
      "load_fraction": 0.85,
      "target_diesel_displacement_pct": 55,
      "backup_hours_target": 6
    }
  ],
  "project_life_yr": 25,
  "discount_rate_pct": 10
}'

    
Requisição
Pacote de dados estruturado em 8 seções — resumo executivo, contexto econômico do país, design de engenharia, livro de finanças, estruturação de dívida, registro de riscos, métricas ESG e citações de fontes — pré-formatado para geração de PDF sem cabeça (ReportLab, WeasyPrint, Puppeteer) em um relatório de viabilidade pronto para o cliente. As seções de estruturação de dívida e covenants assumem financiamento de projeto estilo SPV sem recurso, e não empréstimos corporativos. O tratamento de incentivos fiscais do país é específico por estatuto e dependente de elegibilidade, divulgado por país na Seção 2 carbon_standard não é recuperado de nenhum endpoint — é um campo opcional aceitando exatamente dois valores fixos: "vcs" (Verra VCS VM0038, o padrão se omitido) ou "gold_standard" (Gold Standard AMS-I.D., que tem um prêmio de preço sobre VCS). Escolha o registro sob o qual pretende certificar os créditos; não há nada a pesquisar
Endpoint ID: 28875
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28875/bankable+lender+package+8-section+report+data
PARÂMETROS DE ENTRADA

Pacote de Credor Bancável Relatório de Dados com 8 Seções — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "report_type": "bankable_pre_feasibility",
    "generated_at": "2026-08-03T19:02:25Z",
    "access": "entitled",
    "section_1_executive_summary": {
        "viability_rating": "EXCELLENT",
        "headline": "Excellent: 77% diesel displacement, 3-yr payback, 46.3% IRR. LCOE $0.059/kWh vs diesel $0.438/kWh. Lender DSCR: PASS.",
        "pv_capacity_kw": 1331.7,
        "bess_energy_kwh": 1200,
        "diesel_displacement_pct": 76.9,
        "total_capex_usd": 1556723,
        "npv_usd": 4986480,
        "irr_pct": 46.3,
        "payback_years": 3,
        "lcoe_solar_bess_usd_kwh": 0.0594,
        "diesel_allin_usd_kwh": 0.438,
        "lcoe_saving_per_kwh": 0.3786,
        "annual_savings_usd": 590112,
        "co2_saved_tonnes_yr": 1292.6,
        "lender_bankability": "PASS",
        "fx_risk_level": "MEDIUM"
    },
    "section_2_country_context": {
        "irradiance_kwh_m2_yr": 1950,
        "grid_availability_pct": 65,
        "diesel_price_usd_l": 1.1,
        "grid_tariff_usd_kwh": 0.135,
        "currency": "ZAR",
        "ambient_temp_c": 22,
        "source_irradiance": "PVGIS-SARAH2 (EU JRC); GeoSUN Africa atlas",
        "source_diesel": "SAPIA 2024",
        "incentives": {
            "section_12b": true,
            "corporate_tax_rate": 0.27,
            "vat_rate": 0.15,
            "carbon_credit_eligible": true
        },
        "incentive_source": "SA Income Tax Act §12B (Act 58 of 1962, amended 2023)",
        "downtime_analysis": {
            "grid_availability_pct": 65,
            "grid_down_hours_yr": 3066,
            "backup_energy_needed_kwh": 613200,
            "diesel_backup_cost_usd_yr": 268582,
            "productive_loss_usd_yr": null,
            "productive_loss_plausibility_flag": null,
            "total_downtime_cost_usd_yr": 268582,
            "source": "World Bank Enterprise Surveys (2023); ESMAP (2023); GIZ HERA (2019)"
        }
    },
    "section_3_technical_design": {
        "solar_sizing": {
            "pv_capacity_kw_dc": 1331.7,
            "inverter_ac_capacity_kw": 1109.8,
            "dc_ac_ratio": 1.2,
            "annual_pv_output_kwh_ac": 1779375,
            "direct_solar_consumed_kwh": 1281150,
            "solar_fraction_pct_sizing": 73.1,
            "note_solar_fraction": "This is the pre-BESS sizing estimate. dispatch_model.diesel_displacement_pct is the authoritative post-dispatch figure.",
            "curtailed_kwh_upper": 498225,
            "specific_yield_kwh_kwp": 1370,
            "thermal_derating_factor": 0.901,
            "system_pr": 0.78,
            "capex_usd_per_wp": 0.78,
            "pv_capex_usd": 1038732,
            "source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
            "source_yield": "PVGIS-SARAH2; Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
            "source_thermal": "King et al. (2004) NREL; IEC 61215:2021 §11.5",
            "source_capex": "NREL ATB 2024 Commercial PV + Africa logistics premium (Wood Mackenzie 2024)"
        },
        "bess_sizing": {
            "bess_usable_energy_kwh": 1200,
            "bess_nameplate_energy_kwh": 1568.6,
            "bess_power_kw": 784.3,
            "backup_hours_achieved": 6,
            "round_trip_efficiency_pct": 85,
            "depth_of_discharge_pct": 90,
            "daily_cycle_rate": 0.8,
            "pack_cost_usd": 282353,
            "bos_cost_usd": 94118,
            "bess_capex_usd": 376471,
            "effective_life_years": 12,
            "cycle_limited": true,
            "soh_degradation_curve": {
                "year_1": 98.3,
                "year_3": 95,
                "year_5": 91.7,
                "year_7": 88.3,
                "year_11": 81.6,
                "end_of_life_trigger": "80% SOH — replacement recommended"
            },
            "lcos_usd_per_mwh": 120,
            "lcos_benchmark_range": "USD 160–250/MWh for LFP (PNNL-33283; BloombergNEF 2024)",
            "source_sizing": "Neubauer & Simpson (2015) NREL/TP-5400-63162",
            "source_capex": "NREL ATB 2024 two-component formula; BloombergNEF BESS Survey 2024",
            "source_lcos": "Mongird et al. (2022) PNNL-33283 §5.1",
            "source_rte": "NREL ATB 2024 Storage — LFP round-trip efficiency",
            "source_soh": "Mongird et al. (2022) PNNL-33283 §4.2; CATL LFP datasheet"
        },
        "dispatch_model": {
            "annual_load_kwh": 1752000,
            "solar_direct_kwh": 1138800,
            "bess_charge_kwh": 245280,
            "bess_to_load_kwh": 208488,
            "generator_kwh": 404712,
            "curtailed_kwh": 395295,
            "solar_fraction_pct": 76.9,
            "diesel_displaced_kwh": 1347288,
            "diesel_displacement_pct": 76.9,
            "source": "Lambert et al. (2006) HOMER merit-order dispatch; IEEE Std 1562-2007"
        },
        "land_area": {
            "ground_mount_m2": 10654,
            "rooftop_m2": 7990,
            "ground_mount_ha": 1.07,
            "note": "Ground-mount includes inter-row spacing for 0°–30° latitude sites.",
            "source": "NREL Land-Use Requirements for Solar Power Plants (2013); Fraunhofer ISE 2024"
        },
        "generator_health": {
            "load_fraction": 0.75,
            "load_kw": 600,
            "wet_stack_risk": false,
            "warning": null,
            "source": "Cummins Power Generation Application Note (2002); GIZ HERA (2019) §4.3"
        },
        "thermal_derating": {
            "ambient_temp_c": 22,
            "derating_factor_applied": 0.901,
            "note": "Cell temp = ambient + 25°C (NOCT); Pmax coeff = -0.45%/°C"
        },
        "inverter_sizing": {
            "dc_ac_ratio": 1.2,
            "inverter_ac_kw": 1109.8,
            "pv_dc_kw": 1331.7,
            "note": "DC:AC 1.20 — NREL standard for utility-adjacent C&I"
        },
        "design_note": "All sizing is pre-feasibility. Commission a licensed electrical engineer (IEC 62548 / NEC 690) before procurement."
    },
    "section_4_financial_model": {
        "capex_breakdown": {
            "pv_capex_usd": 1038732,
            "bess_capex_usd": 376471,
            "contingency_10pct_usd": 141520,
            "total_capex_usd": 1556723
        },
        "tax_incentives": {
            "tax_benefit_yr1_usd": 420315,
            "net_capex_after_tax_usd": 1136408,
            "tax_note": "SA Income Tax Act §12B(1)(h) — solar PV not exceeding 1 MW. Nameplate 1000 kVA used as a proxy for generation capacity in kW (assumes power factor ~1.0 — confirm true kW rating before underwriting if this figure is within a few percent of the 1000 kVA / 1 MW threshold). Self-assessed allowance — no discretionary government approval required to claim, unlike Nigeria Pioneer Status or a Free Zone election. Trade-use requirement is satisfied by construction: this engine only models commercial/industrial load profiles, never residential. Ownership/instalment-credit-agreement and first-use conditions should still be confirmed with in-country counsel before underwriting — this figure assumes both are met. Reported value is the Year-1-present-value-equivalent of the 100% statutory schedule, not a flat rate."
        },
        "annual_economics": {
            "diesel_savings_yr1_usd": 590112,
            "om_yr1_usd": 23110,
            "insurance_yr1_usd": 7076,
            "net_cashflow_yr1_usd": 976757,
            "net_cashflow_yr1_note": "Includes the one-time Year-1 tax benefit addback (see tax_incentives.tax_benefit_yr1_usd above and financials.tax_benefit_treatment). This is why net_cashflow_yr1_usd is materially higher than diesel_savings_yr1_usd minus om/insurance alone."
        },
        "project_returns": {
            "npv_usd": 4986480,
            "irr_pct": 46.3,
            "simple_payback_years": 3,
            "lcoe_solar_bess": 0.0594,
            "diesel_allin": 0.438,
            "saving_per_kwh": 0.3786
        },
        "cashflow_schedule_25yr": [
            976757,
            570490,
            584891,
            599652,
            614785,
            630296,
            646197,
            662496,
            679204,
            696331,
            713888,
            731885,
            750333,
            769243,
            788627,
            808497,
            828866,
            849744,
            871146,
            893085,
            915572,
            938624,
            962253,
            986474,
            1011301
        ],
        "assumptions": {
            "discount_rate_pct": 10,
            "diesel_escalation_pct_yr": 3,
            "pv_degradation_pct_yr": 0.5,
            "project_life_yr": 25,
            "om_escalation_pct_yr": 2
        }
    },
    "section_5_debt_structuring": {
        "financing_structure": "non_recourse_project_finance_spv",
        "scope_note": "DSCR and covenant results assume non-recourse, SPV-style project finance. Not applicable as-is to corporate/balance-sheet-recourse financing, which is underwritten on consolidated financials and interest coverage, not isolated project CFADS.",
        "debt_fraction_pct": 70,
        "debt_amount_usd": 1089706,
        "equity_amount_usd": 467017,
        "loan_tenor_yr": 10,
        "interest_rate_pct": 12,
        "annual_debt_service_usd": 192861,
        "dscr_year_1": 5.06,
        "dscr_minimum": 2.96,
        "dscr_minimum_year": 2
    },
    "_note": "Response truncated for documentation purposes"
}
Pacote de Credor Bancável Relatório de Dados com 8 Seções — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28875/bankable+lender+package+8-section+report+data' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "country": "south_africa",
  "load_profile": "manufacturing",
  "avg_daily_load_kwh": 4800,
  "nameplate_kva": 1000,
  "load_fraction": 0.75,
  "target_diesel_displacement_pct": 75,
  "backup_hours_target": 6,
  "debt_fraction_pct": 70,
  "loan_tenor_yr": 10,
  "interest_rate_pct": 12.0
}'

    
Requisição
Modelo de desenvolvedor-vs-cliente em dual-mode para estruturas de Acordo de Compra de Energia zero-CAPEX: IRR do projeto do desenvolvedor a partir dos fluxos de caixa das tarifas, economias do cliente no ano 1 e a tarifa de PPA no ponto de equilíbrio resolvida por bisseção à WACC do desenvolvedor - para estruturar ofertas de EaaS em vez de vendas diretas de ativos
Endpoint ID: 28876
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28876/ppa+energy-as-a-service+deal+model
PARÂMETROS DE ENTRADA

Modelo de Acordo de Energia como Serviço PPA — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "access": "entitled",
    "ppa_analysis": {
        "ppa_tariff_usd_kwh": 0.09,
        "ppa_escalation_pct_yr": 1.5,
        "developer_wacc_pct": 12,
        "developer_irr_pct": 4.62,
        "developer_capex_usd": 729623,
        "developer_tax_benefit_yr1_usd": 0,
        "developer_npv_at_wacc_usd": -354260,
        "ppa_revenue_yr1_usd": 57501,
        "total_ppa_revenue_25yr_usd": 1728646,
        "customer_saving_yr1_usd": 96537,
        "customer_saving_yr1_pct_vs_diesel": 62.7,
        "total_customer_savings_25yr_usd": 3887463,
        "break_even_tariff_usd_kwh": 0.1537,
        "zero_capex_for_customer": true,
        "recommendation": "PPA preferred if customer WACC > developer WACC or customer has balance-sheet constraints. CAPEX preferred if customer has access to cheap capital and wants long-term asset ownership and all savings.",
        "source": "IFC (2023) Mobilizing Private Investment in Clean Energy Africa §3.2. CrossBoundary Energy EaaS model — 20-country, $707M portfolio (2025). SEIA (2024) Power Purchase Agreement framework. Kamoa Copper DRC: 222 MWp + 526 MWh BESS, EaaS structure, April 2025."
    },
    "capex_summary": {
        "viability": "strong",
        "headline": "Strong: 73% displacement, 5-yr payback, 21.3% IRR. LCOE $0.059/kWh replaces diesel at $0.241/kWh.",
        "pv_capacity_kw": 689.5,
        "bess_energy_kwh": 400,
        "diesel_displacement_pct": 72.9,
        "total_capex_usd": 729623,
        "npv_usd": 814913,
        "irr_pct": 21.3,
        "payback_years": 5,
        "dscr_lender_pass": true,
        "dscr_bankability_score": "STRONG",
        "lcoe_solar_bess_usd_kwh": 0.0586,
        "diesel_allin_usd_kwh": 0.2411,
        "co2_saved_tonnes_yr": 613,
        "carbon_net_revenue_yr_usd": 6620,
        "annual_savings_usd": 154038,
        "fx_risk_level": "HIGH"
    },
    "country_context": {
        "irradiance_kwh_m2_yr": 1850,
        "grid_availability_pct": 45,
        "diesel_price_usd_l": 0.55,
        "grid_tariff_usd_kwh": 0.035,
        "currency": "NGN",
        "ambient_temp_c": 32,
        "source_irradiance": "NASA POWER MERRA-2; Fraunhofer ISE PV Report 2024",
        "source_diesel": "GIZ HERA (2019); NNPC pump price 2024"
    },
    "note": "PPA/EaaS is the dominant structure for C&I solar in Africa. CrossBoundary's Kamoa Copper DRC deal (222 MWp + 526 MWh, April 2025) and their $707M portfolio across 20 countries are all EaaS. See IFC (2023) §3.2 for PPA structuring guidance."
}
Modelo de Acordo de Energia como Serviço PPA — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28876/ppa+energy-as-a-service+deal+model' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "country": "nigeria",
  "load_profile": "manufacturing",
  "avg_daily_load_kwh": 2400,
  "nameplate_kva": 500,
  "load_fraction": 0.75,
  "target_diesel_displacement_pct": 70,
  "backup_hours_target": 4,
  "ppa_tariff_usd_kwh": 0.09,
  "ppa_escalation_pct_yr": 1.5,
  "developer_wacc_pct": 12.0
}'

    
Requisição
Conservador Paralelo (rendimento P90, diesel -20%, CAPEX +15%) / Base / Execução de cenário otimista, retornando IRR/NPV/DSCR lado a lado e uma etiqueta padronizada de decisão de investimento (INVESTIR / PROSEGUIR COM CONDIÇÕES / MARGINAL / NÃO PROSEGUIR) - a tabela de comparação exata que um comitê de investimentos analisa antes de aprovar capital. Os resultados do DSCR em todos os três cenários assumem financiamento de projeto estilo SPV não recorrente
Endpoint ID: 28877
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28877/investment+committee+stress-test+matrix
PARÂMETROS DE ENTRADA

Matriz de Teste de Estresse do Comitê de Investimento — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "scenarios": {
        "conservative": {
            "label": "Conservative (P90 irradiance, diesel −20%, CAPEX +15%)",
            "irr_pct": 13.8,
            "npv_usd": 316770,
            "payback_years": 8,
            "total_capex_usd": 914659,
            "lcoe_usd_kwh": 0.0734,
            "annual_savings_usd": 128865,
            "dscr_year_1": 0.98,
            "dscr_minimum": 0.98,
            "dscr_minimum_year": 1,
            "dscr_bankability": "FAIL — DSCR below 1.3",
            "viability": "marginal",
            "irradiance_used": 1665,
            "diesel_price_used": 0.44
        },
        "base": {
            "label": "Base Case (P50 irradiance, current diesel price)",
            "irr_pct": 21.3,
            "npv_usd": 814913,
            "payback_years": 5,
            "total_capex_usd": 729623,
            "lcoe_usd_kwh": 0.0586,
            "annual_savings_usd": 154038,
            "dscr_year_1": 1.54,
            "dscr_minimum": 1.54,
            "dscr_minimum_year": 1,
            "dscr_bankability": "PASS",
            "viability": "strong",
            "irradiance_used": 1850,
            "diesel_price_used": 0.55
        },
        "optimistic": {
            "label": "Optimistic (irradiance +5%, diesel +20%, CAPEX −5%)",
            "irr_pct": 27.2,
            "npv_usd": 1166436,
            "payback_years": 4,
            "total_capex_usd": 666380,
            "lcoe_usd_kwh": 0.0535,
            "annual_savings_usd": 179146,
            "dscr_year_1": 2,
            "dscr_minimum": 2,
            "dscr_minimum_year": 1,
            "dscr_bankability": "PASS",
            "viability": "excellent",
            "irradiance_used": 1942,
            "diesel_price_used": 0.66
        }
    },
    "investment_decision": "MARGINAL — consider concessional debt (6–8%) or DFI credit enhancement.",
    "source": "IRENA (2023) Renewable Power Generation Costs §4.6 risk framework. IFC (2023) Mobilizing Private Investment §5 stress-test protocol. Arcadis (2025) sensitivity analysis methodology — 5MW solar PV plant. IEA PVPS Task 13 (2024) P90 definition: P90 ≈ P50 × 0.90 for Africa.",
    "api_version": "1.0.0",
    "access": "entitled"
}
Matriz de Teste de Estresse do Comitê de Investimento — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28877/investment+committee+stress-test+matrix' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "country": "nigeria",
  "load_profile": "manufacturing",
  "avg_daily_load_kwh": 2400,
  "nameplate_kva": 500,
  "load_fraction": 0.75,
  "target_diesel_displacement_pct": 70,
  "backup_hours_target": 4,
  "discount_rate_pct": 10,
  "debt_fraction_pct": 70,
  "loan_tenor_yr": 10,
  "interest_rate_pct": 12.0
}'

    
Requisição
Executa todos os 8 perfis de carga do setor contra um país em uma única chamada e os classifica por desempenho financeiro sinalizando a principal recomendação pelo TIR e taxa de aprovação do DSCR em financiamento de projetos (financiamento de projetos estilo SPV sem recurso) - para identificar qual vertente da indústria atacar primeiro em um novo mercado
Endpoint ID: 28878
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28878/sector+market+map+-+country+screen
PARÂMETROS DE ENTRADA

Mapa de Mercado do Setor - Tela do País — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "country": "Nigeria",
    "diesel_price_usd_l": 0.55,
    "grid_availability_pct": 45,
    "top_sector": "commercial_office",
    "top_sector_caveat": null,
    "irr_leader_sector": "commercial_office",
    "sectors_ranked_by_irr": [
        {
            "load_profile": "commercial_office",
            "description": "Office buildings — HVAC, lighting, computers",
            "solar_coincidence_pct": 80,
            "diesel_displacement_pct": 78,
            "pv_capacity_kw": 620.5,
            "bess_energy_kwh": 400,
            "total_capex_usd": 670465,
            "npv_usd": 1001826,
            "irr_pct": 24.9,
            "payback_years": 5,
            "annual_savings_usd": 164633,
            "co2_saved_tonnes_yr": 655.1,
            "lcoe_usd_kwh": 0.0504,
            "dscr_lender_pass": true,
            "viability": "strong"
        },
        {
            "load_profile": "agro_processing",
            "description": "Agricultural processing — milling, pumping, drying",
            "solar_coincidence_pct": 78,
            "diesel_displacement_pct": 75,
            "pv_capacity_kw": 636.5,
            "bess_energy_kwh": 400,
            "total_capex_usd": 684118,
            "npv_usd": 916151,
            "irr_pct": 23.4,
            "payback_years": 5,
            "annual_savings_usd": 158315,
            "co2_saved_tonnes_yr": 630,
            "lcoe_usd_kwh": 0.0534,
            "dscr_lender_pass": true,
            "viability": "strong"
        },
        {
            "load_profile": "manufacturing",
            "description": "Heavy industry — motors, compressors, process heat",
            "solar_coincidence_pct": 72,
            "diesel_displacement_pct": 72.9,
            "pv_capacity_kw": 689.5,
            "bess_energy_kwh": 400,
            "total_capex_usd": 729623,
            "npv_usd": 814913,
            "irr_pct": 21.3,
            "payback_years": 5,
            "annual_savings_usd": 154038,
            "co2_saved_tonnes_yr": 613,
            "lcoe_usd_kwh": 0.0586,
            "dscr_lender_pass": true,
            "viability": "strong"
        },
        {
            "load_profile": "retail_mall",
            "description": "Retail/mall — HVAC, lighting, escalators, refrigeration",
            "solar_coincidence_pct": 60,
            "diesel_displacement_pct": 72.9,
            "pv_capacity_kw": 827.4,
            "bess_energy_kwh": 720,
            "total_capex_usd": 958372,
            "npv_usd": 534764,
            "irr_pct": 15.9,
            "payback_years": 7,
            "annual_savings_usd": 153862,
            "co2_saved_tonnes_yr": 612.3,
            "lcoe_usd_kwh": 0.0772,
            "dscr_lender_pass": false,
            "viability": "equity_only"
        },
        {
            "load_profile": "cold_chain",
            "description": "Cold storage/refrigeration — near-constant baseload",
            "solar_coincidence_pct": 55,
            "diesel_displacement_pct": 64.7,
            "pv_capacity_kw": 902.6,
            "bess_energy_kwh": 540,
            "total_capex_usd": 960792,
            "npv_usd": 346492,
            "irr_pct": 13.9,
            "payback_years": 8,
            "annual_savings_usd": 136704,
            "co2_saved_tonnes_yr": 544,
            "lcoe_usd_kwh": 0.0869,
            "dscr_lender_pass": false,
            "viability": "marginal"
        },
        {
            "load_profile": "hospital",
            "description": "Healthcare facility — 24/7 critical load",
            "solar_coincidence_pct": 55,
            "diesel_displacement_pct": 65.8,
            "pv_capacity_kw": 902.6,
            "bess_energy_kwh": 720,
            "total_capex_usd": 1022909,
            "npv_usd": 295429,
            "irr_pct": 13.2,
            "payback_years": 8,
            "annual_savings_usd": 139078,
            "co2_saved_tonnes_yr": 553.4,
            "lcoe_usd_kwh": 0.0911,
            "dscr_lender_pass": false,
            "viability": "marginal"
        },
        {
            "load_profile": "telecoms_tower",
            "description": "Telecom base stations — near-constant 24/7 baseload",
            "solar_coincidence_pct": 50,
            "diesel_displacement_pct": 67,
            "pv_capacity_kw": 992.9,
            "bess_energy_kwh": 570,
            "total_capex_usd": 1048588,
            "npv_usd": 293042,
            "irr_pct": 13.1,
            "payback_years": 8,
            "annual_savings_usd": 141417,
            "co2_saved_tonnes_yr": 562.8,
            "lcoe_usd_kwh": 0.0917,
            "dscr_lender_pass": false,
            "viability": "marginal"
        },
        {
            "load_profile": "hotel",
            "description": "Hospitality — HVAC, kitchen, laundry, lighting",
            "solar_coincidence_pct": 55,
            "diesel_displacement_pct": 58.9,
            "pv_capacity_kw": 902.6,
            "bess_energy_kwh": 621.6,
            "total_capex_usd": 988952,
            "npv_usd": 175667,
            "irr_pct": 12,
            "payback_years": 9,
            "annual_savings_usd": 124334,
            "co2_saved_tonnes_yr": 494.8,
            "lcoe_usd_kwh": 0.0984,
            "dscr_lender_pass": false,
            "viability": "marginal"
        }
    ],
    "interpretation": "Sectors with high solar coincidence (manufacturing, commercial_office, agro_processing) perform best because PV output directly displaces load without BESS mediation. 24/7 loads (cold_chain, telecoms) require larger BESS to achieve the same displacement and typically need concessional debt terms to clear a 1.30x DSCR threshold.",
    "access": "entitled"
}
Mapa de Mercado do Setor - Tela do País — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28878/sector+market+map+-+country+screen' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "country": "nigeria",
  "avg_daily_load_kwh": 2400,
  "nameplate_kva": 500,
  "load_fraction": 0.75,
  "target_diesel_displacement_pct": 70,
  "backup_hours_target": 4
}'

    
Requisição
Compara o mesmo perfil de carga em 2–10 países lado a lado — referências de combustível risco de confiabilidade da rede incentivos fiscais soberanos volatilidade cambial — para desenvolvedores decidindo qual mercado nacional entrar primeiro
Endpoint ID: 28879
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28879/cross-border+investment+comparison
PARÂMETROS DE ENTRADA

Comparação de Investimento Transfronteiriço — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "success",
    "api_version": "1.0.0",
    "load_profile": "manufacturing",
    "avg_daily_load_kwh": 2400,
    "top_country": "South Africa",
    "top_country_irr": 50.7,
    "top_country_caveat": null,
    "irr_leader_country": "South Africa",
    "irr_leader_irr": 50.7,
    "countries_ranked_by_irr": [
        {
            "country": "South Africa",
            "country_code": "south_africa",
            "diesel_price_usd_l": 1.1,
            "irradiance_kwh_m2_yr": 1950,
            "grid_availability_pct": 65,
            "diesel_displacement_pct": 72.9,
            "pv_capacity_kw": 621.5,
            "bess_energy_kwh": 400,
            "total_capex_usd": 671255,
            "npv_usd": 2430915,
            "irr_pct": 50.7,
            "payback_years": 2,
            "annual_savings_usd": 279836,
            "co2_saved_tonnes_yr": 613,
            "lcoe_usd_kwh": 0.0539,
            "diesel_allin_usd_kwh": 0.438,
            "dscr_lender_pass": true,
            "fx_risk_level": "MEDIUM",
            "irr_fx_downside_pct": 46.5,
            "viability": "excellent"
        },
        {
            "country": "Kenya",
            "country_code": "kenya",
            "diesel_price_usd_l": 1.05,
            "irradiance_kwh_m2_yr": 1750,
            "grid_availability_pct": 80,
            "diesel_displacement_pct": 72.9,
            "pv_capacity_kw": 699.5,
            "bess_energy_kwh": 400,
            "total_capex_usd": 738188,
            "npv_usd": 2060731,
            "irr_pct": 36.7,
            "payback_years": 3,
            "annual_savings_usd": 268400,
            "co2_saved_tonnes_yr": 613,
            "lcoe_usd_kwh": 0.0592,
            "diesel_allin_usd_kwh": 0.4201,
            "dscr_lender_pass": true,
            "fx_risk_level": "MEDIUM",
            "irr_fx_downside_pct": 33.7,
            "viability": "excellent"
        },
        {
            "country": "Ghana",
            "country_code": "ghana",
            "diesel_price_usd_l": 0.95,
            "irradiance_kwh_m2_yr": 1800,
            "grid_availability_pct": 70,
            "diesel_displacement_pct": 72.9,
            "pv_capacity_kw": 697.6,
            "bess_energy_kwh": 400,
            "total_capex_usd": 736616,
            "npv_usd": 1811400,
            "irr_pct": 33.7,
            "payback_years": 4,
            "annual_savings_usd": 245528,
            "co2_saved_tonnes_yr": 613,
            "lcoe_usd_kwh": 0.0591,
            "diesel_allin_usd_kwh": 0.3843,
            "dscr_lender_pass": true,
            "fx_risk_level": "MEDIUM",
            "irr_fx_downside_pct": 28.3,
            "viability": "excellent"
        },
        {
            "country": "Nigeria",
            "country_code": "nigeria",
            "diesel_price_usd_l": 0.55,
            "irradiance_kwh_m2_yr": 1850,
            "grid_availability_pct": 45,
            "diesel_displacement_pct": 72.9,
            "pv_capacity_kw": 689.5,
            "bess_energy_kwh": 400,
            "total_capex_usd": 729623,
            "npv_usd": 814913,
            "irr_pct": 21.3,
            "payback_years": 5,
            "annual_savings_usd": 154038,
            "co2_saved_tonnes_yr": 613,
            "lcoe_usd_kwh": 0.0586,
            "diesel_allin_usd_kwh": 0.2411,
            "dscr_lender_pass": true,
            "fx_risk_level": "HIGH",
            "irr_fx_downside_pct": 10.1,
            "viability": "strong"
        }
    ],
    "key_insight": "IRR is primarily driven by diesel price (revenue driver) and grid availability (determines backup need). High diesel + low grid = strongest case. Check FX risk before committing — NGN/ETB volatility can erode returns.",
    "access": "unauthenticated"
}
Comparação de Investimento Transfronteiriço — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28879/cross-border+investment+comparison' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "countries": ["nigeria", "south_africa", "kenya", "ghana"],
  "load_profile": "manufacturing",
  "avg_daily_load_kwh": 2400,
  "nameplate_kva": 500,
  "load_fraction": 0.75,
  "target_diesel_displacement_pct": 70,
  "backup_hours_target": 4
}'

    
Requisição
Gera uma lista de verificação de pré-seleção de Padrões de Desempenho da IFC (PS1/PS2/PS3/PS6) - categoria do projeto (A/B), nível dos Princípios do Equador e lista de elegibilidade DFI - documentação necessária para qualquer banco dos Princípios do Equador ou credor afiliado à IFC
Endpoint ID: 28880
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28880/ifc+es+pre-screening+checklist
PARÂMETROS DE ENTRADA

Lista de Verificação de Pré-Triagem do IFC ES — Recursos do endpoint

Objeto Descrição
request_body Obrigatório
Corpo da requisição Obrigatório Json
country Obrigatório Country code to screen, e.g. nigeria
sector Obrigatório Sector/load profile to check, e.g. manufacturing
land_ha Opcional Estimated land area in hectares
has_bess Opcional Does the project include a BESS?

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

country
sector
land_ha
has_bess
RESPOSTA DE EXEMPLO DA API
JSON
{
    "ifc_category": "B",
    "category_rationale": "Category B — site-specific, largely reversible impacts. Land area 0.5 ha.",
    "equator_principles_category": "EP Category B",
    "total_requirements": 11,
    "checklist": [
        {
            "performance_standard": "PS1",
            "requirement": "Environmental and Social Management System (ESMS)",
            "trigger": "always",
            "guidance": "Document policies and procedures for identifying/managing E&S risks. ISO 14001 certification acceptable as ESMS. IFC PS1 §14.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS1",
            "requirement": "Environmental and Social Management Plan (ESMP)",
            "trigger": "always",
            "guidance": "Project-specific ESMP covering construction, operations, decommissioning. IFC PS1 §25.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS1",
            "requirement": "Stakeholder Engagement Plan (SEP)",
            "trigger": "always",
            "guidance": "Community consultation records required. IFC PS1 §25-33. Must document free, prior and informed consultation for affected communities.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS1",
            "requirement": "Project-level grievance mechanism",
            "trigger": "always",
            "guidance": "Accessible, transparent mechanism for affected communities. IFC PS1 §35.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS2",
            "requirement": "Occupational Health and Safety (OHS) plan",
            "trigger": "always",
            "guidance": "Construction and O&M phase OHS. IFC/World Bank Group EHS Guidelines for Solar PV apply.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS2",
            "requirement": "Workers accommodation plan",
            "trigger": "workers_gt_50",
            "guidance": "Required if > 50 construction workers on site simultaneously. IFC PS2 §23-24.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS2",
            "requirement": "Child and forced labour prohibition — supply chain",
            "trigger": "always",
            "guidance": "Solar panel supply chain due diligence. Polysilicon sourcing audit recommended given Xinjiang provenance concerns (UFLPA 2022). IFC PS2 §17.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS3",
            "requirement": "Waste management plan — end-of-life panel disposal",
            "trigger": "always",
            "guidance": "Solar panel disposal plan at end of 25-yr life. WEEE directive compliance where applicable. LFP BESS: lower hazard than NMC but containment plan required. IFC PS3 §13.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS3",
            "requirement": "BESS hazardous materials management plan",
            "trigger": "bess",
            "guidance": "LFP chemistry: lower thermal runaway risk, but spill and fire management plan required. IFC EHS Guidelines for Electric Power Transmission and Distribution.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS3",
            "requirement": "Construction waste management",
            "trigger": "always",
            "guidance": "Concrete, steel, cable waste management. Country-specific landfill regulations apply.",
            "status": "REQUIRED"
        },
        {
            "performance_standard": "PS6",
            "requirement": "Protected area proximity check",
            "trigger": "ground_any",
            "guidance": "Additional disclosure requirements if within 10 km of IUCN Category I-IV protected area. IFC PS6 §17 and Equator Principles IV Annex B.",
            "status": "REQUIRED"
        }
    ],
    "dfi_eligibility": [
        "AfDB SEFA",
        "REPP",
        "USAID DCA",
        "Proparco",
        "IFC",
        "FMO"
    ],
    "disclaimer": "This is a pre-screening checklist only. A licensed E&S consultant must conduct the full ESIA/ESMP. Country-specific regulations may impose additional requirements beyond IFC Performance Standards.",
    "source": "IFC Performance Standards on Environmental and Social Sustainability (2012). IFC Project 49569 Botswana Solar Phase 2 ESRS (2024) — Category B C&I solar precedent. World Bank Equator Principles IV (2020). AfDB Integrated Safeguards System Category 2 (2013).",
    "api_version": "1.0.0",
    "access": "unauthenticated"
}
Lista de Verificação de Pré-Triagem do IFC ES — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28880/ifc+es+pre-screening+checklist?country=nigeria§or=manufacturing&land_ha=0.5&has_bess=true' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw ''

    
Requisição
Converte coordenadas GPS em irradiância solar anual específica do local por meio de dados de satélite EU JRC PVGIS-SARAH3 corrigindo a superavaliação de até 20% que os conjuntos de dados médios genéricos do país produzem — insira o resultado no modelo de subscrição completo para dimensionamento preciso do local
Endpoint ID: 28881
POST https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28881/site-specific+solar+resource+assessment
PARÂMETROS DE ENTRADA

Avaliação de Recurso Solar Específica do Local — Recursos do endpoint

Objeto Descrição
Corpo da requisição Obrigatório Json

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

RESPOSTA DE EXEMPLO DA API
JSON
{
    "irradiance_kwh_m2_yr": null,
    "specific_yield_kwh_kwp_yr": 1409.9,
    "optimal_tilt_deg": 10,
    "optimal_azimuth_deg": 29,
    "pvgis_database": "PVGIS-SARAH3",
    "coverage_years": "2005–2020 (15-year mean)",
    "lat": 6.5244,
    "lon": 3.3792,
    "source": "EU JRC PVGIS-SARAH3. Huld et al. (2012) Solar Energy 86:1803-1815. Satellite: Meteosat Prime, ~3 km resolution, 15-year average. CrossBoundary (2021) irradiance bias report — site-specific data eliminates systematic +20% overstatement in country-average datasets.",
    "access": "unauthenticated"
}
Avaliação de Recurso Solar Específica do Local — TRECHOS DE CÓDIGO

curl --location --request POST 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28881/site-specific+solar+resource+assessment' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "lat": 6.5244,
  "lon": 3.3792
}'

    
Requisição
Dados de referência localizados por país — linha de base da irradiância solar, preços de combustível, classificação de confiabilidade da rede e regime de incentivo fiscal soberano — os dados de origem contra os quais cada cálculo é comparado
Endpoint ID: 28882
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28882/country+risk+and+incentive+data+sheet
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "countries": [
        {
            "country_code": "nigeria",
            "country_name": "Nigeria",
            "irradiance_kwh_m2_yr": 1850,
            "grid_availability_pct": 45,
            "diesel_price_usd_l": 0.55,
            "grid_tariff_usd_kwh": 0.035,
            "currency": "NGN",
            "fx_volatility_annual_pct": 28,
            "ambient_temp_avg_c": 32,
            "incentives": {
                "pioneer_status": true,
                "pioneer_status_years": 3,
                "pioneer_cit_rate": 0.3,
                "import_duty_solar": 0,
                "vat_rate": 0.075,
                "carbon_credit_eligible": true
            },
            "incentive_source": "NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023",
            "source_irradiance": "NASA POWER MERRA-2; Fraunhofer ISE PV Report 2024",
            "source_diesel": "GIZ HERA (2019); NNPC pump price 2024",
            "source_grid": "ESMAP 2023; World Bank Nigeria Power Sector Brief"
        },
        {
            "country_code": "south_africa",
            "country_name": "South Africa",
            "irradiance_kwh_m2_yr": 1950,
            "grid_availability_pct": 65,
            "diesel_price_usd_l": 1.1,
            "grid_tariff_usd_kwh": 0.135,
            "currency": "ZAR",
            "fx_volatility_annual_pct": 14,
            "ambient_temp_avg_c": 22,
            "incentives": {
                "section_12b": true,
                "corporate_tax_rate": 0.27,
                "vat_rate": 0.15,
                "carbon_credit_eligible": true
            },
            "incentive_source": "SA Income Tax Act §12B (Act 58 of 1962, amended 2023)",
            "source_irradiance": "PVGIS-SARAH2 (EU JRC); GeoSUN Africa atlas",
            "source_diesel": "SAPIA 2024",
            "source_grid": "Eskom load-shedding statistics 2024; CSIR energy report"
        },
        {
            "country_code": "kenya",
            "country_name": "Kenya",
            "irradiance_kwh_m2_yr": 1750,
            "grid_availability_pct": 80,
            "diesel_price_usd_l": 1.05,
            "grid_tariff_usd_kwh": 0.22,
            "currency": "KES",
            "fx_volatility_annual_pct": 10,
            "ambient_temp_avg_c": 24,
            "incentives": {
                "vat_exempt_solar": true,
                "import_duty_solar": 0,
                "corporate_tax_rate": 0.3,
                "vat_rate": 0.16,
                "net_metering": true,
                "carbon_credit_eligible": true
            },
            "incentive_source": "East African VAT Act (2013) Schedule 1; Kenya Energy Act 2019",
            "source_irradiance": "PVGIS-SARAH2; Kenya Meteorological Department",
            "source_diesel": "EPRA 2024",
            "source_grid": "ESMAP 2023; KPLC outage statistics"
        },
        {
            "country_code": "ghana",
            "country_name": "Ghana",
            "irradiance_kwh_m2_yr": 1800,
            "grid_availability_pct": 70,
            "diesel_price_usd_l": 0.95,
            "grid_tariff_usd_kwh": 0.18,
            "currency": "GHS",
            "fx_volatility_annual_pct": 18,
            "ambient_temp_avg_c": 29,
            "incentives": {
                "free_zone_exemption": true,
                "import_duty_solar": 0,
                "corporate_tax_rate": 0.25,
                "vat_rate": 0.125,
                "carbon_credit_eligible": true
            },
            "incentive_source": "GIPC Act 2013; Ghana RE Act 832 2011",
            "source_irradiance": "PVGIS-SARAH2; Ghana Energy Commission",
            "source_diesel": "NPA Ghana 2024",
            "source_grid": "ESMAP 2023; GRIDCo"
        },
        {
            "country_code": "egypt",
            "country_name": "Egypt",
            "irradiance_kwh_m2_yr": 2200,
            "grid_availability_pct": 88,
            "diesel_price_usd_l": 0.38,
            "grid_tariff_usd_kwh": 0.055,
            "currency": "EGP",
            "fx_volatility_annual_pct": 22,
            "ambient_temp_avg_c": 28,
            "incentives": {
                "free_zone_exemption": true,
                "import_duty_solar": 0.02,
                "corporate_tax_rate": 0.225,
                "vat_rate": 0.05,
                "net_metering": true,
                "carbon_credit_eligible": true
            },
            "incentive_source": "Egypt Investment Law 72/2017; NREA Net Metering Decree 2013; reduced 5% VAT rate on renewable energy equipment per Egyptian VAT Law amendments — verify current rate with in-country tax adviser before underwriting.",
            "source_irradiance": "PVGIS-SARAH2; NREA Egypt solar atlas",
            "source_diesel": "EGPC 2024",
            "source_grid": "ESMAP 2023; EETC annual report"
        },
        {
            "country_code": "tanzania",
            "country_name": "Tanzania",
            "irradiance_kwh_m2_yr": 1900,
            "grid_availability_pct": 50,
            "diesel_price_usd_l": 1.15,
            "grid_tariff_usd_kwh": 0.12,
            "currency": "TZS",
            "fx_volatility_annual_pct": 8,
            "ambient_temp_avg_c": 27,
            "incentives": {
                "corporate_tax_rate": 0.3,
                "vat_rate": 0.18,
                "vat_exempt_solar": true,
                "import_duty_solar": 0,
                "carbon_credit_eligible": true
            },
            "incentive_source": "Tanzania VAT Act Cap 148; Tanzania Energy Policy 2015",
            "source_irradiance": "PVGIS-SARAH2; Tanzania Meteorological Authority",
            "source_diesel": "EWURA 2024",
            "source_grid": "ESMAP 2023; TANESCO reliability statistics"
        },
        {
            "country_code": "ethiopia",
            "country_name": "Ethiopia",
            "irradiance_kwh_m2_yr": 1950,
            "grid_availability_pct": 55,
            "diesel_price_usd_l": 0.7,
            "grid_tariff_usd_kwh": 0.04,
            "currency": "ETB",
            "fx_volatility_annual_pct": 15,
            "ambient_temp_avg_c": 25,
            "incentives": {
                "investment_incentive": true,
                "import_duty_solar": 0,
                "corporate_tax_rate": 0.3,
                "vat_rate": 0.15,
                "carbon_credit_eligible": true
            },
            "incentive_source": "Ethiopia Investment Proclamation 1180/2020",
            "source_irradiance": "PVGIS-SARAH2; Ethiopian Meteorological Institute",
            "source_diesel": "Ethiopian Petroleum Supply Enterprise 2024",
            "source_grid": "ESMAP 2023; EEU statistics"
        },
        {
            "country_code": "zambia",
            "country_name": "Zambia",
            "irradiance_kwh_m2_yr": 1900,
            "grid_availability_pct": 50,
            "diesel_price_usd_l": 1.2,
            "grid_tariff_usd_kwh": 0.08,
            "currency": "ZMW",
            "fx_volatility_annual_pct": 20,
            "ambient_temp_avg_c": 25,
            "incentives": {
                "zda_registered": true,
                "import_duty_solar": 0,
                "corporate_tax_rate": 0.3,
                "vat_rate": 0.16,
                "carbon_credit_eligible": true
            },
            "incentive_source": "Zambia Mines and Minerals Development Act; ZDA Act 2006",
            "source_irradiance": "PVGIS-SARAH2; ZESCO solar resource data",
            "source_diesel": "ERB Zambia 2024",
            "source_grid": "ESMAP 2023; ZESCO load-shedding statistics"
        },
        {
            "country_code": "senegal",
            "country_name": "Senegal",
            "irradiance_kwh_m2_yr": 1900,
            "grid_availability_pct": 72,
            "diesel_price_usd_l": 1.25,
            "grid_tariff_usd_kwh": 0.19,
            "currency": "XOF",
            "fx_volatility_annual_pct": 4,
            "ambient_temp_avg_c": 30,
            "incentives": {
                "investment_code": true,
                "import_duty_solar": 0,
                "corporate_tax_rate": 0.3,
                "vat_rate": 0.18,
                "carbon_credit_eligible": true
            },
            "incentive_source": "Senegal Investment Code Law 2004-06; CRSE RE regulations",
            "source_irradiance": "PVGIS-SARAH2; ASER solar atlas Senegal",
            "source_diesel": "SENELEC / SAR pump price 2024",
            "source_grid": "ESMAP 2023; SENELEC outage data"
        },
        {
            "country_code": "morocco",
            "country_name": "Morocco",
            "irradiance_kwh_m2_yr": 2100,
            "grid_availability_pct": 92,
            "diesel_price_usd_l": 1.05,
            "grid_tariff_usd_kwh": 0.13,
            "currency": "MAD",
            "fx_volatility_annual_pct": 5,
            "ambient_temp_avg_c": 22,
            "incentives": {
                "investment_charter": true,
                "net_metering": true,
                "import_duty_solar": 0.025,
                "corporate_tax_rate": 0.28,
                "vat_rate": 0.2,
                "carbon_credit_eligible": true
            },
            "incentive_source": "Morocco Investment Charter 2022; Law 13-09 RE framework",
            "source_irradiance": "PVGIS-SARAH2; MASEN",
            "source_diesel": "ONHYM 2024",
            "source_grid": "ESMAP 2023; ONEE annual report"
        }
    ],
    "_note": "Response truncated for documentation purposes"
}
Ficha de Dados sobre Risco de País e Incentivos — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28882/country+risk+and+incentive+data+sheet' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Biblioteca de perfis de carga horária para todos os 8 setores suportados - curvas de coincidência solar, comportamento esperado de ciclagem de BESS e janelas de demanda de pico - para validação de entradas antes de executar uma análise completa
Endpoint ID: 28883
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28883/sector+load+profile+library
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "load_profiles": [
        {
            "profile_code": "manufacturing",
            "description": "Heavy industry — motors, compressors, process heat",
            "peak_window": "08:00-18:00",
            "load_factor": 0.75,
            "daily_peak_hours": 10,
            "daytime_fraction_pct": 65,
            "solar_coincidence_pct": 72,
            "bess_benefit_factor": 0.6,
            "bess_daily_cycles": 0.8,
            "source": "GIZ HERA (2019); RMI Unlocking C&I Solar Nigeria (2024)"
        },
        {
            "profile_code": "commercial_office",
            "description": "Office buildings — HVAC, lighting, computers",
            "peak_window": "09:00-17:00",
            "load_factor": 0.65,
            "daily_peak_hours": 9,
            "daytime_fraction_pct": 72,
            "solar_coincidence_pct": 80,
            "bess_benefit_factor": 0.4,
            "bess_daily_cycles": 0.6,
            "source": "ASHRAE 90.1-2022 commercial load profiles; GIZ HERA"
        },
        {
            "profile_code": "retail_mall",
            "description": "Retail/mall — HVAC, lighting, escalators, refrigeration",
            "peak_window": "10:00-22:00",
            "load_factor": 0.7,
            "daily_peak_hours": 14,
            "daytime_fraction_pct": 55,
            "solar_coincidence_pct": 60,
            "bess_benefit_factor": 0.75,
            "bess_daily_cycles": 1,
            "source": "GIZ HERA (2019); NREL Commercial Building Energy Database"
        },
        {
            "profile_code": "cold_chain",
            "description": "Cold storage/refrigeration — near-constant baseload",
            "peak_window": "00:00-24:00",
            "load_factor": 0.85,
            "daily_peak_hours": 24,
            "daytime_fraction_pct": 50,
            "solar_coincidence_pct": 55,
            "bess_benefit_factor": 0.9,
            "bess_daily_cycles": 1.1,
            "source": "IIR 2022; GIZ HERA"
        },
        {
            "profile_code": "telecoms_tower",
            "description": "Telecom base stations — near-constant 24/7 baseload",
            "peak_window": "00:00-24:00",
            "load_factor": 0.9,
            "daily_peak_hours": 24,
            "daytime_fraction_pct": 50,
            "solar_coincidence_pct": 50,
            "bess_benefit_factor": 0.95,
            "bess_daily_cycles": 1.2,
            "source": "GSMA Green Power for Mobile (2015); IHS Towers energy data"
        },
        {
            "profile_code": "hospital",
            "description": "Healthcare facility — 24/7 critical load",
            "peak_window": "06:00-22:00",
            "load_factor": 0.8,
            "daily_peak_hours": 24,
            "daytime_fraction_pct": 48,
            "solar_coincidence_pct": 55,
            "bess_benefit_factor": 1,
            "bess_daily_cycles": 1,
            "source": "WHO Health Facility Energy Standards; GIZ HERA"
        },
        {
            "profile_code": "hotel",
            "description": "Hospitality — HVAC, kitchen, laundry, lighting",
            "peak_window": "07:00-23:00",
            "load_factor": 0.6,
            "daily_peak_hours": 16,
            "daytime_fraction_pct": 45,
            "solar_coincidence_pct": 55,
            "bess_benefit_factor": 0.7,
            "bess_daily_cycles": 0.9,
            "source": "IFC Hotel Sustainability Baseline (2023); GIZ HERA"
        },
        {
            "profile_code": "agro_processing",
            "description": "Agricultural processing — milling, pumping, drying",
            "peak_window": "07:00-17:00",
            "load_factor": 0.7,
            "daily_peak_hours": 10,
            "daytime_fraction_pct": 70,
            "solar_coincidence_pct": 78,
            "bess_benefit_factor": 0.45,
            "bess_daily_cycles": 0.5,
            "source": "FAO Agro-Processing Energy Handbook (2021); GIZ HERA"
        }
    ],
    "interpretation": {
        "solar_coincidence_pct": "Fraction of solar output that coincides with load demand. Higher = more direct solar consumption, smaller BESS needed. Manufacturing (72%) is good; cold_chain (55%) is poor — needs more BESS.",
        "bess_benefit_factor": "How much BESS improves diesel displacement for this profile. 1.0 = critical (hospital, telecom); 0.4 = BESS adds little value.",
        "bess_daily_cycles": "Profile-specific daily cycle rate used to calculate BESS effective life and LCOS. Range 0.5 (agro-processing) to 1.2 (telecoms). Effective life = min(calendar=15yr, 3500 cycles / (cycles/day × 365))."
    },
    "source": "GIZ HERA (2019); GSMA Green Power for Mobile (2015); ASHRAE 90.1-2022; RMI Africa (2024)"
}
Biblioteca de Perfis de Carga do Setor — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28883/sector+load+profile+library' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Referências de CAPEX do sistema de base para sistemas fotovoltaicos, armazenamento em bateria e custos de integração de backup obtidas do NREL ATB para verificar os preços dos instaladores em relação às taxas de mercado
Endpoint ID: 28884
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28884/capex+benchmark+reference
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "pv_capex_usd_wdc": {
        "small_under_50kw": 1.05,
        "medium_50_500kw": 0.9,
        "large_500kw_5mw": 0.78,
        "utility_over_5mw": 0.68,
        "africa_premium_note": "20–30% premium over NREL ATB 2024 US baseline applied for: freight/import duties (~10%), local installation markup (~10%), contingency (~5–10%). Actual quotes vary by country and port logistics.",
        "source": "NREL ATB 2024 Commercial PV; Wood Mackenzie Africa Solar (2024)"
    },
    "bess_capex": {
        "pack_cost_usd_kwh": 180,
        "bos_cost_usd_kw": 120,
        "formula": "CAPEX = (pack_cost × nameplate_kWh) + (BOS_cost × power_kW)",
        "chemistry": "LFP (Lithium Iron Phosphate) — dominant Africa C&I 2024",
        "lcos_benchmark_usd_mwh": "USD 160–250/MWh (PNNL-33283; BloombergNEF 2024)",
        "cycle_note": "BESS effective life uses profile-specific daily cycle rate. Cold-chain and telecoms cycle faster, giving shorter life and higher LCOS.",
        "source": "NREL ATB 2024 Storage Appendix; BloombergNEF BESS Price Survey 2024; Mongird et al. (2022) PNNL-33283"
    },
    "generator_costs": {
        "maintenance_usd_kwh": 0.015,
        "replacement_usd_kva": 350,
        "life_hours": 20000,
        "minimum_load_pct": 30,
        "wet_stack_warning": "Load < 30% risks wet-stacking — unburnt fuel in exhaust (Cummins 2002)",
        "fuel_curve_standard": "ISO 8528-1:2005 §13",
        "source": "GIZ HERA (2019); ISO 8528-1:2005; Cummins Power Generation (2002)"
    },
    "contingency": {
        "construction_contingency_pct": 10,
        "annual_insurance_pct": 0.5,
        "note": "Both included in all /analyse/* CAPEX totals."
    }
}
Referência de Benchmark de CAPEX — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28884/capex+benchmark+reference' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Divulgação técnica completa de cada módulo de cálculo e seu padrão regulatório — lógica de despacho, curvas de degradação, metodologia DSCR, contabilidade de carbono — com citações de fontes primárias para equipes de due diligence auditando o modelo
Endpoint ID: 28885
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28885/engineering+and+financial+methodology+disclosure
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "title": "Diesel-to-Solar Hybrid Feasibility API — Engineering Methodology v1.0",
    "version": "1.0.0",
    "modules": [
        {
            "module": "1. Diesel Baseline",
            "method": "ISO 8528-1:2005 §13 two-term load curve: L/hr = 0.084 × P_rated_kW + 0.246 × P_load_kW. All-in cost = fuel + maintenance ($0.015/kWh) + replacement amortisation.",
            "sources": [
                "ISO 8528-1:2005 §13",
                "GIZ HERA (2019)",
                "Wood Mackenzie Africa (2022)"
            ]
        },
        {
            "module": "2. Solar Sizing",
            "method": "PV sized so that: solar_coincidence × PV_output / annual_load = target_fraction. Specific yield = PVGIS irradiance × PR=0.78 × thermal_derating_factor. Thermal derating: Pmax_coeff = -0.45%/°C; cell_temp = ambient + 25°C (NOCT). Inverter clipping modelled at DC:AC = 1.20.",
            "sources": [
                "Neubauer & Simpson (2015) NREL/TP-5400-63162 §3.2",
                "PVGIS-SARAH2 (EU JRC)",
                "Fraunhofer ISE PV Report 2024 (Africa PR=0.78)",
                "King et al. (2004) NREL Sandia PV model",
                "IEC 61215:2021 §11.5"
            ]
        },
        {
            "module": "3. BESS Sizing",
            "method": "Usable energy = max(backup_target, evening_load × bess_benefit_factor). Nameplate = usable / (DoD × RTE). CAPEX = (pack × nameplate_kWh) + (BOS × power_kW). Effective life = min(calendar_life=15yr, 3500_cycles / (profile_cycles_per_day × 365)). SOH degradation: linear 100% → 80% over effective life.",
            "sources": [
                "NREL ATB 2024 Storage Appendix",
                "Mongird et al. (2022) PNNL-33283 §5.1",
                "BloombergNEF BESS Price Survey 2024",
                "CATL LFP datasheet"
            ]
        },
        {
            "module": "4. Dispatch Model",
            "method": "HOMER-equivalent annual merit-order: (1) Solar AC → direct load (up to daytime load), (2) Surplus → BESS, (3) BESS → evening/night load, (4) Generator → balance. PV is sized accounting for sector solar coincidence; dispatch uses AC output directly.",
            "sources": [
                "Lambert et al. (2006) HOMER Energy LLC",
                "IEEE Std 1562-2007"
            ]
        },
        {
            "module": "5. Financial Model",
            "method": "25-yr NPV/IRR. Revenue = displaced_kWh × diesel_allin_cost. PV degrades 0.5%/yr. Diesel escalates 3%/yr. O&M 2%/yr. Insurance 0.5%/yr of asset. 10% construction contingency on CAPEX. LCOE = NPV(costs) / NPV(energy_delivered). IRR via bisection. O&M blended rate = weighted average (pv_frac × PV_OM + bess_frac × BESS_OM).",
            "sources": [
                "IRENA (2023) Renewable Power Generation Costs §4",
                "Jordan & Kurtz (2013) NREL/TP-5200-51664",
                "IEA Africa Energy Outlook (2023)",
                "IFC (2023) Mobilizing Private Investment in Clean Energy Africa"
            ]
        },
        {
            "module": "6. Tax Incentives",
            "method": "SA §12B: capacity-gated — 100% yr-1 depreciation × CIT 27% applies only to solar PV systems at or below 1 MW (nameplate_kva used as a kW proxy); systems above 1 MW, and all non-PV renewable technologies, follow the general §12B(2) 50%/30%/20% three-year schedule instead. Trade-use requirement satisfied by construction — this engine models commercial/industrial load profiles only, never residential. Self-assessed; no discretionary approval required to claim, unlike the two categories below. Nigeria NIPC: 3-yr income tax holiday on net profit (PV of tax savings) — requires pioneer_status_confirmed=true; not applied by default. Kenya: VAT exemption on solar equipment (70% of CAPEX). Ghana Free Zones: 10-yr CIT holiday on net profit — requires free_zone_registered=true; not applied by default. Egypt/Morocco/Zambia: 10-yr accelerated depreciation. Senegal/Ethiopia: investment code accelerated depreciation.",
            "sources": [
                "SA Income Tax Act §12B(1)(h) and §12B(2) (Act 58 of 1962, amended); SARS draft guide 'Allowances and deductions relating to assets used in the generation of electricity' (30 July 2024)",
                "NIPC Act Cap N117 LFN 2004; NIPC Pioneer Status Instrument 2023",
                "Kenya VAT Act Schedule 1 (East African VAT Act 2013)",
                "Ghana Free Zones Act 1995 (Act 504) §26; GIPC Act 2013",
                "Egypt Investment Law 72/2017; Morocco Investment Charter 2022"
            ]
        },
        {
            "module": "7. CO2 and Carbon Credits",
            "method": "Diesel saved (litres) = displaced_kWh × ISO 8528-1 fuel curve. CO2 = litres × 2.68 kgCO2/L (IPCC 2006). Carbon revenue = CO2_t × credit_price × (1 - broker_fee). VCS: $12/t; Gold Standard: $15/t; 10% brokerage.",
            "sources": [
                "IPCC 2006 Guidelines Vol 2 Ch1 Table 1.4",
                "EPA GHG Emission Factors Hub (2024)",
                "Verra VCS VM0038 v1.0 (2020)",
                "Gold Standard AMS-I.D. v18",
                "BeZero Carbon Africa pricing Q1 2024"
            ]
        },
        {
            "module": "8. DSCR Model",
            "method": "Debt Service Coverage Ratio = NOI / Annual_Debt_Service. Mortgage-style amortisation. Computed for each year over loan tenor. Minimum DSCR over tenor determines lender bankability (threshold: 1.30). Default terms: 70% LTV, 10-yr, 12% — IFC Africa C&I benchmark. SCOPE: models non-recourse, SPV-style project finance — debt sized and covenanted against isolated project CFADS. Not a corporate/balance-sheet-recourse lending model; corporate lenders underwrite against consolidated financials and credit rating, a different methodology this engine does not implement.",
            "sources": [
                "IFC (2023) Mobilizing Private Investment in Clean Energy Africa",
                "World Bank ESMAP project finance guidelines (2022)"
            ]
        },
        {
            "module": "9. Sensitivity Analysis",
            "method": "One-way sensitivity: diesel price (±20%, +40%), CAPEX (±10%, +20%), NPV at discount rates (8/10/12/15%). IRR is reported as constant across discount rate scenarios — it is a property of cashflows only, independent of discount rate. One variable moved at a time; all others at base.",
            "sources": [
                "IRENA (2023) risk framework",
                "IFC stress-test protocol (2023)"
            ]
        }
    ],
    "verification": {
        "diesel_cost": "Cross-check fuel consumption at ISO 8528-1 tables",
        "irradiance": "Cross-check at re.jrc.ec.europa.eu/pvg_tools (PVGIS)",
        "bess_lcos": "Compare to PNNL-33283 Fig. 4 — LFP range $160–250/MWh",
        "pv_capex": "Compare to NREL ATB 2024 atb.nrel.gov Commercial PV mid-case",
        "carbon_price": "Check BeZero Carbon Africa report or Xpansiv CBL spot market"
    },
    "disclaimer": "All outputs are pre-feasibility estimates for site screening, not engineered designs. Commission a licensed electrical engineer (IEC 62548 / NEC 690) and a registered financial adviser before procurement or investment commitment."
}
Divulgação de Metodologia de Engenharia e Finanças — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28885/engineering+and+financial+methodology+disclosure' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Histórico de versões do mecanismo de cálculo confirmando a compatibilidade reversa e documentando o que mudou em cada lançamento para integradores que acompanham a estabilidade da API ao longo do tempo
Endpoint ID: 28886
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28886/version+history+and+release+notes
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "api_version": "1.0.0",
    "release_note": "v1.0.0 initial release. The feature list below documents what the engine does and why, not a sequence of prior public releases — there is no earlier public API version this replaces.",
    "features": [
        {
            "id": "1",
            "area": "GPS → PVGIS-SARAH3 irradiance lookup",
            "endpoint": "POST /site/irradiance",
            "description": "Fetch site-specific annual irradiance from GPS lat/lon using EU JRC PVGIS-SARAH3 (15-year Meteosat satellite data, ~3 km resolution, 2005–2020). CrossBoundary (2021) found generic datasets overstate Africa irradiance by up to 20%, causing 1–2% IRR overstatement. This eliminates that bias. Source: Huld et al. (2012) Solar Energy 86:1803-1815."
        },
        {
            "id": "2",
            "area": "PPA / Energy-as-a-Service model",
            "endpoint": "POST /analyse/ppa",
            "description": "Dual-mode analysis: PPA (developer IRR from tariff cashflows) vs CAPEX ownership. Returns developer IRR, break-even tariff, customer savings vs diesel, 25-year PPA revenue. Template: CrossBoundary EaaS — $707M portfolio, 20 countries. Source: IFC (2023) §3.2; CrossBoundary portfolio data (2025)."
        },
        {
            "id": "3",
            "area": "Three-scenario investment analysis",
            "endpoint": "POST /analyse/scenarios",
            "description": "Conservative (P90 irradiance, diesel −20%, CAPEX +15%) / Base / Optimistic scenarios run in parallel. Returns side-by-side IRR/NPV/DSCR table and investment decision string (INVEST / PROCEED / MARGINAL / DO NOT PROCEED). Source: IRENA (2023) §4.6; IFC stress-test; Arcadis (2025); IEA PVPS Task 13 (2024)."
        },
        {
            "id": "4",
            "area": "IFC PS1 E&S pre-screening checklist",
            "endpoint": "GET /screen/es-checklist",
            "description": "Generates IFC Performance Standards PS1/PS2/PS3/PS6 checklist with IFC project category, Equator Principles category, DFI eligibility list. Required for any Equator Principles or IFC-affiliated DFI financing. Source: IFC PS (2012); IFC Project 49569 ESRS (2024); EP IV (2020)."
        },
        {
            "id": "5",
            "area": "DSCR covenant compliance table (all responses)",
            "description": "run_hybrid_analysis returns dscr.covenant_table — year-by-year DSCR across the loan tenor with IFC covenant flags (1.30 minimum, 1.20 lock-up, 1.05 default), bankability score, and distribution restriction flags. Assumes non-recourse, SPV-style project finance — see GET /reference/methodology, module 8, for scope. Source: GreenBridge Infrastructure (2025); IFC (2023) §4.3; ESMAP (2022) §6."
        },
        {
            "id": "6",
            "area": "Break-even & P90 fields in sensitivity (all responses)",
            "description": "sensitivity.breakeven is included in all /analyse/* responses: break-even diesel price, break-even CAPEX overrun %, P90 IRR, P90 NPV, grid tariff crossover. Source: IEA PVPS Task 13 (2024); IRENA (2023) §4.6; Arcadis (2025)."
        },
        {
            "id": "7",
            "area": "Discount rate sensitivity — NPV table",
            "description": "Discount rate sensitivity reports NPV at 8/10/12/15% alongside IRR. IRR is correctly shown as constant across the sweep — it is a cashflow property independent of discount rate; only NPV varies."
        },
        {
            "id": "8",
            "area": "Tax incentives — Ghana, Egypt, Morocco, Zambia",
            "description": "Ghana: Free Zones Act §26 model, 10-year CIT holiday on net profit for qualifying Free Zone Enterprise registrations only — zero automatic benefit outside a free zone. Egypt/Morocco/Zambia: investment charter / ZEMA 10-year accelerated depreciation. Source: Ghana Free Zones Act 1995 (Act 504) §26; GIPC Act 2013; Egypt Investment Law 72/2017; Morocco Investment Charter 2022; ZDA Act 2006."
        },
        {
            "id": "9",
            "area": "South Africa §12B — capacity-gated tax treatment",
            "description": "100% Year-1 write-off applies only to solar PV systems at or below 1 MW. Systems above 1 MW, and non-PV renewable technologies, use the general §12B(2) 50%/30%/20% three-year schedule instead — not a flat rate regardless of size. See GET /reference/methodology, module 6, for the statute citation and disclosed assumptions."
        }
    ],
    "engineering_methodology": "See GET /reference/methodology for the full citation list."
}
Histórico de Versões e Notas de Lançamento — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28886/version+history+and+release+notes' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna o status operacional da API o número da versão atual e a lista de países e setores atualmente suportados Use isso para confirmar que a API está acessível antes de enviar solicitações de análise ou para monitoramento de tempo de atividade
Endpoint ID: 28887
GET https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28887/system+status+and+health+monitor
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "ok",
    "api": "Diesel-to-Solar Hybrid Feasibility API",
    "version": "1.0.0",
    "ts": "2026-08-03T18:19:43Z",
    "keep_alive": {
        "last_ping_time": "2026-08-03 18:19:42 UTC",
        "last_ping_result": "ok_200",
        "consecutive_failures": 0
    },
    "countries_supported": 10,
    "sectors_supported": 8,
    "new_in_v3": [
        "POST /site/irradiance — GPS→PVGIS-SARAH3",
        "POST /analyse/ppa — PPA vs CAPEX dual mode",
        "POST /analyse/scenarios — 3-scenario IC table",
        "GET /screen/es-checklist — IFC PS1 E&S checklist",
        "dscr.covenant_table — year-by-year covenant flags in all responses",
        "sensitivity.breakeven — P90 IRR/NPV and break-even fields in all responses"
    ],
    "new_in_v3_1": [
        "structural_prescreen — BIPV mounting load pre-screen on every analysis response",
        "EN 1991-1-4:2005 wind pressure, dead load, ULS combinations, bracket pull-out",
        "Seismic, cyclone, high-wind, altitude flags per country",
        "Corner Zone F vs central Zone H bracket loads reported separately",
        "structural_overrides parameter on /analyse/quick and /analyse/full"
    ]
}
Estado do Sistema e Monitor de Saúde — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/13409/lender-ready+financial+modelling+api+for+hybrid+systems/28887/system+status+and+health+monitor' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a API de Modelagem Financeira Pronta para Credores para Sistemas Híbridos API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

🚀 Plano Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

API de grau de engenharia para viabilidade rápida de solar, bateria, híbrido a diesel, modelagem financeira e triagem de projetos prontos para credores nos mercados comerciais e industriais africanos

API de Modelagem Financeira Pronta para Credores para Sistemas Híbridos API FAQs

Cada ponto de extremidade retorna dados estruturados relacionados à viabilidade híbrida solar, incluindo métricas financeiras, reduções de emissões e avaliações de engenharia. Por exemplo, a Análise Rápida de Viabilidade Híbrida Solar retorna métricas como carga média diária, percentual de deslocamento de diesel e indicadores de desempenho financeiro como DSCR e IRR

Os campos chave incluem "status," "api_version," "input" (parâmetros do usuário), "country_context" (condições locais) e "diesel_baseline" (custos e consumo) Por exemplo, a Análise Híbrida de Grau Completo do Credor inclui detalhes de fluxo de caixa e métricas de investimento como NPV e anos de retorno

Os parâmetros variam conforme o ponto de extremidade, mas geralmente incluem "país", "perfil_de_carga", "carga_diária_média_kwh" e "percentagem_de_deslocamento_alvo". Os usuários podem personalizar as solicitações ajustando esses parâmetros para refletir requisitos específicos do projeto, como perfis de carga para diferentes indústrias

Os dados de resposta estão organizados em um formato JSON, com seções para parâmetros de entrada, contexto do país e resultados da análise. Cada seção é claramente rotulada, permitindo que os usuários localizem facilmente informações específicas, como métricas financeiras ou dados de impacto ambiental

As fontes de dados incluem organizações e estudos respeitáveis, como NASA POWER, GIZ HERA e NREL. A resposta de cada ponto final frequentemente cita essas fontes, garantindo transparência e confiabilidade nos dados utilizados para cálculos e avaliações

Casos de uso típicos incluem avaliações de viabilidade para projetos híbridos de energia solar, modelagem financeira para investidores e triagem de portfólio para desenvolvedores. Os usuários podem aproveitar os dados para avaliar a viabilidade do projeto, comparar diferentes locais ou estruturar Contratos de Compra de Energia

Os usuários podem analisar os dados retornados para tomar decisões informadas sobre investimentos em projetos avaliar a viabilidade financeira e identificar riscos potenciais Por exemplo entender o DSCR e o TIR pode ajudar a determinar a viabilidade bancária de um projeto antes de prosseguir com a engenharia detalhada

A precisão dos dados é mantida por meio do uso de metodologias e padrões estabelecidos, como diretrizes da ISO e fontes revisadas por pares. Atualizações regulares e verificações de qualidade garantem que os dados reflitam as condições atuais do mercado e os avanços tecnológicos

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas