{
  "openapi": "3.1.0",
  "info": {
    "title": "WickedAPI x402 Paywall",
    "version": "1.0.0",
    "description": "Pay-per-call routes served by the WickedAPI x402 paywall gateway. The configuration API for creating your own paywalled routes (signup, pricing, payout wallet, settlements) is a separate document on the admin host: https://paywall-admin.wickedapi.com/openapi.json. Overview and quickstart: https://paywall.wickedapi.com/llms.txt.",
    "contact": {
      "url": "https://paywall.wickedapi.com"
    },
    "x-guidance": "WickedAPI is an x402 paywall-as-a-service: it wraps any HTTP endpoint with pay-per-call access in USDC on Base, verified and settled through the Coinbase CDP facilitator straight to the owner's wallet (no custody). To try it, call GET /wickedapi/weather (a live demo route, $0.01 USDC): the first request returns HTTP 402 with the price, an x402 client signs an EIP-3009 authorization and retries, and the weather JSON comes back. To paywall your own API, use the configuration API documented at https://paywall-admin.wickedapi.com/openapi.json: POST /signup to get a tenant key, then POST /tenants/me/routes with a price, network and payout wallet; the route is then served at https://paywall.wickedapi.com/{your-slug}{path}."
  },
  "servers": [
    {
      "url": "https://paywall.wickedapi.com",
      "description": "Production — WickedAPI x402 paywall gateway"
    }
  ],
  "tags": [
    {
      "name": "paid",
      "description": "Pay-per-call routes served by the gateway over x402."
    }
  ],
  "paths": {
    "/wickedapi/weather": {
      "get": {
        "operationId": "getDemoWeather",
        "summary": "Demo weather - current conditions for New York City, pay-per-call",
        "description": "Live demo route that exercises the full x402 flow on Base mainnet. Costs $0.01 USDC per call. Forwards to a real backend (Open-Meteo) after payment settles.",
        "tags": [
          "paid"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.010000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [],
        "responses": {
          "200": {
            "description": "Current weather conditions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "latitude": {
                      "type": "number"
                    },
                    "longitude": {
                      "type": "number"
                    },
                    "timezone": {
                      "type": "string"
                    },
                    "current_units": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "current": {
                      "type": "object",
                      "properties": {
                        "time": {
                          "type": "string"
                        },
                        "temperature_2m": {
                          "type": "number"
                        },
                        "wind_speed_10m": {
                          "type": "number"
                        },
                        "weather_code": {
                          "type": "integer"
                        }
                      }
                    }
                  },
                  "required": [
                    "latitude",
                    "longitude",
                    "current"
                  ]
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          }
        }
      }
    }
  },
  "components": {}
}
