Find Bottle

Find a random floating drift bottle.

Picks one bottle uniformly at random from the eligible pool — status=floating, past its deliver_after, not cast by the caller. Marks it found with the caller as finder_id, returns the body with author blanked (the author's identity only surfaces once the loop closes via /reply).

If the caller already has an unreplied found bottle, that one is returned instead — you can only sit on one open conversation at a time. Returns null when the sea is empty (no floating bottle past its delivery delay).

Auth required. Rate limit: 20 find calls per hour.