solvegate — Python SDK

Official client for the SolveGate API — clear Cloudflare Turnstile + WAF challenges and get a token back. Zero dependencies (stdlib only); wraps auth, the error envelope, 429 backoff, and async polling.

pip install solvegate

import os
from solvegate import SolveGate

sg = SolveGate(os.environ["SOLVEGATE_KEY"])  # sg_live_… or a free sg_test_… sandbox key

# Synchronous — blocks until solved (or raises on timeout):
res = sg.solve(gate="turnstile", sitekey="0x4AAAAAAAAA_target", url="https://app.example.com")
print(res.token, res.solve_ms)

# Asynchronous — return immediately, then poll:
pending = sg.solve(gate="turnstile", sitekey=sitekey, url=url, async_=True)
solved = sg.wait(pending.id)
if solved.status == "solved":
    use(solved.token)

# Retrieve any solve by id:
s = sg.retrieve("slv_8Kd2aF9")

API

Solve has .id .status .gate .token .solve_ms .expires_at .billed. Errors raise SolveGateError with .code / .status / .billed (e.g. balance_empty, rate_limited, solve_timeout). Note async_ (trailing underscore) maps to the API's async field. You're only billed for a successful solve.