Grip Protocol API v0.3.0

Gaming Incident Intelligence platform. Real-time friction detection, player stress indexing, and verified solution matching across PC, console, and handheld platforms.

https://api.gamegrip.cloud

Authentication

The API is currently open during the v0.3 preview period. No authentication required. Rate limiting applies: 100 requests/minute per IP.

GET

System Status

/v1/status

Health check endpoint. Returns version, uptime, active incident count, and average PSI across all monitored games.

cURL
curl https://api.gamegrip.cloud/v1/status
Response — 200 OK
{ "status": "gripping", "version": "0.3.0", "service": "grip-protocol-api", "active_incidents": 10, "avg_psi": 98.1, "total_signals_ingested": 10, "total_raw_events": 10 }
⚡ Try it →
GET

Live Hotspots

/v1/live/hotspots

Active friction hotspots ranked by Player Stress Index. Returns the current incidents breaking players across all monitored games and platforms.

ParameterTypeRequiredDescription
limit integer OPTIONAL Max results to return. Default: 20
cURL
curl "https://api.gamegrip.cloud/v1/live/hotspots?limit=5"
Response — 200 OK
[ { "game_id": "elden-ring", "game_name": "Elden Ring", "platform": "pc", "category": "difficulty_spike", "severity": 9.7, "psi": 100.0, "heat_level": "🔥 Meltdown", "players_affected": 8500, "trend": "+302%", "verified_fix": true, "time_to_solution": "12m 0s", "summary": "Malenia Phase 2 Waterfowl Dance..." } ]
⚡ Try it →
GET

Active Signals

/v1/signals/active

Raw signal data from the ingestion pipeline. Unprocessed friction signals before PSI scoring.

cURL
curl https://api.gamegrip.cloud/v1/signals/active
⚡ Try it →
POST

Friction Scan

/v1/friction/scan

Analyze a player-reported issue. Returns friction score, category classification, probable root causes, and matched fixes from the verified solution database.

FieldTypeRequiredDescription
game string REQUIRED Game name (e.g. "Elden Ring", "Helldivers 2")
platform string OPTIONAL Platform: pc, ps5, xbox, steam_deck_oled, etc.
issue string REQUIRED Natural language description of the issue
cURL
curl -X POST https://api.gamegrip.cloud/v1/friction/scan \ -H "Content-Type: application/json" \ -d '{ "game": "Elden Ring", "platform": "pc", "issue": "fps drops during boss fights" }'
Response — 200 OK
{ "friction_score": 7.2, "category": "performance", "probable_causes": [ "VRAM allocation", "Thermal throttling", "Driver issue" ], "recommended_fixes": [{ "title": "Elden Ring Performance Fix", "steps": ["Disable Steam overlay", "Set EAC to Background", ...], "verified": true }], "psi": 39.6 }
POST

Solve

/v1/solve

Match a problem to verified community solutions. Returns fix steps, estimated time to resolution, and PSI impact score.

FieldTypeRequiredDescription
game string REQUIRED Game name
problem string REQUIRED Problem description to match against solutions
cURL
curl -X POST https://api.gamegrip.cloud/v1/solve \ -H "Content-Type: application/json" \ -d '{"game": "Elden Ring", "problem": "malenia waterfowl dance"}'
Response — 200 OK
{ "fixes": [{ "title": "Malenia - Bloodhound Step Dodge", "steps": [ "Equip Bloodhound Step Ash of War", "Wait for jump animation", "Dodge backward then sideways", "Punish after 3rd flurry" ], "time_to_solution": "12m 0s", "verified": true }], "estimated_time": "12 mins", "verified": true, "psi_impact": 42.2 }
POST

Device Optimize

/v1/device/optimize

Handheld optimization engine. Returns tuned settings for TDP, FPS cap, upscaling, and estimated battery life per device + game combination.

FieldTypeRequiredDescription
device string REQUIRED Device ID: steam_deck_oled, rog_ally, legion_go, switch_2, etc.
game string REQUIRED Game name
priority string OPTIONAL Optimization priority: battery | balanced | performance. Default: balanced
cURL
curl -X POST https://api.gamegrip.cloud/v1/device/optimize \ -H "Content-Type: application/json" \ -d '{ "device": "steam_deck_oled", "game": "Cyberpunk 2077", "priority": "balanced" }'
Response — 200 OK
{ "fps_cap": 30, "tdp": 13, "estimated_battery": "2h 18m", "settings": [ {"setting": "TDP Limit", "value": "13W"}, {"setting": "FPS Cap", "value": "30"}, {"setting": "Upscaling", "value": "FSR 2.1 Balanced"}, {"setting": "VSync", "value": "Adaptive"} ] }
POST

Events Ingest

/v1/events/ingest

Ingest raw telemetry events from any source — Reddit, Twitter/X, Discord, Steam forums, or in-game telemetry. Events are scored and may create new friction hotspots.

cURL
curl -X POST https://api.gamegrip.cloud/v1/events/ingest \ -H "Content-Type: application/json" \ -d '{ "source": "reddit", "signal": { "game_id": "elden-ring", "category": "performance", "severity_estimate": 8.5 }, "metrics": { "volume": 500 } }'
Response — 200 OK
{ "event_id": "evt_a1b2c3d4e5f6...", "status": "ingested", "signal_score": 9.3, "psi_contribution": 47.3, "hotspot_created": true, "processing_time_ms": 42 }