py-builder-relayer-client

What it is and what it does

py-builder-relayer-client is a thin Python wrapper around the Polymarket Relayer API, designed to simplify submitting transactions to Polymarket's infrastructure from Python applications. It handles Ethereum account management and signing via eth-account and eth-abi, manages API authentication with Builder credentials, and abstracts HTTP communication through requests.

The library is intended for developers building applications on Polymarket who need to relay transactions through Polymarket's infrastructure rather than submitting directly to the blockchain. It requires Python 3.9 or later and depends on a working Ethereum signing setup, making it most useful in contexts where you already have private keys and Builder API credentials configured.

Use it for:

• Submit prediction market orders to Polymarket via the relayer without managing raw HTTP requests.
• Automate transaction signing and relay submission in trading bots or market-making applications.
• Integrate Polymarket transaction submission into larger Python applications with minimal boilerplate.
• Test relayer integration during development using the staging relayer endpoint.
• Manage multiple transaction submissions with consistent authentication and error handling.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for submitting transactions and interacting with the Polymarket Relayer infrastructure, handling authentication and API communication with Ethereum-based signing.

Yes, if you are building on Polymarket and need to relay transactions through their infrastructure. The library has low install friction, active maintenance, MIT licensing, and no known vulnerabilities. It is narrow in scope—designed specifically for Polymarket Relayer interaction—so install only if that is your use case. The early version number (0.0.2) and small repository suggests it may still be evolving.

Install

py-builder-relayer-client on PyPI

pip install py-builder-relayer-client

uv add py-builder-relayer-client

poetry add py-builder-relayer-client

Installing py-builder-relayer-client

Before you install

Low friction install with seven runtime dependencies including eth-account, eth-utils, and requests. Active maintenance with a recent commit on 2026-05-29 and no archived status.

License in practice

MIT license permits commercial and private use with minimal restrictions; suitable for most deployment contexts.

Quickstart

pip install py-builder-relayer-client

from py_builder_relayer_client import RelayerClient

client = RelayerClient(
    relayer_url="https://relayer-v2-staging.polymarket.dev/",
    chain_id=80002,
    private_key="your_private_key",
    api_key="your_api_key",
    api_secret="your_api_secret",
    passphrase="your_passphrase"
)

Requires Python 3.9 or later; credentials must be provided via environment variables or constructor parameters (RELAYER_URL, CHAIN_ID, PK, BUILDER_API_KEY, BUILDER_SECRET, BUILDER_PASS_PHRASE).

Verify before relying

• Specific API methods and transaction types supported by the relayer client beyond basic submission.
• Error handling and retry behavior for failed relay submissions.
• Rate limiting or quota constraints imposed by the Polymarket Relayer service.
• Whether the library supports multiple blockchain networks or only Polygon (chain 80002).

Package facts

Evidence: py_builder_relayer_client-0.0.2-py3-none-any.whl

Tags

More Internet packages