find_nearest_bitcoin_atm

The find_nearest_bitcoin_atm tool finds ByteFederal ATMs near a specified location, sorted by distance.

Parameters

Parameter	Type	Required	Default	Description
location	string	No*	-	Address, city/state, or ZIP code
lat	number	No*	-	Latitude coordinate
lon	number	No*	-	Longitude coordinate
limit	number	No	10	Maximum results (1-50)
maxDistance	number	No	25	Maximum distance in miles (1-100)

*Either location OR lat/lon coordinates are required.

Example Usage

By Location String

"Find Bitcoin ATMs near Miami, FL"

Tool call:

{
  "name": "find_nearest_bitcoin_atm",
  "arguments": {
    "location": "Miami, FL",
    "limit": 5
  }
}

By Coordinates

"Find ATMs near latitude 25.76, longitude -80.19"

Tool call:

{
  "name": "find_nearest_bitcoin_atm",
  "arguments": {
    "lat": 25.76,
    "lon": -80.19,
    "limit": 10,
    "maxDistance": 15
  }
}

Response

{
  "success": true,
  "data": {
    "locations": [
      {
        "id": 123,
        "name": "Chevron - Biscayne",
        "address": "123 Biscayne Blvd",
        "city": "Miami",
        "state": "FL",
        "distance": 0.8,
        "status": "open",
        "hours": {
          "today": "6:00 AM - 11:00 PM",
          "nextChange": null
        },
        "links": {
          "directions": "https://maps.google.com/...",
          "reviews": "https://maps.google.com/..."
        }
      }
    ],
    "count": 1,
    "searchArea": "Miami, FL",
    "searchRadius": 25
  }
}

Response Fields

Location Object

Field	Type	Description
id	number	Unique ATM identifier
name	string	Location/business name
address	string	Street address
city	string	City
state	string	State code
distance	number	Distance from search point (miles)
status	string	”open” or “closed”
hours.today	string	Today’s operating hours
hours.nextChange	string	When status will change
links.directions	string	Google Maps directions link
links.reviews	string	Google Maps reviews link

Natural Language Examples

User Says	Interpreted As
”Find ATMs near me”	Uses device location or asks for location
”Bitcoin ATMs in 90210”	ZIP code search
”ATMs within 5 miles of downtown LA”	Location with distance limit
”Nearest ATM to 123 Main St”	Address search, limit 1

Notes

• Results are sorted by distance (nearest first)
• Distance is calculated using the Haversine formula
• Status is timezone-aware based on ATM location
• If geocoding fails, falls back to city-level search