Developer Portal

Getting Started - PatchPulse API

Instantly decode game balance changes

Installation

Obtain Your Credentials

Access to the PatchPulse v3.2 API requires a valid bearer token. Create a free developer account at dashboard.patchpulse.io to retrieve your secret key within 60 seconds.

1. Register & Verify

Sign up with a valid email. Verification links expire in 15 minutes. Once confirmed, navigate to the "Keys" tab in your dashboard.

2. Generate Secret

Click "Create New Key" and label it (e.g., "prod-overwatch-2024"). Copy the pp_live_ prefixed string immediately. It will not be displayed again.

3. Configure Environment

Store the token in your .env file as PATCHPULSE_API_KEY. Never commit raw credentials to public repositories or client-side bundles.

First Request

Fetch Live Patch Data

Authenticate using Bearer headers and query the /v1/titles/{slug}/patches endpoint. The API returns structured JSON containing weapon stats, hero adjustments, and map rotations.

Below are baseline examples for Python and JavaScript. Replace YOUR_API_KEY with your live credential.

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://api.patchpulse.io/v1/titles/league-of-legends/patches/14.8",
    headers=headers
)

data = response.json()
print(f"Patch Date: {data['metadata']['release_date']}")
for change in data['champions']['kayn']['abilities']:
    print(f"{change['name']}: {change['diff_summary']}")

const response = await fetch(
  "https://api.patchpulse.io/v1/titles/valorant/patches/ep9_act2",
  {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Accept": "application/json"
    }
  }
);

const patch = await response.json();
console.log(`Region: ${patch.metadata.region}`);
patch.agents["fade"].passives.forEach(p => {
  console.log(`${p.name}: ${p.stat_delta}`);
});

Rate limits are set to 1,200 requests per hour for free tiers and 10,000 for Pro. Implement exponential backoff if you encounter 429 Too Many Requests responses.