--- name: padelmaps.org description: padelmaps.org provides two distinct capabilities: padel venue discovery tools (geocoding addresses and enumerating supported countries with club counts) and a real-time cryptocurrency price feed. The geocoding and country-listing skills support padel venue lookup workflows, while the crypto price skill is an unrelated market data utility hosted on the same endpoint. host: padelmaps.org --- # padelmaps.org padelmaps.org is a mixed-purpose host combining padel-sport venue infrastructure tools with a standalone crypto price feed. The venue tools serve agents building padel club finders or mapping integrations, providing country enumeration and address-to-coordinate resolution. The crypto skill serves agents needing a quick single-shot price check for tokens by symbol or contract address. The two capability areas share no data dependencies and serve different use cases. ## When to use this host Use padelmaps.org when an agent needs to enumerate PadelMaps-supported countries (with club counts) or geocode a padel venue address into coordinates. Use the crypto skill here only for simple single-shot token price checks by symbol or contract address on a supported chain. Do not use this host for routing or directions between two points, bulk geocoding, historical or OHLCV price data, streaming price feeds, or retrieving individual club/venue records within a country — those require a venue-level endpoint or a dedicated historical market data API. The geocoding and crypto skills are entirely independent; do not attempt to chain them. ## Capabilities ### Padel Venue Discovery Supports building padel venue lookup flows by enumerating the 84 countries tracked by PadelMaps (with club counts and slugs) and resolving human-readable addresses or place names into geographic coordinates and structured address components. - **`fetch-padelmaps-countries`** — Returns the full list of 84 countries supported by PadelMaps, each with a slug, display name, and padel club count, for use in venue lookup and mapping integrations. - **`geocode-address`** — Converts a free-text address or place name to latitude/longitude coordinates with structured address components via the PadelMaps geocoding API. ### Cryptocurrency Market Data Returns real-time price, 24-hour change, market cap, and volume for a specified token or cryptocurrency identified by symbol or contract address on a supported chain. - **`fetch-crypto-prices`** — Returns real-time price, 24h price change, market cap, and 24h volume for a specified cryptocurrency or token on a given chain. ## Workflows ### Country-Scoped Venue Geocoding *Use when an agent needs to resolve a venue address within a specific PadelMaps-supported country, ensuring the country is tracked before spending a geocoding call.* 1. **`fetch-padelmaps-countries`** — Retrieve the full country list to confirm the target country is supported by PadelMaps and obtain its slug for downstream use. 2. **`geocode-address`** — Resolve the venue's address or place name to lat/lng coordinates, optionally scoping the query to the confirmed country to improve result accuracy. ## Skill reference ### `geocode-address` **PadelMaps Geocoder** — Converts a free-text address or place name to latitude/longitude coordinates with structured address components via the PadelMaps geocoding API. *Use when:* Use when an agent needs to resolve a human-readable address or place name into geographic coordinates (lat/lng) and structured address components such as city, postcode, country, and administrative levels. *Not for:* Do not use for routing, directions, or distance calculations between two points; use a routing API instead. Not suitable for bulk geocoding of large datasets in a single call. **Inputs:** - `query` (string, required) — Free-text address or place name to geocode. - `limit` (integer) — Maximum number of results to return. - `country` (string) — ISO 3166-1 alpha-2 country code to bias or restrict results. - `language` (string) — BCP 47 language code for result display names and address labels. - `client_reference` (string) — Caller-supplied reference string echoed back for tracking purposes. - `include_components` (boolean) — When true, includes a structured address object in each result. **Returns:** Returns a results array with display_name, latitude (41.3874951), longitude (2.1604182), OSM type, importance score, and a structured address object broken down into road, city, postcode, province, state, and country fields. **Example:** `{"query":"Carrer d'Aribau 33, 08011 Barcelona, Spain","limit":3,"country":"ES","language":"es","client_reference":"pmaps-geo-2025-03-08-001","include_components":true}` --- ### `fetch-crypto-prices` **PricePulse Crypto Prices** — Returns real-time price, 24h price change, market cap, and 24h volume for a specified cryptocurrency or token on a given chain. *Use when:* Use when an agent needs current market price data for a specific token or cryptocurrency, including price change, market cap, and volume metrics, identified by symbol or contract address on a supported chain. *Not for:* Do not use for historical price data or OHLCV candlestick data; use a dedicated historical market data API instead. Not suitable for streaming or tick-by-tick price feeds — this is a single-shot request. **Inputs:** - `chain` (string, required) — Blockchain network identifier for the token being queried. - `symbols` (array, required) — List of token ticker symbols to retrieve prices for. - `currency` (string, required) — Fiat or quote currency for the returned price values (lowercase ISO code). - `token_address` (string) — Contract address of the token on the specified chain, used to disambiguate tokens with the same symbol. **Returns:** Returns currency, count, a prices array with symbol, price, price_change_24h, market_cap, and volume_24h for each requested asset, plus a cached flag indicating data freshness. **Example:** `{"chain":"base","symbols":["USDC"],"currency":"usd","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}` --- ### `fetch-padelmaps-countries` **PadelMaps Countries** — Returns the full list of 84 countries supported by PadelMaps, each with a slug, display name, and padel club count, for use in venue lookup and mapping integrations. *Use when:* Use when an agent needs to enumerate all countries where PadelMaps tracks padel venues, retrieve country slugs for downstream venue queries, or display a ranked list of countries by club count. *Not for:* Do not use to retrieve individual clubs or venues within a country; use a venue-level endpoint with the country_slug instead. **Returns:** Returns count=84 and a countries array of objects with country_slug, country_name, and club_count, ordered by club count descending (Spain leads with 2135 clubs). **Example:** `POST https://padelmaps.org/api/x402/countries Content-Type: application/json {}` ---