APIs › Petroleum Engineering Calculators › Reservoir Volumetrics

Reservoir Volumetrics

Volumetric STOIIP or GIIP from area, thickness, porosity, saturation and formation volume factor, with optional P10/P50/P90 from supplied input uncertainty.

POST /v1/petroleum/reservoir-volumetrics $0.03 per call

Specification

Endpoint

POST /v1/petroleum/reservoir-volumetrics

Price

$0.03 per call · tier strategy_intelligence

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Published petroleum-engineering correlations, cited per endpoint

Timeout

15 seconds

Max request

64 KB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/petroleum/reservoir-volumetrics" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "fluid": "oil",
  "in_place_volume": 51612422.4,
  "in_place_unit": "STB",
  "recoverable_volume": 18064347.8,
  "recovery_factor": 0.35,
  "hydrocarbon_pore_volume": 64515528,
  "bulk_rock_volume_acre_ft": 54000,
  "inputs_used": {
    "area": 1200,
    "net_thickness": 45,
    "porosity": 0.22,
    "water_saturation": 0.3,
    "hydrocarbon_saturation": 0.7,
    "formation_volume_factor": 1.25
  },
  "formula": "STOIIP = 7758 × A(acres) × h(ft) × φ × (1−Sw) / Boi",
  "constants": {
    "acre_ft_to_bbl": 7758,
    "acre_ft_to_cf": 43560
  },
  "reference": "Dake, Fundamentals of Reservoir Engineering (1978), Ch. 2",
  "uncertainty": {
    "method": "one-at-a-time parameter perturbation at the supplied bounds. This is NOT a Monte Carlo simulation and the labels are indicative only — a genuine P10/P50/P90 requires distributions and correlation between parameters.",
    "p90_low": 44574364.8,
    "p50": 51612422.4,
    "p10_high": 58650480,
    "low_to_high_ratio": 1.316
  },
  "note": "Screening-level engineering result. It does not replace a commercial simulator, a laboratory PVT measurement, or review by a qualified engineer. A volumetric estimate is only as good as its net thickness, porosity and saturation inputs, which typically dominate the uncertainty."
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints