IsItWater

Determine whether a latitude/longitude coordinate is over water using the IsItWater API.

Setup

Before making API calls, check whether the user has an API key configured:

1. 1. Check if ISITWATER_API_KEY is set in the environment.
2. If it is not set:

- Inform the user: "You need an IsItWater API key. You can get one at https://isitwater.com" - Offer to help them sign up using the browser tool — navigate to https://isitwater.com, create an account, and generate an API key from the dashboard. - Once the user has a key, guide them to configure it in ~/.openclaw/openclaw.json:

CODEBLOCK0

- Alternatively, the user can export the environment variable directly: INLINECODE2

1. 3. Once the key is available, proceed with the API calls below.

Water Lookup

Check whether a coordinate is over water or land.

Endpoint: INLINECODE3

Headers:

• - INLINECODE4

Query Parameters:

Parameter	Type	Required	Description
INLINECODE5	number	yes	Latitude, between -90 and 90
INLINECODE6

number | yes | Longitude, between -180 and 180 |

Example curl:

CODEBLOCK1

Example response (land):

CODEBLOCK2

Example response (water):

CODEBLOCK3

Response Fields:

Field	Type	Description
INLINECODE7	string	Unique identifier for the request
INLINECODE8

boolean | true if the coordinate is over water, false if over land |
| features | string[] | Geographic features at the point — e.g. earth, ocean, lake, river, glacier, nature_reserve |
| latitude | string | The latitude that was queried |
| longitude | string | The longitude that was queried |

Cost: 1 credit per lookup.

Account Info

Check the user's account details and remaining credit balance.

Endpoint: INLINECODE20

Headers:

• - INLINECODE21

Example curl:

CODEBLOCK4

Response Fields:

Field	Type	Description
INLINECODE22	string	Account identifier
INLINECODE23

string | Account name |
| balance | number | Remaining credits |
| auto_recharge_enabled| boolean | Whether auto-recharge is turned on |

Cost: Free (no credits consumed).

Error Handling

Status Code	Meaning	Description
200	OK	Request succeeded
400

Bad Request | Invalid latitude or longitude values | | 401 | Unauthorized | Missing or invalid API key | | 402 | Payment Required | Account has no remaining credits |

Error responses return a JSON body:

CODEBLOCK5

Tips

• - Each water lookup costs 1 credit. Use the Account Info endpoint to check the user's balance before making many requests.
• When the user provides a place name instead of coordinates (e.g. "Is the Sahara Desert water?"), geocode the location first to get lat/lon, then call the water lookup endpoint.
• The features array can contain multiple overlapping values for a single point — for example, a point might return both lake and nature_reserve.