The five causes (in priority order)
- Ammonia poisoning. Threshold: ≥ 0.25 ppm. Toxic even at low concentrations because free NH₃ damages gill tissue directly. Severity scales with concentration; ≥1 ppm is life-threatening for stocked fish.
- Nitrite poisoning.Threshold: ≥ 0.25 ppm. Causes methemoglobinemia (brown-blood disease) — fish can't carry oxygen even when DO is normal. Visible sign: gill color shifts from red to chocolate brown.
- Low dissolved oxygen. Threshold: temperature ≥ 80°F combined with weak surface agitation. Warm water holds less DO; without active surface turbulence the gas exchange falls behind respiration demand.
- pH crisis. Threshold: pH below 6 or above 9. Direct gill-tissue damage; disrupts ion exchange. Often the silent cause — old-tank-syndrome KH crashes drop pH below 6 without visible warning.
- Disease (gill parasites, bacterial gill infection). Fallback when water tests are clean. Most common: gill flukes, costia, chilodonella, gill ich. Requires veterinary diagnosis or qualified-forum ID before treatment.
How the ranking works
Each candidate cause carries a base severity weight; flagged causes get bonus weight scaled by how badly the threshold is exceeded. Toxin-driven causes (ammonia, nitrite) outrank ambient causes (low DO, pH crisis), which outrank fallback disease — because toxin exposure has the shortest time-to-mortality and the cleanest intervention. The top suspect is the cause you should act on first; the ranked list below shows what to rule out next if the top intervention doesn't resolve the gasping within 30 minutes.
What this tool does NOT do
- Diagnose specific diseases.When the diagnostic falls back to disease, it tells you to investigate parasites / bacterial gill infection — it doesn't identify which one. Use a vet-staffed forum or aquatic vet for ID before medicating.
- Differentiate species sensitivity. Sensitive species (discus, wild bettas, scaleless catfish) react at lower thresholds than hardy community fish. The thresholds here are community-tank conservative; treat your sensitive species as crossing the threshold earlier.
- Account for chronic vs acute exposure. A fish gasping after 6 months at 0.5 ppm ammonia has different organ damage than one gasping from a sudden 2 ppm spike. The intervention is the same; recovery prognosis differs.
- Replace veterinary diagnosis. Severe symptoms (multiple fish gasping, visible bloody gills, refusing food after water-chemistry fix) need an aquatic veterinarian. This is calculator-grade triage, not vet care.
FAQ
Why is gasping ranked by cause instead of just one answer?
Gasping at the surface is a symptom with five common causes: ammonia poisoning, nitrite poisoning (methemoglobinemia), low dissolved oxygen, pH crisis, and disease (especially gill flukes / gill parasites). Several of these can present at once — a tank with elevated ammonia AND low surface agitation needs both fixes, not one. Ranking by severity weight (toxin readings outrank ambient conditions outrank disease) tells you which fix to do first while reminding you of the secondary suspects to rule out.
I tested everything and it's all in range. What now?
If ammonia is 0, nitrite is 0, pH is in 6.5-8, and you have visible surface agitation — the diagnostic falls back to disease. The most common cause of clean-water gasping is gill parasites (flukes, ich on the gills, costia, chilodonella) or bacterial gill infection. Take a clear photo and post to a vet-staffed forum (the Aquarium Co-Op Discord, Fish Lab Forums, or local fish-specialist vet) for ID. Don't medicate blindly — empirical fluke treatment with praziquantel is generally safe, but ich + gill parasites + bacterial all need different protocols.
How do I tell low oxygen from ammonia poisoning?
Both produce surface gasping, so behavior alone isn't enough. The differentiator is your test kit: ammonia poisoning needs a positive ammonia reading (≥0.25 ppm in fish-in tanks). If ammonia tests at 0 and nitrite tests at 0, the gasping isn't toxin-driven. Low oxygen further differentiates by environment: warm water (>80°F), still surface, no airstone, no spray bar = low DO is likely. Cool water with active surface turbulence + clean test results = look at disease. Use the diagnostic to rank the candidates and act on the top suspect first.
What's a 'pH crisis' and when does it cause gasping?
Acute pH below ~6 or above ~9 directly damages gill tissue and disrupts oxygen exchange. Most freshwater fish target the 6.5-8.0 range; sustained excursions outside that cause stress, gasping, and eventually mortality. Common triggers: an old tank dropping into 'old tank syndrome' (KH crashed, pH crashed with it — happens around the 1-year mark in tanks with little hardscape buffering), driftwood-heavy tanks acidifying past target, or rim-loaded shells/limestone overshooting on the alkaline side. The fix is gradual — never adjust pH faster than 0.2 units/day for established stocking.
How accurate are strip kits for this?
Bad. Strip kits read ammonia + nitrite poorly at the low end (0.25-0.5 ppm) where the diagnostic threshold sits, and pH strips often misread by 0.4 units. If the diagnostic is pointing at low oxygen but you only have strips, retest with a liquid kit (API Master is the standard hobby choice) before committing to the diagnosis. Strip kits underread toxins more often than overread — treat any strip-kit positive as the floor of what's actually present.
My fish gasps in the morning only. What does that mean?
Classic dissolved-oxygen pattern. Plants respire (consume O2) at night when photosynthesis stops; in heavily planted tanks the dissolved oxygen drops overnight and bottoms out around dawn. Add an airstone on a timer for the dark hours, or install surface agitation that runs 24/7. Fish-only morning gasping with clean water tests is the diagnostic for plant-respiration DO drop — none of the toxin-driven causes follow the day/night pattern.
Related
- Ammonia / nitrite emergency calculator →
- Nitrite spike calculator →
- Air pump sizing calculator →
- New tank syndrome diagnostic →
Diagnostic thresholds drawn from established hobby practice + EPA ammonia/nitrite toxicity data + standard aquaculture dissolved-oxygen guidance. For severe or sustained symptoms talk to an aquatic veterinarian — this is calculator-grade triage, not veterinary advice. See methodology for the full sourcing tier list.