{
  "schema_version": "1.0",
  "name": "usda-plant-hardiness-zone",
  "display_name": "USDA Plant Hardiness Zone Lookup",
  "description": "Returns the USDA Plant Hardiness Zone for a US ZIP code, including the minimum winter temperature range, average last spring / first fall frost dates, frost-free day count, crop planting calendar (cool-season and warm-season windows), and regional description. Data from USDA PHZMAPI. Cached 90 days.",
  "endpoint": "https://bacapi-usda-zone-api.workers.dev/usda",
  "method": "GET",
  "payment": {
    "protocol": "x402",
    "network":  "base",
    "currency": "USDC",
    "amount":   "0.07"
  },
  "parameters": {
    "zip": {
      "type":        "string",
      "required":    true,
      "description": "5-digit US ZIP code",
      "example":     "97201"
    }
  },
  "response_shape": {
    "zip":              "string",
    "hardiness_zone":   "string — e.g. '8B'",
    "temp_range_f":     "string — e.g. '15 to 20°F'",
    "frost_dates": {
      "last_spring_frost": "string — e.g. 'Feb 28'",
      "first_fall_frost":  "string — e.g. 'Dec 1'",
      "frost_free_days":   "integer"
    },
    "crop_calendar": {
      "cool_season_planting": "string[] — months",
      "warm_season_planting": "string[] — months",
      "year_round_crops":     "string[] — crop names"
    },
    "region":       "string — general region description",
    "usda_source":  "string"
  },
  "example_request": "GET /usda?zip=97201",
  "example_response": {
    "data": {
      "zip":            "97201",
      "hardiness_zone": "8B",
      "temp_range_f":   "15 to 20°F",
      "frost_dates": {
        "last_spring_frost": "Feb 28",
        "first_fall_frost":  "Dec 1",
        "frost_free_days":   276
      },
      "crop_calendar": {
        "cool_season_planting": ["Sep","Oct","Nov","Feb","Mar"],
        "warm_season_planting": ["Mar","Apr"],
        "year_round_crops":     ["Lettuce","Herbs","Chard"]
      },
      "region": "Gulf Coast, Pacific Coast"
    },
    "meta": { "source": "USDA PHZMAPI + NOAA frost date averages", "priced_at": "0.07 USDC" }
  },
  "tags": ["usda","gardening","agriculture","plants","hardiness-zone","frost","crop-calendar","farming"],
  "category": "agriculture"
}