request

​

Signature

client.request(method: str, url: str, simulate: bool = False, response_mode: Optional = None, network: Optional = None, kwargs)

​

Parameters

• method: HTTP method (GET, POST, PUT, DELETE, etc.).
• url: Target API URL to access.
• simulate: If True, only simulate payment without executing (dry-run). Defaults to False.
• response_mode: Override response format (“text” or “json”). Uses instance default if not specified.
• network: Override network for relay mode payments.
• **kwargs: Additional request arguments. Common options:
• • json: JSON payload (forwarded through HTTPayer payment flow)
• • params: Query parameters (forwarded through HTTPayer)
• • headers: Custom headers (forwarded through HTTPayer)
• • timeout: Request timeout override (forwarded through HTTPayer)
• • Other kwargs (data, files, auth, cookies, etc.) are only used for the
• initial direct request attempt and NOT forwarded through HTTPayer payment flow.

​

Returns

​

Raises

• ValueError: If network is incompatible with wallet type or not supported.

​

Examples

>>> client = HTTPayerClient()
>>> # Basic request - auto-handles 402
>>> response = client.request("GET", "https://api.example.com/data")
>>> print(response.json())
>>> # Simulate first to check cost
>>> sim = client.request("GET", "https://api.example.com/data", simulate=True)
>>> print(f"Cost: {sim.json()['relayFeeBreakdown']['totalAmount']}")
>>> # POST with payload
>>> response = client.request(
...     "POST",
...     "https://api.example.com/process",
...     json={"input": "data"}
... )
>>> # Override network for this request
>>> response = client.request("GET", url, network="solana-devnet")