PadelMaps API

{
  "name": "PadelMaps API",
  "description": "Real-time padel club, court, and match data worldwide. 12,264 clubs in 88 countries. Pay-per-use with USDC on Base or Solana.",
  "url": "https://padelmaps.org/a2a",
  "version": "1.0.0",
  "provider": {
    "organization": "Padel Maps",
    "url": "https://padelmaps.org"
  },
  "documentationUrl": "https://padelmaps.org/api/x402/docs",
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "padel-clubs",
      "name": "Find Padel Clubs",
      "description": "Search for padel clubs by country, city, or coordinates. Get detailed club info including courts, amenities, and contact details.",
      "tags": [
        "padel",
        "clubs",
        "search",
        "sports"
      ],
      "examples": [
        "Find padel clubs in Bangkok",
        "List countries with padel clubs",
        "Get details for a specific club"
      ]
    },
    {
      "id": "padel-matches",
      "name": "Find Padel Matches",
      "description": "Find open padel matches near a location. Discover games looking for players.",
      "tags": [
        "padel",
        "matches",
        "sports"
      ],
      "examples": [
        "Find open matches near me",
        "Matches in Madrid"
      ]
    }
  ],
  "x402Support": true,
  "paymentInfo": {
    "networks": [
      "base",
      "solana"
    ],
    "assets": [
      "USDC"
    ],
    "priceRange": "$0.01 per request"
  },
  "contact": {
    "website": "https://padelmaps.org"
  },
  "endpoints": [
    {
      "path": "/api/x402/countries",
      "method": "POST",
      "price": "$0.01",
      "description": "List every country with its exact club count. Call this first to know which countries exist and what limit each needs."
    },
    {
      "path": "/api/x402/clubs",
      "method": "POST",
      "price": "$0.01",
      "description": "Get clubs in a city"
    },
    {
      "path": "/api/x402/clubs/bulk",
      "method": "POST",
      "price": "$0.25",
      "description": "Every active club in a country with core fields. Reports total and truncated so you never need a second call to check completeness."
    },
    {
      "path": "/api/x402/clubs/bulk/full",
      "method": "POST",
      "price": "$1.00",
      "description": "Every active club in a country plus pricing, amenities, booking system, Playtomic URL and opening hours. Replaces one /club call per club."
    },
    {
      "path": "/api/x402/clubs/contacts",
      "method": "POST",
      "price": "$2.00",
      "description": "Direct contact details (email, Instagram, WhatsApp, phone) for clubs in a country. Club emails are not published on padelmaps.org."
    },
    {
      "path": "/api/x402/clubs/changes",
      "method": "POST",
      "price": "$0.10",
      "description": "Clubs added or updated since a date, for keeping a copy current without re-downloading a country."
    },
    {
      "path": "/api/x402/clubs/nearby",
      "method": "POST",
      "price": "$0.05",
      "description": "Clubs within a radius, sorted by distance, each with distance_km"
    },
    {
      "path": "/api/x402/clubs/search",
      "method": "POST",
      "price": "$0.02",
      "description": "Case-insensitive search across club name and address"
    },
    {
      "path": "/api/x402/club",
      "method": "POST",
      "price": "$0.01",
      "description": "Get detailed club info by id or name"
    },
    {
      "path": "/api/x402/club/photos",
      "method": "POST",
      "price": "$0.01",
      "description": "Get all photos for a club with URLs and metadata"
    },
    {
      "path": "/api/x402/matches",
      "method": "POST",
      "price": "$0.01",
      "description": "Find open padel matches nearby"
    },
    {
      "path": "/api/x402r/countries",
      "method": "POST",
      "price": "$0.01",
      "description": "Countries (refundable escrow, 10-min window)",
      "scheme": "commerce"
    }
  ],
  "documentation": {
    "main": "https://padelmaps.org/api/x402/docs",
    "discovery": "https://padelmaps.org/.well-known/x402"
  }
}