HALOWERK Baltic Land · EE Soil Nitrogen

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://baltikum.halowerk.com/v1/ee-soil-nitrogen", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "latitude": 59.437,
    "longitude": 24.7536
  }),
});
const data = await res.json();

curl -X POST \
  "https://baltikum.halowerk.com/v1/ee-soil-nitrogen" \
  -H "Content-Type: application/json" \
  -d '{"latitude":59.437,"longitude":24.7536}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "authoritative_status": "preliminary_non_binding",
  "category": "country",
  "caveats": [
    "Preliminary geodata assessment; not a legally binding property, cadastral, planning, environmental or title search.",
    "Raster resolution and model uncertainty can be larger than the submitted site geometry.",
    "Material decisions require a current verification by the competent national or regional authority."
  ],
  "charged": true,
  "checked_at": "2026-09-03T00:00:00.000Z",
  "confidence": 0.73,
  "confidence_method": "Conservative minimum source-family baseline plus a bounded sample-count bonus; multi-source results receive a fixed integration penalty.",
  "data_date": "2020-05-01T00:00:00.000Z",
  "evidence": {
    "soil-nitrogen": {
      "method": "documented source raster sample",
      "metric": "soil-nitrogen",
      "name": "Topsoil nitrogen",
      "sample_count": 1,
      "unit": "g_per_kg",
      "value": 1
    }
  },
  "evidence_classification": "derived_from_open_geodata",
  "facts": {
    "measurements": {
      "soil-nitrogen": {
        "method": "documented source raster sample",
        "metric": "soil-nitrogen",
        "name": "Topsoil nitrogen",
        "sample_count": 1,
        "unit": "g_per_kg",
        "value": 1
      }
    }
  },
  "generated_at": "2026-09-03T00:00:00.000Z",
  "geometry": null,
  "limitations": [
    "Preliminary geodata assessment; not a legally binding property, cadastral, planning, environmental or title search.",
    "Raster resolution and model uncertainty can be larger than the submitted site geometry.",
    "Material decisions require a current verification by the competent national or regional authority."
  ],
  "payment": {
    "price_usdc": 0.001,
    "settled": true
  },
  "recommended_next_steps": [
    "Verify material findings with current cadastral, planning and environmental records from the competent authority.",
    "Commission a qualified on-site survey where parcel-scale conditions affect the decision."
  ],
  "result": "measurement_available",
  "risk_level": "not_applicable",
  "service": "ee-soil-nitrogen",
  "service_id": "eli-0142",
  "sources": [
    {
      "access_documentation": "https://docs.isric.org/globaldata/soilgrids/wcs.html",
      "attribution": "SoilGrids data © ISRIC — World Soil Information, licensed under CC BY 4.0.",
      "authority": "ISRIC — World Soil Information",
      "cache_policy": "Fixed 0.25 degree WCS tiles cached locally; source TIFFs remain attributable CC BY data.",
      "caveats": [
        "Modelled predictions, not a site survey or laboratory result.",
        "WCS is used; the paused beta REST API is not used.",
        "Local variability below 250 m is not resolved."
      ],
      "commercial_use": true,
      "commercial_use_allowed": true,
      "coverage": "Global modelled soil predictions; valid cells are checked for each submitted geometry.",
      "data_date": "2020-05-01T00:00:00.000Z",
      "data_period": "SoilGrids 2.0 release vintage; not a live soil survey.",
      "dataset": "SoilGrids 2.0 WCS",
      "freshness": "Pinned SoilGrids 2.0 mean layers at 0-5 cm.",
      "id": "soilgrids-2-wcs",
      "license": "CC BY 4.0",
      "license_status": "verified",
      "license_verified_at": "2026-09-03",
      "name": "SoilGrids 2.0 WCS",
      "provider": "ISRIC — World Soil Information",
      "purpose": "Topsoil property estimates and derived USDA texture class.",
      "rate_limit": "QA and cache warming are throttled to at most one new WCS tile request per 12.5 seconds.",
      "redistribution": true,
      "resolution": "250 metres",
      "retrieved_at": "2026-09-03T00:00:00.000Z",
      "source_url": "https://maps.isric.org/",
      "terms_url": "https://docs.isric.org/globaldata/soilgrids/SoilGrids_faqs_04.html",
      "update_interval": "Provider model release based.",
      "url": "https://maps.isric.org/",
      "version": "SoilGrids 2.0 mean, 0-5 cm"
    }
  ],
  "status": "success",
  "summary": "Estonia: Topsoil nitrogen: source-backed screening evidence was calculated successfully."
}