{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"pool-volume"},"result":{"entity_type":"calculator","id":"pool-volume","calculator_id":"pool-volume","canonical_url":"https://tttkmbb.com/everyday/pool-volume","name":"Pool Volume Calculator","title":"Swimming Pool Volume Calculator – Gallons and Litres by Shape, Chlorine Dose and Pump Turnover Time","category":"everyday","category_name":"Everyday Life","tool_name":"calculate_pool_volume","featured_mcp_tool":false,"description":"Computes the water volume of a rectangular, round, oval or kidney-shaped pool from its dimensions and average depth, then the amount of a chlorine product needed to raise free chlorine by a target ppm and the pump turnover time (or the flow needed for an 8-hour turnover).","use_when":"You need a pool's volume in gallons or litres to dose chemicals, size a pump or filter, or estimate fill cost, and a shock/chlorine dose for a given ppm increase.","do_not_use_when":"The pool is a free-form shape that none of the four templates approximates (measure it as several rectangles), or you need aquarium volumes (use aquarium-volume).","inputs":[{"name":"shape","label":"Pool shape","type":"enum","required":false,"default":"rectangle","values":[{"value":"rectangle","label":"Rectangle / square","aliases":["rectangular","square"]},{"value":"round","label":"Round (width = diameter)","aliases":["circle","circular"]},{"value":"oval","label":"Oval (ellipse)","aliases":["ellipse"]},{"value":"kidney","label":"Kidney (two lobe widths)","aliases":["freeform"]}],"description":"Plan-view shape used for the volume formula.","example":"rectangle"},{"name":"unit","label":"Length unit","type":"enum","required":false,"default":"m","values":[{"value":"m","label":"metres (flow in L/min)","aliases":["meters","metres","metric"]},{"value":"ft","label":"feet (flow in US gal/min)","aliases":["feet","foot","imperial"]}],"description":"Unit of all dimensions; also sets the pump flow unit.","example":"m"},{"name":"length","label":"Length","type":"number","required":false,"max":1000,"exclusive_min":0,"description":"Longest dimension. Not used for round pools.","example":10},{"name":"width","label":"Width","type":"number","required":true,"max":1000,"exclusive_min":0,"description":"Width; the diameter for round pools; the wider lobe (A) for kidney pools.","example":5},{"name":"width_2","label":"Second width (kidney)","type":"number","required":false,"max":1000,"exclusive_min":0,"description":"Width of the narrower lobe (B) of a kidney pool; ignored for other shapes.","example":3},{"name":"shallow_depth","label":"Shallow-end depth","type":"number","required":true,"max":20,"exclusive_min":0,"description":"Water depth at the shallow end (or the uniform depth).","example":1.2},{"name":"deep_depth","label":"Deep-end depth","type":"number","required":false,"max":20,"exclusive_min":0,"description":"Water depth at the deep end; omit for a flat bottom.","example":1.8},{"name":"chlorine_increase_ppm","label":"Free chlorine increase","type":"number","unit":"ppm","required":false,"default":10,"min":0,"max":50,"description":"Desired rise in free chlorine in mg/L: 10 ppm is a typical shock, 1–3 ppm a routine top-up.","example":10},{"name":"chlorine_product","label":"Chlorine product","type":"enum","required":false,"default":"calcium_hypochlorite_65","values":[{"value":"calcium_hypochlorite_65","label":"Calcium hypochlorite granules, 65% available chlorine","aliases":["cal hypo","cal-hypo","shock"]},{"value":"dichlor_56","label":"Dichlor granules, 56%","aliases":["dichlor"]},{"value":"trichlor_90","label":"Trichlor tablets, 90%","aliases":["trichlor"]},{"value":"liquid_chlorine_12_5","label":"Liquid chlorine (sodium hypochlorite) 12.5%","aliases":["liquid","sodium hypochlorite","bleach 12.5"]}],"description":"Product whose dose is reported (grams for granules and tablets, millilitres for liquid).","example":"calcium_hypochlorite_65"},{"name":"pump_flow","label":"Pump flow rate","type":"number","required":false,"max":100000,"exclusive_min":0,"description":"Pump flow in L/min (metres) or US gal/min (feet); optional, gives the turnover time.","example":200}],"outputs":[{"name":"average_depth","label":"Average depth","type":"number","decimals":3,"description":"(shallow_depth + deep_depth) / 2 in the chosen unit."},{"name":"volume_liters","label":"Volume","type":"number","unit":"L","decimals":0,"description":"Water volume in litres."},{"name":"volume_gallons_us","label":"Volume","type":"number","unit":"US gal","decimals":0,"description":"Water volume in US gallons."},{"name":"volume_m3","label":"Volume","type":"number","unit":"m³","decimals":2,"description":"Water volume in cubic metres (= tonnes of water)."},{"name":"chlorine_needed_g","label":"Available chlorine needed","type":"number","unit":"g","decimals":1,"description":"Pure chlorine to add: litres × ppm / 1000."},{"name":"product_dose","label":"Product dose","type":"number","decimals":0,"description":"Amount of the chosen product (see product_dose_unit)."},{"name":"product_dose_unit","label":"Dose unit","type":"string","decimals":4,"description":"g for granules/tablets, mL for liquid chlorine."},{"name":"turnover_hours","label":"Turnover time","type":"number","unit":"h","decimals":2,"description":"Hours for the pump to move one pool volume (only when pump_flow is given)."},{"name":"flow_for_8h_turnover_lpm","label":"Flow for 8 h turnover","type":"number","unit":"L/min","decimals":1,"description":"Pump flow that turns the pool over in 8 hours."},{"name":"flow_for_8h_turnover_gpm","label":"Flow for 8 h turnover","type":"number","unit":"US gal/min","decimals":1,"description":"Same flow in US gallons per minute."}],"input_schema":{"type":"object","properties":{"shape":{"description":"Plan-view shape used for the volume formula.","type":"string","enum":["rectangle","round","oval","kidney"],"default":"rectangle","examples":["rectangle"]},"unit":{"description":"Unit of all dimensions; also sets the pump flow unit.","type":"string","enum":["m","ft"],"default":"m","examples":["m"]},"length":{"description":"Longest dimension. Not used for round pools.","type":"number","maximum":1000,"exclusiveMinimum":0,"examples":[10]},"width":{"description":"Width; the diameter for round pools; the wider lobe (A) for kidney pools.","type":"number","maximum":1000,"exclusiveMinimum":0,"examples":[5]},"width_2":{"description":"Width of the narrower lobe (B) of a kidney pool; ignored for other shapes.","type":"number","maximum":1000,"exclusiveMinimum":0,"examples":[3]},"shallow_depth":{"description":"Water depth at the shallow end (or the uniform depth).","type":"number","maximum":20,"exclusiveMinimum":0,"examples":[1.2]},"deep_depth":{"description":"Water depth at the deep end; omit for a flat bottom.","type":"number","maximum":20,"exclusiveMinimum":0,"examples":[1.8]},"chlorine_increase_ppm":{"description":"Desired rise in free chlorine in mg/L: 10 ppm is a typical shock, 1–3 ppm a routine top-up. Unit: ppm.","type":"number","minimum":0,"maximum":50,"default":10,"examples":[10],"x-unit":"ppm"},"chlorine_product":{"description":"Product whose dose is reported (grams for granules and tablets, millilitres for liquid).","type":"string","enum":["calcium_hypochlorite_65","dichlor_56","trichlor_90","liquid_chlorine_12_5"],"default":"calcium_hypochlorite_65","examples":["calcium_hypochlorite_65"]},"pump_flow":{"description":"Pump flow in L/min (metres) or US gal/min (feet); optional, gives the turnover time.","type":"number","maximum":100000,"exclusiveMinimum":0,"examples":[200]}},"additionalProperties":false,"required":["width","shallow_depth"]},"output_schema":{"type":"object","properties":{"average_depth":{"description":"(shallow_depth + deep_depth) / 2 in the chosen unit.","type":"number"},"volume_liters":{"description":"Water volume in litres. Unit: L.","type":"number","x-unit":"L"},"volume_gallons_us":{"description":"Water volume in US gallons. Unit: US gal.","type":"number","x-unit":"US gal"},"volume_m3":{"description":"Water volume in cubic metres (= tonnes of water). Unit: m³.","type":"number","x-unit":"m³"},"chlorine_needed_g":{"description":"Pure chlorine to add: litres × ppm / 1000. Unit: g.","type":"number","x-unit":"g"},"product_dose":{"description":"Amount of the chosen product (see product_dose_unit).","type":"number"},"product_dose_unit":{"description":"g for granules/tablets, mL for liquid chlorine.","type":"string"},"turnover_hours":{"description":"Hours for the pump to move one pool volume (only when pump_flow is given). Unit: h.","type":"number","x-unit":"h"},"flow_for_8h_turnover_lpm":{"description":"Pump flow that turns the pool over in 8 hours. Unit: L/min.","type":"number","x-unit":"L/min"},"flow_for_8h_turnover_gpm":{"description":"Same flow in US gallons per minute. Unit: US gal/min.","type":"number","x-unit":"US gal/min"}}},"formula":"avg_depth = (shallow + deep) / 2; rectangle V = length × width × avg_depth; round V = π × (width / 2)² × avg_depth; oval V = π / 4 × length × width × avg_depth; kidney V = 0.45 × (width + width_2) × length × avg_depth; 1 ft³ = 28.3168 L = 7.4805 US gal; chlorine_g = litres × ppm / 1000; product = chlorine_g / available fraction (0.65, 0.56, 0.90; liquid 12.5% = 125 g/L → mL = chlorine_g / 0.125); turnover_h = volume / (pump_flow × 60)","method":"Shape formulas are the pool-industry templates (kidney = 0.45 × sum of lobe widths × length). 1 ppm equals 1 mg of chlorine per litre, so the dose scales with volume; the free-chlorine target after shocking is normally 10 ppm and routine levels 1–3 ppm. Health codes require public pools to turn over within 6 hours; one turnover in 8–12 hours is typical for residential pools.","sources":[{"name":"Leslie's – How to calculate pool volume (shape formulas)","url":"https://lesliespool.com/blog/calculating-pool-volume.html","type":"reference","retrieved_at":"2026-09-24"},{"name":"Swimming pool sanitation – chlorine levels and filtration turnover (Wikipedia)","url":"https://en.wikipedia.org/wiki/Swimming_pool_sanitation","type":"reference","retrieved_at":"2026-09-24"},{"name":"Calcium hypochlorite – 65–70% available chlorine (Wikipedia)","url":"https://en.wikipedia.org/wiki/Calcium_hypochlorite","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"10 × 5 m rectangle, 1.2–1.8 m deep, 200 L/min pump","inputs":{"shape":"rectangle","unit":"m","length":10,"width":5,"shallow_depth":1.2,"deep_depth":1.8,"chlorine_increase_ppm":10,"pump_flow":200},"expected":{"average_depth":1.5,"volume_liters":75000,"volume_gallons_us":19813,"volume_m3":75,"chlorine_needed_g":750,"product_dose":1154,"product_dose_unit":"g","turnover_hours":6.25,"flow_for_8h_turnover_lpm":156.3,"flow_for_8h_turnover_gpm":41.3},"url":"https://tttkmbb.com/api/v1/calculate/pool-volume?shape=rectangle&unit=m&length=10&width=5&shallow_depth=1.2&deep_depth=1.8&chlorine_increase_ppm=10&pump_flow=200"},{"name":"24 ft round, 4 ft flat, +2 ppm with liquid chlorine","inputs":{"shape":"round","unit":"ft","width":24,"shallow_depth":4,"chlorine_increase_ppm":2,"chlorine_product":"liquid_chlorine_12_5"},"expected":{"volume_liters":51241,"volume_gallons_us":13536,"volume_m3":51.24,"chlorine_needed_g":102.5,"product_dose":820,"product_dose_unit":"mL","flow_for_8h_turnover_gpm":28.2},"url":"https://tttkmbb.com/api/v1/calculate/pool-volume?shape=round&unit=ft&width=24&shallow_depth=4&chlorine_increase_ppm=2&chlorine_product=liquid_chlorine_12_5"}],"faq":[{"q":"Which depth should I enter for a pool with a slope?","a":"Enter the shallow-end and deep-end depths; the average is used. For a pool with a flat shallow shelf and a deep hopper this overestimates slightly, so treat the volume as ±10%."},{"q":"Why does 1 ppm need only 10 g of chlorine per 10,000 L?","a":"1 ppm is 1 mg per litre, so 10,000 L × 1 mg = 10 g of available chlorine; a 65% calcium hypochlorite product contains 0.65 g of chlorine per gram, so 15.4 g of product is required."},{"q":"How long should the pump run?","a":"Long enough for at least one turnover a day: turnover_hours tells you the minimum; most residential pools run 8–12 hours in summer."}],"tags":["pool volume calculator","pool gallons","how many litres in my pool","pool shock dose","pool pump turnover"],"related":[{"calculator_id":"aquarium-volume","reason":"Volume and water weight of a fish tank."},{"calculator_id":"volume","reason":"Convert between litres, gallons and cubic metres."},{"calculator_id":"cylinder","reason":"Exact volume of a round tank."}],"links":{"html":"https://tttkmbb.com/everyday/pool-volume","markdown":"https://tttkmbb.com/everyday/pool-volume.md","json":"https://tttkmbb.com/everyday/pool-volume.json","api":"https://tttkmbb.com/api/v1/calculate/pool-volume","schema":"https://tttkmbb.com/api/v1/calculators/pool-volume","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T01:45:43Z","next_actions":[{"tool":"run_calculator","calculator_id":"pool-volume","reason":"Run Pool Volume Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/everyday/pool-volume.md"}}