Halloween Moon Crab (Gecarcinus quadratus)

Halloween Moon Crab (Gecarcinus quadratus) Care Sheet

The Halloween Moon Crab (Gecarcinus quadratus) is a spectacular tropical land crab recognised by its vivid purple legs, dark carapace and contrasting orange-red colouration.

Also known as the Halloween Crab, Moon Crab or Harlequin Land Crab, this species spends the majority of its adult life on land. However, describing it simply as a terrestrial crab can be misleading: access to appropriate water, very high humidity and deep burrowing substrate are all fundamental to successful husbandry.

Halloween Moon Crabs are powerful diggers. In captivity they require considerably more substrate than many typical terrestrial invertebrates because burrowing plays an important role in shelter, moisture regulation and moulting.

They are also strong, surprisingly capable escape artists and can be territorial toward other crabs.

Successful husbandry requires a large secure enclosure, very deep moisture-retentive substrate, warm tropical temperatures, high humidity combined with ventilation, access to both freshwater and marine-strength saltwater, a varied omnivorous diet and sufficient privacy for burrowing and moulting.


Quick Facts

Scientific name: Gecarcinus quadratus
Common names: Halloween Moon Crab, Halloween Crab, Moon Crab, Harlequin Land Crab
Order: Decapoda
Family: Gecarcinidae
Origin: Pacific coast of the Americas
Adult carapace width: Approximately 5–7 cm, sometimes larger
Lifestyle: Primarily terrestrial but dependent upon water and humid environments
Activity: Primarily nocturnal/crepuscular
Diet: Omnivorous and opportunistic
Temperature: Approximately 24–28°C
Humidity: High, approximately 70–85% as a general guide
Substrate: Very deep, moisture-retentive and suitable for burrowing
Water: Freshwater and properly prepared marine-strength saltwater
Housing: Individual housing is safest
Handling: Minimal
Experience level: Intermediate
Major requirements: Deep substrate, secure enclosure, high humidity, correct water provision and safe moulting conditions


Natural Distribution

Gecarcinus quadratus occurs along parts of the Pacific coast of the Americas.

Its range extends through tropical regions of Central America and adjacent areas.

The species is associated particularly with coastal habitats where adults can retreat into burrows while remaining within reach of the marine environment required for reproduction.


Natural Habitat

Halloween Moon Crabs inhabit areas including:

  • Coastal forest
  • Vegetated areas behind beaches
  • Moist tropical ground
  • Burrows beneath vegetation
  • Areas containing deep soil and sand

Although adults spend substantial amounts of time away from open water, moisture remains essential.


Terrestrial Does Not Mean Dry

One of the most important things to understand about this species is that:

terrestrial does not mean arid.

The crab’s respiratory structures must remain appropriately moist.

A dry enclosure can therefore become dangerous even if food and drinking water are available.


Appearance

Halloween Moon Crabs are among the most colourful terrestrial crabs maintained in captivity.

Typical colouration includes:

  • Dark purple or brown carapace
  • Bright orange or reddish areas
  • Purple legs
  • Contrasting pale or yellowish markings

Colour intensity varies between individuals.


Adult Size

Adults commonly develop a carapace approximately:

5–7 cm across, although size varies.

Including the legs, the animal occupies considerably more space.


Claws

Halloween Moon Crabs possess powerful claws.

These are used for:

  • Feeding
  • Digging
  • Defence
  • Territorial interactions

The claws can produce a painful pinch.


Behaviour

The species is primarily:

crepuscular and nocturnal.

Crabs commonly become much more active during the evening and overnight.

During daylight they may remain hidden inside burrows.


Burrowing

Burrowing is fundamental natural behaviour.

A Halloween Moon Crab may construct extensive tunnels and chambers beneath the substrate.

These provide:

  • Security
  • Darkness
  • Stable humidity
  • Temperature regulation
  • Moulting sites

Do Not Prevent Burrowing

An enclosure with only a thin covering of substrate is unsuitable.

The crab should be able to:

completely disappear underground.


Housing

A large terrestrial enclosure with a secure lid is required.

Suitable housing may include:

  • Large glass terrariums
  • Large plastic enclosures
  • Custom crab habitats

The enclosure must provide sufficient space for:

  • Deep substrate
  • Water containers
  • Hides
  • Feeding
  • Burrowing

Minimum Enclosure Considerations

For a single adult, an enclosure with a footprint around:

60 × 45 cm or larger

provides a more useful starting point than small aquarium-style housing.

Larger is strongly preferable where practical.

The depth of the enclosure must also accommodate substantial substrate.


Enclosure Security

Halloween Moon Crabs are:

strong escape artists.

They can:

  • Climb furnishings
  • Push lightweight lids
  • Exploit gaps
  • Use equipment as climbing aids

A secure lid is essential.


Ventilation

The enclosure requires ventilation despite the high humidity.

Poor airflow can encourage:

  • Mould
  • Stagnant conditions
  • Excessive condensation
  • Substrate deterioration

The aim is:

humid air with ventilation, not a sealed wet box.


Substrate

Deep substrate is one of the most important requirements.

A suitable mixture can contain:

  • Coco fibre
  • Organic topsoil
  • Sand
  • Leaf litter
  • Other safe moisture-retentive materials

The mixture should support stable burrows.


Substrate Depth

Provide at least approximately:

15–20 cm

for an adult wherever enclosure dimensions permit.

Deeper substrate is preferable.

Large specimens can excavate surprisingly substantial burrow systems.


Burrow Stability

The substrate should be capable of holding its shape when excavated.

A mixture that is too loose may collapse constantly.

A slightly moist soil/sand-based mixture often provides better structural stability than dry loose fibre alone.


Substrate Moisture

The lower substrate should remain:

moist but not waterlogged.

This helps maintain humid underground retreats.


Moisture Gradient

Some variation across the enclosure is beneficial.

Provide:

  • Moist deeper substrate
  • Humid burrow areas
  • Somewhat drier surface areas

Avoid allowing the entire enclosure to become either completely dry or saturated.


Leaf Litter

A generous layer of pesticide-free deciduous leaf litter can be provided.

Leaf litter offers:

  • Cover
  • Foraging opportunities
  • Organic material
  • Naturalistic enrichment

Hides

Although the crab will usually construct its own burrows, additional surface hides can include:

  • Cork bark
  • Half logs
  • Stable rock-style hides
  • Coconut hides

All heavy objects must be positioned safely.


Heavy Furnishings

Never place heavy decorations loosely on top of deep substrate.

A crab can excavate beneath them, causing them to collapse.

Heavy furnishings should be:

supported securely from the enclosure base or otherwise stabilised.


Temperature

A useful temperature range is approximately:

24–28°C.

Around 25–27°C works well for many individuals.


Night Temperature

A modest nighttime reduction is acceptable.

Avoid prolonged cold conditions.


Excessive Heat

Avoid prolonged temperatures above approximately:

30°C.

High temperatures combined with dehydration can be particularly dangerous.


Heating

If additional heat is required, use:

  • Warm room temperatures
  • Gentle external heating
  • Thermostatically controlled equipment

Heat Mat Position

If a heat mat is used, it is generally safer against:

the side or rear of the enclosure

rather than beneath the entire substrate.

The crab must be able to retreat deeper without encountering increasing heat.


Thermostat

Dedicated heating equipment should be controlled by:

a reliable thermostat.


Direct Sunlight

Never place the enclosure in direct sunlight.

Glass enclosures can overheat extremely rapidly.


Humidity

High humidity is important.

Approximately:

70–85% relative humidity

provides a useful general guide.

Do not become fixated on one exact number; substrate condition and the crab’s access to humid retreats are more important.


Misting

Misting can be used to help maintain humidity.

However, misting should not substitute for:

correctly hydrated deep substrate.


Ventilation and Humidity

Good crab husbandry requires balancing:

high humidity with fresh airflow.

If the enclosure is constantly dripping with condensation and smells stagnant, ventilation or moisture management requires adjustment.


Water Requirements

Halloween Moon Crabs should be provided with access to:

freshwater AND marine-strength saltwater.

Two separate containers are the simplest arrangement.


Freshwater

Provide a dish containing:

dechlorinated freshwater.

Tap water containing chlorine or chloramine should be appropriately treated before use.


Saltwater

The second container should contain:

properly prepared marine saltwater.

Use a commercial marine aquarium salt mix.


Do Not Use Table Salt

Never attempt to create the saltwater using ordinary table salt.

Table salt does not reproduce the mineral composition of seawater.

Use:

marine aquarium salt.


Saltwater Strength

Prepare the saltwater according to the marine salt manufacturer’s instructions to approximately normal seawater salinity.

A specific gravity around:

1.023–1.026

is a useful general marine target when measured appropriately.


Water Dish Depth

Water containers should allow the crab to:

  • Enter
  • Soak
  • Exit easily

They should not become traps.


Escape Routes from Water

Provide easy exits using:

  • Rough stones
  • Cork
  • Textured ramps
  • Other secure surfaces

The crab should never struggle to climb from a water container.


Water Maintenance

Replace contaminated water regularly.

Crabs may carry:

  • Substrate
  • Food
  • Waste

into their water dishes.


Diet

Halloween Moon Crabs are:

omnivorous opportunistic feeders.

A varied diet is preferable to relying on one commercial food.


Plant Foods

Suitable plant foods can include:

  • Leafy greens
  • Squash
  • Pumpkin
  • Carrot
  • Sweet potato
  • Courgette
  • Peas

Fruit

Fruit can be offered in moderation.

Suitable examples include:

  • Apple
  • Banana
  • Mango
  • Papaya
  • Melon
  • Berries

Too much sugary fruit should be avoided.


Protein

Animal protein is an important component of a varied diet.

Suitable foods can include:

  • Appropriate crustacean foods
  • Quality fish foods
  • Small amounts of cooked unseasoned fish
  • Suitable invertebrate foods
  • Occasional appropriate feeder insects

Carrion Feeding

Wild land crabs are opportunistic and may consume carrion.

In captivity, protein should be offered in controlled portions and uneaten animal food removed promptly.


Calcium

Calcium is particularly important for crustaceans because it contributes to development of the:

exoskeleton.

Suitable calcium sources can include:

  • Cuttlebone
  • Crushed clean eggshell
  • Appropriate calcium-rich crustacean foods

Cuttlebone

A piece of plain:

cuttlebone

can be left available within the enclosure.

The crab can consume it as required.


Leaf Litter as Food

Safe decomposing leaves may also be consumed.

This natural foraging material can remain available continuously.


Feeding Frequency

Small amounts of food can generally be offered:

several times per week.

Adjust portions according to consumption.


Remove Old Food

Remove food before it becomes heavily:

  • Mouldy
  • Rotten
  • Foul smelling

This is particularly important for protein-rich foods.


Food Dish

A shallow feeding dish makes maintenance easier and reduces food becoming buried.


Pesticide Exposure

Wash fresh produce before feeding.

Never offer vegetation collected from areas potentially exposed to:

  • Pesticides
  • Herbicides
  • Road contamination

Handling

Routine handling is:

not recommended.

Halloween Moon Crabs are better observed within their enclosure.


Pinching

The claws are powerful enough to deliver:

a painful pinch.

Never deliberately place fingers between the claws.


Picking Up the Crab

Avoid lifting the crab unnecessarily.

Never pick it up by:

  • Legs
  • Claws
  • Individual appendages

Transfer Method

When relocation is necessary, use:

a suitably sized container.

Guide the crab gently into it rather than grabbing it.


Falls

Crabs have hard exoskeletons but can still be seriously injured by falls.

Handling above hard flooring should be avoided.


Hand Hygiene

Wash hands after:

  • Handling the crab
  • Cleaning substrate
  • Touching water dishes
  • Maintaining the enclosure

Social Housing

Individual housing is generally the safest approach.

Halloween Moon Crabs can be:

territorial and aggressive toward one another.


Aggression

Crabs may compete over:

  • Burrows
  • Food
  • Hides
  • Territory

Aggression can result in:

  • Lost limbs
  • Damaged claws
  • Stress
  • Death

Communal Housing

Keeping multiple adults together requires substantially more space and carries additional risk.

For ordinary pet husbandry:

one crab per enclosure is the safer recommendation.


Moulting

Like all crustaceans, Halloween Moon Crabs must periodically shed their rigid exoskeleton in order to grow.

This process is called:

ecdysis or moulting.


Importance of Moulting

Moulting is one of the most vulnerable periods in a crab’s life.

The newly emerged exoskeleton is extremely soft.

The crab requires:

  • Security
  • Moisture
  • Correct temperature
  • Calcium
  • Complete absence of disturbance

Pre-Moult Behaviour

Before moulting, a crab may:

  • Become less active
  • Eat less
  • Stop eating
  • Spend more time underground
  • Seal itself inside a burrow

Buried Crab

If a crab disappears underground:

do not dig it up simply to check whether it is alive.

It may be preparing to moult.


Sealed Burrow

A crab may deliberately close the entrance to its burrow.

Do not reopen it.

The enclosed chamber helps provide:

  • Security
  • Stable humidity
  • Protection during moulting

Never Disturb a Moulting Crab

Digging up a moulting crab can cause:

  • Severe stress
  • Physical damage
  • Failed moulting
  • Death

Patience is essential.


Duration Underground

A crab may remain underground for:

days or several weeks, depending upon size and moulting stage.

Large adults can remain hidden for extended periods.


Shed Exoskeleton

After moulting, the old shell may look remarkably like a dead crab.

Examine carefully before assuming the animal has died.


Do Not Remove the Moult Immediately

The crab may consume its discarded exoskeleton.

This allows it to recover valuable minerals, including calcium.

Leave the moult available unless it begins to cause a hygiene problem.


Post-Moult Crab

Immediately after moulting, the crab is:

  • Soft
  • Vulnerable
  • Easily injured

Do not handle it.

Allow the exoskeleton to harden naturally.


Missing Limbs

Crabs can lose limbs through:

  • Fighting
  • Accidents
  • Failed moults
  • Autotomy

Regeneration

Lost limbs can often regenerate over subsequent moults.

A regenerated limb may initially be smaller than the original.

Repeated moults can restore more normal proportions.


Sexing

Mature crabs can be sexed by examining the shape of the abdominal flap beneath the body.

Generally:

males have a narrower abdominal flap, while females possess a broader abdomen adapted for carrying eggs.

Avoid unnecessary handling purely for sex determination.


Breeding

Breeding Halloween Moon Crabs in captivity is:

extremely challenging.

Successful adult mating does not mean the full life cycle can easily be completed.


Why Breeding Is Difficult

Although adults are terrestrial, reproduction is linked to:

the marine environment.

Females carrying eggs migrate toward the sea in nature.


Larvae

The offspring hatch as tiny aquatic planktonic larvae rather than miniature terrestrial crabs.

These larvae require:

marine conditions.


Larval Development

Larvae pass through multiple planktonic developmental stages before eventually transforming toward a juvenile crab form.

Successful rearing requires specialised knowledge of:

  • Marine water quality
  • Salinity
  • Larval foods
  • Water movement
  • Developmental stages

Not a Simple Colony Species

Unlike many cockroaches, isopods or millipedes, Halloween Moon Crabs should not be expected to establish a self-sustaining terrestrial colony inside a normal enclosure.

Completing the life cycle requires specialised larval rearing.


Cleaning

Routine maintenance should focus on:

  • Removing spoiled food
  • Cleaning water containers
  • Removing excessive waste
  • Checking humidity
  • Monitoring substrate condition

Avoid Constant Deep Cleaning

Deep substrate should not be repeatedly dismantled.

Doing so destroys burrows and can disturb a crab during:

pre-moult or moulting.


Spot Cleaning

Regular:

spot cleaning

is preferable.


Cleaning Water Containers

Water containers require frequent attention because crabs commonly carry substrate into them.

Rinse and refill as necessary.


Bioactive Housing

Bioactive setups can be considered.

Springtails may help control:

  • Mould
  • Organic waste

However, any cleanup species must tolerate the enclosure conditions.


Isopods

Use caution when adding isopods.

Some species may compete for food or potentially disturb a vulnerable moulting crab.

Springtails alone are often the simpler option.


Mould

Persistent mould usually indicates:

  • Excess food
  • Poor ventilation
  • Excessive surface moisture

Remove affected material and correct the cause.


Mites

Small detritivore mites may occasionally appear.

Large populations usually indicate excessive food or poor hygiene.

Never use pesticides inside the enclosure.


Household Chemicals

Crustaceans can be highly sensitive to environmental contaminants.

Keep the enclosure away from:

  • Insecticides
  • Flea treatments
  • Cleaning sprays
  • Garden chemicals
  • Aerosols

Copper

Copper can be toxic to many invertebrates, particularly aquatic and semi-aquatic crustaceans at sufficient concentrations.

Avoid casually using medications, water treatments or supplements containing copper unless specifically known to be safe and appropriate.


Health

Common husbandry-related problems include:

  • Dehydration
  • Low humidity
  • Incorrect temperatures
  • Inadequate substrate depth
  • Moulting disturbance
  • Poor diet
  • Lack of calcium
  • Contaminated water
  • Aggression from other crabs

Warning Signs

Potential concerns include:

  • Persistent inability to stand
  • Severe loss of coordination
  • Unexplained limb loss
  • Abnormal shell damage
  • Repeated unsuccessful moults
  • Prolonged surface lethargy under otherwise appropriate conditions

Remember that disappearing underground can be completely normal.


Common Husbandry Mistakes

Common mistakes include:

  • Keeping the crab in shallow substrate
  • Treating it as a fully aquatic crab
  • Treating it as a dry terrestrial animal
  • Providing only freshwater
  • Making saltwater with table salt
  • Allowing humidity to fall too low
  • Keeping the enclosure saturated and stagnant
  • Using an insecure lid
  • Housing incompatible adults together
  • Digging up a buried crab
  • Removing a moult immediately
  • Failing to provide calcium
  • Placing heavy decorations where burrowing can undermine them
  • Underestimating the crab’s ability to escape

Are Halloween Moon Crabs Suitable for Beginners?

They are best considered:

intermediate-level exotic pets.

Their diet is not particularly difficult, but successful husbandry requires understanding of:

  • Deep burrowing substrate
  • Humidity
  • Freshwater and saltwater provision
  • Moulting
  • Territorial behaviour
  • Escape prevention

They require substantially more specialised housing than many terrestrial invertebrates.


Display Value

Halloween Moon Crabs are visually spectacular.

Their contrasting dark, orange and purple colouration makes them highly attractive display animals.

However, prospective keepers should understand that a healthy crab may spend substantial periods:

completely underground.

A crab that is constantly visible is not necessarily a better-kept crab.


Natural Behaviour

A well-designed enclosure allows the crab to perform:

  • Burrowing
  • Digging
  • Foraging
  • Climbing
  • Soaking
  • Nocturnal exploration

Providing opportunities for these behaviours is more important than designing an enclosure purely around constant visibility.


Enrichment

Useful enrichment can include:

  • Deep substrate
  • Leaf litter
  • Cork bark
  • Safe branches
  • Multiple food locations
  • Changing safe food items
  • Naturalistic hides

Avoid unnecessary frequent rearrangement of established burrows.


Responsible Sourcing

Captive-bred animals should be preferred whenever genuinely available.

However, completing the larval life cycle is difficult, meaning prospective owners should investigate the origin of animals carefully.

Ask sellers:

  • What is the exact species?
  • Is the animal captive bred or wild collected?
  • How long has it been in captivity?
  • What conditions is it currently maintained under?
  • What foods is it currently accepting?

Identification

Several colourful terrestrial crabs can be sold under overlapping common names.

Always confirm:

the scientific name.

Do not rely solely on names such as “Moon Crab” or “Halloween Crab.”


Legal Considerations

Regulations concerning exotic crustaceans vary between jurisdictions.

Restrictions may apply to:

  • Import
  • Export
  • Possession
  • Sale
  • Transport
  • Release

Always verify current regulations applicable to your location.


Never Release Captive Crabs

Never release a captive Halloween Moon Crab into the environment.

Unwanted animals should be responsibly rehomed.


Responsible Ownership

Before obtaining Gecarcinus quadratus, ensure you can provide:

  • A large secure enclosure
  • Very deep burrowing substrate
  • Warm tropical temperatures
  • High humidity
  • Adequate ventilation
  • Freshwater
  • Correctly prepared marine saltwater
  • A varied omnivorous diet
  • Calcium
  • Privacy during moulting
  • Long-term individual housing

Summary

The Halloween Moon Crab (Gecarcinus quadratus) is a spectacular tropical land crab recognised by its striking dark, orange and purple colouration.

Although primarily terrestrial as an adult, it should never be treated as a dry-land animal. High humidity, moist burrows and appropriate access to water are essential.

A single adult should be provided with a spacious, secure enclosure containing at least approximately 15–20 cm of moisture-retentive substrate, with deeper substrate preferable wherever practical.

A temperature range of approximately 24–28°C and humidity around 70–85% provide useful general husbandry targets when combined with adequate ventilation.

Two water areas should be available: dechlorinated freshwater and properly prepared marine-strength saltwater made using marine aquarium salt.

The species is omnivorous and should receive a varied diet containing vegetables, moderate fruit, plant material and appropriate protein. A source of calcium such as cuttlebone should also be available.

Moulting is an especially vulnerable period. A crab may seal itself underground for an extended time before and after moulting. Never dig up a buried crab simply to check on it.

Individual housing is safest because adults can be territorial and their powerful claws can cause serious injuries to other crabs.

Captive reproduction is exceptionally challenging because the early life stages are aquatic and require marine conditions.

With sufficient space, deep substrate, correct humidity, proper freshwater and saltwater provision and minimal disturbance, Gecarcinus quadratus can be a fascinating terrestrial crustacean to maintain.


IMPORTANT INFORMATION

This care sheet provides general husbandry guidance and does not replace current species-specific research or applicable wildlife, import, agricultural or invasive-species legislation.

Deep substrate is essential. Halloween Moon Crabs are powerful burrowers and may remain underground for extended periods, particularly around moulting.

Never dig up a crab that has sealed itself inside a burrow unless there is a genuine emergency.

Provide both dechlorinated freshwater and correctly prepared marine-strength saltwater. Do not make artificial seawater using ordinary table salt; use a proper marine aquarium salt mix.

Maintain high humidity while also providing adequate ventilation. Terrestrial does not mean dry.

Individual housing is safest because adults can be territorial and capable of inflicting serious injuries on one another.

Heavy enclosure furnishings must be secured so that burrowing cannot cause them to collapse onto the crab.

Never use pesticides or inappropriate chemical treatments around the enclosure.

Captive reproduction is difficult because larvae require specialised marine conditions and should not be represented as straightforward terrestrial breeding.

Never release captive crabs into the environment.

Always verify current regulations concerning possession, sale, transport, breeding, import and export in your jurisdiction.

Information correct at the date of publication.

reptilecommunity.com | Revised: August 2026