Download the PHP package danielgnh/polymarket-php without Composer

Polymarket PHP SDK

Polymarket API PHP SDK for interacting with the prediction markets and managing orders.

You can search for the markets, events, create / delete orders, send concurrent requests and much more.

What is polymarket?

Requirements

• PHP 8.1 or higher
• Composer

Installation

Install the package via Composer:

Configuration

Add your polymarket credentials to your .env file:

Here is documentation how to export you private key

Quick Start

API Architecture

Polymarket uses three separate API systems:

• Gamma API (https://gamma-api.polymarket.com) - Read-only market data
• CLOB API (https://clob.polymarket.com) - Trading operations and order management
• Bridge API (https://bridge-api.polymarket.com) - Cross-chain deposits and funding

The SDK provides separate client interfaces for each:

API Reference

Client Initialization

Configuration Options

The SDK supports the following configuration options:

Markets (Gamma API)

The Markets resource provides access to prediction market data via the Gamma API.

List Markets

Parameters:

• filters (array, optional): Filtering options for markets
• limit (int, optional): Maximum number of results (default: 100)
• offset (int, optional): Pagination offset (default: 0)

Returns: Array of market data

Get Market by ID

Parameters:

• marketId (string): The unique identifier of the market

Returns: Market data array

Search Markets

Parameters:

• query (string): Search query string
• filters (array, optional): Additional filtering options
• limit (int, optional): Maximum number of results (default: 100)

Returns: Array of matching markets

Orders (CLOB API)

The Orders resource handles order management and execution via the CLOB API.

List Orders

Parameters:

• filters (array, optional): Filtering options for orders
• limit (int, optional): Maximum number of results (default: 100)
• offset (int, optional): Pagination offset (default: 0)

Returns: Array of order data

Get Order by ID

Parameters:

• orderId (string): The unique identifier of the order

Returns: Order data array

Create Order

Parameters:

• orderData (array): Order details including:
  • market_id (string): Target market identifier
  • side (string): Order side - use OrderSide enum
  • type (string): Order type - use OrderType enum
  • price (string): Order price as decimal string
  • amount (string): Order amount as decimal string

Important: Always use strings for price and amount values to maintain decimal precision.

Returns: Created order data array

Cancel Order

Parameters:

• orderId (string): The unique identifier of the order to cancel

Returns: Cancellation result data

Bridge (Cross-Chain Deposits)

The Bridge API enables you to fund your Polymarket account from multiple blockchains including Ethereum, Arbitrum, Base, Optimism, Solana, and Bitcoin. All deposits are automatically converted to USDC.e on Polygon.

Get Supported Assets

Retrieve information about supported chains, tokens, and minimum deposit amounts:

Returns: Array containing:

• chains (array): List of supported blockchain networks
  • id (int): Chain ID
  • name (string): Chain name (e.g., "Ethereum", "Arbitrum")
  • type (string): Chain type (e.g., "evm", "solana", "bitcoin")
• tokens (array): List of supported tokens per chain
  • symbol (string): Token symbol (e.g., "USDC", "ETH")
  • name (string): Token full name
  • minimum_usd (string): Minimum deposit amount in USD
• minimums (array): Global minimum deposit thresholds

Generate Deposit Addresses

Generate unique deposit addresses for cross-chain funding:

Parameters:

• depositData (array): Deposit request data
  • destination_address (string, required): Your Polygon wallet address where USDC.e will be sent
  • amount_usd (string, required): Deposit amount in USD

Returns: Array of deposit addresses:

• evm (string): Ethereum-compatible address for EVM chains (Ethereum, Arbitrum, Base, etc.)
• solana (string): Solana blockchain address
• bitcoin (string): Bitcoin blockchain address

Important Security Notes:

• Always verify your destination address is correct before sending funds
• Each deposit address is unique and tied to your destination address
• Minimum deposit amounts apply (typically $10 USD equivalent)
• Test with small amounts first

Supported Blockchains

EVM-Compatible Chains:

• Ethereum Mainnet
• Arbitrum One
• Base
• Optimism
• Polygon (direct deposits)
• BNB Chain
• Avalanche C-Chain

Other Chains:

• Solana
• Bitcoin

Deposit Workflow

1. Call supportedAssets() to check supported tokens and minimum amounts
2. Generate deposit addresses using generate() with your Polygon address
3. Send assets to the provided address for your chosen blockchain
4. Bridge service automatically detects and processes the deposit
5. Assets are converted to USDC.e and sent to your Polygon address
6. You can now trade on Polymarket

Processing Times:

• EVM chains: ~1-5 minutes
• Solana: ~30 seconds
• Bitcoin: ~30-60 minutes

Complete Example

For a complete working example, see examples/bridge-deposit.php.

Error Handling

The SDK provides a comprehensive exception hierarchy for handling different error scenarios:

Enums

The SDK provides type-safe enums for API fields with fixed value sets, ensuring compile-time safety and better IDE autocomplete.

Available Enums

OrderSide

Specifies whether you're buying or selling shares:

OrderType

Determines the execution behavior of an order:

OrderStatus

Indicates the current state of an order:

SignatureType

For order authentication methods:

Usage Example

Working with Decimal Values

When working with financial data (prices, amounts), always use string representation to maintain precision:

Concurrent Requests

For improved performance when fetching multiple resources, use the concurrent methods.

Batch Fetching

Fetch multiple items in parallel with automatic concurrency control:

Promise-Based API

For custom workflows, use the async methods that return promises:

Available Async Methods

Gamma Markets:

• getAsync(string $marketId) - Get single market
• getBySlugAsync(string $slug) - Get market by slug
• listAsync(array $filters, int $limit, int $offset) - List markets
• getMany(array $marketIds, int $concurrency) - Batch fetch by ID
• getManyBySlug(array $slugs, int $concurrency) - Batch fetch by slug

CLOB Markets:

• getAsync(string $conditionId) - Get single market
• listAsync(array $params) - List markets
• getMany(array $conditionIds, int $concurrency) - Batch fetch

CLOB Orders:

• getAsync(string $orderId) - Get single order
• listAsync(array $filters, int $limit, int $offset) - List orders
• getOpenAsync(array $params) - Get open orders
• getMany(array $orderIds, int $concurrency) - Batch fetch
• cancelMany(array $orderIds, int $concurrency) - Batch cancel

Configuration

Configure default concurrency and timeout:

Development

Running Tests

Code Style

Format code using PHP CS Fixer:

Check code style without making changes:

Static Analysis

Run PHPStan for static analysis:

Test Coverage

Generate test coverage report:

Coverage reports will be generated in the coverage/ directory.

Contributing

Contributions are welcome! Please follow these guidelines:

1. Follow PSR-12 coding standards
2. Write tests for new features
3. Run composer cs-fix before committing
4. Ensure all tests pass with composer test
5. Run static analysis with composer phpstan

Security

If you discover any security-related issues, please email [email protected] instead of using the issue tracker.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Credits

• Author: Daniel Goncharov
• Email: [email protected]

Resources

• Polymarket Official Website
• Polymarket API Documentation
• Package on Packagist

Support

For bugs and feature requests, please use the GitHub issue tracker.