Metadata-Version: 2.5
Name: stanzaapi-cbam-carbon
Version: 1.0.0
Summary: Official zero-dependency, high-speed Python client for EU CBAM & Carbon Tax Calculation Engine
Project-URL: Homepage, https://stanzaapi.com/tools/cbam-carbon
Project-URL: Repository, https://github.com/StanzaAPI/cbam-carbon-python
Author: Stanza
License-Expression: MIT
Keywords: carbon-border-tax,carbon-tax,cbam,customs-compliance,embedded-emissions,eu-ets,regulation-2023-956,scope-1,scope-2
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# EU CBAM & Carbon Tax Calculation Engine — Python SDK

[![PyPI version](https://img.shields.io/pypi/v/stanzaapi-cbam-carbon.svg)](https://pypi.org/project/stanzaapi-cbam-carbon/)
[![Python Versions](https://img.shields.io/pypi/pyversions/stanzaapi-cbam-carbon.svg)](https://pypi.org/project/stanzaapi-cbam-carbon/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Stanza API](https://img.shields.io/badge/Powered%20by-Stanza-blue)](https://stanzaapi.com)

> EU CBAM Scope 1/2 embedded emissions and EU ETS carbon tax liability calculator across Iron, Steel, Aluminum, Cement, Fertilizers, and Hydrogen.

Official, zero-dependency Python 3.8+ client library for **EU CBAM & Carbon Tax Calculation Engine**, built on the [Stanza Micro-API Network](https://stanzaapi.com). Intended for enterprise data pipelines, backend verification, and sub-5ms edge compute.

* 🌐 **Live Web Playground:** [Test your inputs online](https://stanzaapi.com/tools/cbam-carbon)
* 📚 **API Documentation:** [View full schema on Stanza](https://stanzaapi.com/tools/cbam-carbon)
* ⚡ **Platform Overview:** [Explore the Stanza Developer Network](https://stanzaapi.com)

---

## 📦 Installation

```bash
pip install stanzaapi-cbam-carbon
```

---

## 🚀 Quickstart

```python
import os
from stanzaapi_cbam_carbon import CbamCarbonClient

# Initialize client (api_key optional for local evaluation)
client = CbamCarbonClient(
    api_key=os.getenv("STANZA_API_KEY")
)

# Execute deterministic validation
response = client.parse({"goods_category":"iron_and_steel","production_country":"TR","quantity_tonnes":500})

if response.get("success"):
    print("Verification Success:", response["data"])
else:
    print("Validation Error:", response.get("error"), response.get("code"))
```

---

## 📄 Example Response

```json
{
  "success": true,
  "data": {
    "goods_category": "iron_and_steel",
    "direct_emissions_tco2e": 950,
    "estimated_ets_liability_eur": 71250
  }
}
```

---

## ⚙️ Client Options

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `api_key` | `Optional[str]` | `os.getenv("STANZA_API_KEY")` | Your [Stanza API Key](https://stanzaapi.com). Required for production quotas. |
| `base_url` | `Optional[str]` | `"https://api.stanzaapi.com/cbam-carbon"` | Public edge API base URL. |
| `timeout` | `int` | `15` | Request timeout in seconds. |


---

## 🔗 Useful Links

* [EU CBAM & Carbon Tax Calculation Engine Interactive Sandbox](https://stanzaapi.com/tools/cbam-carbon)
* [Stanza Developer Directory](https://stanzaapi.com)
* [Source Code & Issue Tracker](https://github.com/StanzaAPI/cbam-carbon-python)

## 📄 License

MIT © Stanza — Powered by [Stanza](https://stanzaapi.com).
