---
id: py-builder-relayer-client
version: "0.0.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# py-builder-relayer-client — Python client library for interacting with the Polymarket Relayer infrastructure

License: permissive · Maintenance: active · Downloads: 140.1K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 140.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

polymarket relayer client, ethereum transaction relayer, blockchain api client python, eth transaction submission, polymarket python sdk, relayer infrastructure client, web3 transaction relay, polymarket, ethereum-client, transaction-relay

[View on SkillFed](https://skillfed.io/packages/py-builder-relayer-client) · [View on PyPI](https://pypi.org/project/py-builder-relayer-client/)