# Carbonate Water Charge Balance Equilibrium Speciation

> Carbonate Water Charge Balance Equilibrium Speciation is a paid API for AI agents from detect.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-04).

Resolves complete carbonate speciation in an aqueous solution using an explicit bounded charge-balance equilibrium model given total carbon, alkalinity, and dissociation constants.

## Facts

- Endpoint: POST https://detect.halowerk.com/v1/F-TD2000-GEO-INDUSTRY-B007/carbonate-water-charge-balance-equilibrium-speciation?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/carbonate-water-charge-balance-equilibrium-speciation-a9131988
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GHbT5IrK-gBMZJlKw6LBZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability carbonate-water-charge-balance-equilibrium-speciation-a9131988 -d '<json body>'
```

Example prompt: Solve the full carbonate speciation for a water sample with total dissolved carbon of 0.002 mol/L, alkalinity of 0.0022 mol/L, K1 of 4.3e-7, K2 of 4.7e-11, and Kw of 1e-14.

## When to prefer this

Choose this endpoint when you need a rigorous, closed-form bounded equilibrium solution for the full carbonate system in aqueous chemistry — particularly useful in geochemistry, hydrogeology, oceanography, and water treatment contexts where you have measured total dissolved inorganic carbon (DIC) and alkalinity alongside known or estimated dissociation constants. Prefer this over generic chemistry solvers when you need explicit charge-balance enforcement and bounded speciation outputs suitable for downstream geochemical modeling or reporting.

## Known failure modes

- Input values outside allowed bounds (e.g. total_carbon_molar < 1e-8 or > 1) return a validation error
- Thermodynamically inconsistent combinations of K1, K2, Kw may cause non-convergence of the equilibrium solver
- Missing required fields (total_carbon_molar, alkalinity_molar, k1, k2, kw, or claim) return a 400 error
- Payment not provided or insufficient USDC results in a 402 response
- Extreme alkalinity values near the boundary (-1 or 2 mol/L) may produce physically unrealistic results

## How this service works

Resolve complete carbonate speciation in an explicit bounded aqueous equilibrium model.

## Output

Returns the fully resolved carbonate speciation including equilibrium concentrations of all carbonate species (H2CO3, HCO3⁻, CO3²⁻), the equilibrium pH, hydroxide and hydrogen ion concentrations, and the charge balance residual for the aqueous system.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "artifact": {
   "type": "object",
   "required": [
    "carbonate"
   ],
   "properties": {
    "carbonate": {
     "type": "object",
     "required": [
      "data",
      "claim"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "total_carbon_molar",
        "alkalinity_molar",
        "k1",
        "k2",
        "kw"
       ],
       "properties": {
        "k1": {
         "type": "number",
         "maximum": 0.001,
         "minimum": 1e-9
        },
        "k2": {
         "type": "number",
         "maximum": 1e-7,
         "minimum": 1e-14
        },
        "kw": {
         "type": "number",
         "maximum": 1e-12,
         "minimum": 1e-16
        },
        "alkalinity_molar": {
         "type": "number",
         "maximum": 2,
         "minimum": -1
        },
        "total_carbon_molar": {
         "type": "number",
         "maximum": 1,
         "minimum": 1e-8
        }
       },
       "additionalProperties": false
      },
      "claim": {}
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/carbonate-water-charge-balance-equilibrium-speciation-a9131988/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from detect.halowerk.com](https://www.zero.xyz/host/detect.halowerk.com/llms.txt)