{"openapi":"3.1.0","info":{"title":"Steam Boiler API","version":"1.0.0","description":"Steam-boiler engineering maths as an API, computed locally and deterministically — the three numbers a boiler operator, plant engineer or steam-system designer actually works with. The boiler-hp endpoint converts a required heat output into boiler horsepower (heat ÷ 33,475 BTU/hr, the standard definition), the equivalent steam output in pounds per hour \"from and at\" 212 °F (34.5 lb/hr per BHP) and the output in kilowatts — a 1,000,000 BTU/hr load is about 29.9 BHP or 1,031 lb/hr of steam. The factor-of-evaporation endpoint gives the real capacity for your feedwater: the factor = (the total heat of the steam − the feedwater heat) ÷ 970.3, always greater than one because the boiler must add the sensible heat to bring water up to boiling, so a boiler rated \"from and at\" 212 °F actually makes less with 60 °F feedwater — which is exactly why preheating feedwater with an economiser raises capacity and saves fuel. The blowdown endpoint gives the continuous blowdown rate to hold the boiler water within its dissolved-solids limit: blowdown = steam × feedwater TDS ÷ (boiler limit − feedwater TDS), with the cycles of concentration and the blowdown as a percentage of feedwater — better feedwater means more cycles, less blowdown and less wasted hot water. Everything is computed locally and deterministically, so it is instant and private. Ideal for boiler operators, steam-plant and HVAC engineers, energy auditors, water-treatment specialists and process-engineering tools. Pure local computation — no key, no third-party service, instant. Engineering estimates — verify against the manufacturer data and local code. 3 compute endpoints. For moist-air properties use a psychrometric API; for compressed air use a compressor API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/boiler-api","description":"oanor gateway"}],"tags":[{"name":"Boiler"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/blowdown":{"get":{"operationId":"get_v1_blowdown","tags":["Boiler"],"summary":"Continuous blowdown rate","description":"","parameters":[{"name":"steam_lb_hr","in":"query","required":true,"description":"Steam rate (lb/hr)","schema":{"type":"string"},"example":"1000"},{"name":"feedwater_tds_ppm","in":"query","required":true,"description":"Feedwater TDS (ppm)","schema":{"type":"string"},"example":"100"},{"name":"max_boiler_tds_ppm","in":"query","required":true,"description":"Boiler water TDS limit (ppm)","schema":{"type":"string"},"example":"3000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Steam leaves the dissolved solids behind, so they concentrate until blowdown removes them. At steady state blowdown = steam × feedwater TDS ÷ (boiler TDS limit − feedwater TDS); the cycles of concentration = boiler limit ÷ feedwater TDS. Too little blowdown scales and carries over; too much wastes hot water and treatment, so better feedwater (more cycles) cuts blowdown and fuel.","inputs":{"steam_lb_hr":1000,"feedwater_tds_ppm":100,"max_boiler_tds_ppm":3000},"blowdown_lb_hr":34.5,"feedwater_lb_hr":1034.5,"cycles_of_concentration":30,"blowdown_pct_of_feedwater":3.33},"meta":{"timestamp":"2026-06-06T23:53:55.838Z","request_id":"fd9c8108-d129-4774-8c07-da6a86f087e6"},"status":"ok","message":"Blowdown rate","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/boiler-hp":{"get":{"operationId":"get_v1_boiler_hp","tags":["Boiler"],"summary":"Boiler horsepower, steam output and kW","description":"","parameters":[{"name":"heat_btu_hr","in":"query","required":true,"description":"Required heat output (BTU/hr)","schema":{"type":"string"},"example":"1000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Boiler horsepower = heat output ÷ 33,475 BTU/hr, the standard definition. One BHP also equals 34.5 lb/hr of steam evaporated 'from and at' 212 °F — a convenient rating point. The steam figure here assumes that reference; with cooler feedwater the real output is lower (see /v1/factor-of-evaporation). Size for the connected load plus a margin for warm-up and losses.","inputs":{"heat_btu_hr":1000000},"boiler_hp":29.87,"output_kw":293.07,"steam_lb_hr_from_and_at_212":1030.6},"meta":{"timestamp":"2026-06-06T23:53:55.916Z","request_id":"6b175f49-5c57-4ef4-b6df-37efabd1acf0"},"status":"ok","message":"Boiler horsepower","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/factor-of-evaporation":{"get":{"operationId":"get_v1_factor_of_evaporation","tags":["Boiler"],"summary":"Factor of evaporation and real capacity","description":"","parameters":[{"name":"feedwater_temp_f","in":"query","required":true,"description":"Feedwater temperature (°F)","schema":{"type":"string"},"example":"60"},{"name":"from_and_at_lb_hr","in":"query","required":false,"description":"Rating \"from and at\" 212 °F (lb/hr)","schema":{"type":"string"},"example":"1000"},{"name":"steam_total_heat_btu_lb","in":"query","required":false,"description":"Steam total heat (BTU/lb, default 1150.4)","schema":{"type":"string"},"example":"1150.4"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The factor of evaporation = (total heat of the steam − the feedwater heat) ÷ 970.3. It is always ≥ 1 because real feedwater is below 212 °F, so the boiler must add the sensible heat too. Divide a 'from and at 212 °F' rating by this factor to get the real output at your feedwater temperature — which is why preheating feedwater (e.g. with an economiser) raises capacity and saves fuel.","inputs":{"feedwater_temp_f":60,"from_and_at_lb_hr":1000,"steam_total_heat_btu_lb":1150.4},"actual_output_lb_hr":864.5,"factor_of_evaporation":1.1568},"meta":{"timestamp":"2026-06-06T23:53:55.985Z","request_id":"c8faedc3-813c-4ad6-a3af-97d58c8bf992"},"status":"ok","message":"Factor of evaporation","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"US units. BHP = BTU/hr ÷ 33,475 (≙ 34.5 lb/hr from&at 212 °F); FE = (steam total heat − feedwater heat) ÷ 970.3; blowdown = steam × FW_TDS ÷ (boiler_TDS − FW_TDS). Estimates — for moist-air properties use a psychrometric API; for compressed air a compressor API.","service":"boiler-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/blowdown":"Continuous blowdown rate to hold the boiler water TDS.","GET /v1/boiler-hp":"Boiler horsepower, steam output and kW from a required heat output.","GET /v1/factor-of-evaporation":"Evaporation factor for the feedwater temperature, and the real capacity."},"description":"Steam-boiler maths: boiler horsepower, the factor of evaporation, and the blowdown rate to hold water quality."},"meta":{"timestamp":"2026-06-06T23:53:56.072Z","request_id":"1ef7ecaf-7588-43a2-a91e-f3af440cb893"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1450,"monthly_call_quota":52000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4250,"monthly_call_quota":221000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":13500,"monthly_call_quota":1180000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/boiler-api"}