Polymarket MCP

🚀 PolyMarket: A Decentralized Prediction Market Platform on the Polygon Network

PolyMarket is a decentralized prediction market platform built on the Polygon network. It allows users to create and trade tokens related to real - world events. Users can place bets based on their confidence in event outcomes and profit from fluctuations in token prices.

🚀 Quick Start

Introduction to the Polygon Protocol (MCP) Server

The PolyMarket Polygon Protocol (MCP) server is a proxy server connected to the PolyMarket API, aiming to provide users with data interfaces for prediction markets. The server offers the following features:

• Real - time data: Get the latest price and trading information of the current market.
• Detailed information: Query basic information about a specific market, including event descriptions and time limits.
• Historical data: Review market historical data within a specified time period to understand price fluctuation trends.

✨ Features

Flexibility

The MCP server supports multiple interface call methods, allowing users to choose the appropriate one according to their needs.

Efficiency

By optimizing the API call process and adopting an efficient caching mechanism, it ensures the speed and response time of data queries.

Scalability

The system architecture is flexibly designed and can be horizontally expanded according to business needs to meet the performance requirements in high - concurrency scenarios.

📦 Installation

Prerequisites

• Ensure that Python 3.9 or a higher version is installed.
• Verify that the httpx library is installed. If not, use the following command to install it:

pip install httpx>=0.24.0

• Install mcp - core and python - dotenv:

pip install mcp - core python - dotenv>=1.0.0

Code Example

The steps to initialize the MCP proxy server are as follows:

from mcp_core import MP

# Initialize the proxy
mp = MP()

# Connect to the PolyMarket network
await mp.connect()

# Get information about all current markets
markets = await mp.list_markets()

Local Running Guide

# Clone the MCP project repository
git clone https://github.com/poly_market/mcp.git

# Enter the project directory
cd mcp

# Install dependencies
pip install -r requirements.txt

# Start the server
python3 server.py

📚 Documentation

Get Market List

Function Description

Get information about all available markets on the current PolyMarket platform.

Input Parameters

No parameters are required.

Return Value

Returns JSON - formatted data containing the following fields:

• id: Unique market identifier
• event_name: Event name
• description: Event description
• start_time: Event start time (in ISO 8601 format)
• end_time: Event end time (in ISO 8601 format)

Example Response

[
    {
        "id": "market_1",
        "event_name": "2024 US Presidential Election Result",
        "description": "Predict who will win the 2024 US presidential election.",
        "start_time": "2023-01-01T00:00:00Z",
        "end_time": "2024-11-08T23:59:59Z"
    }
]

Get Market Details

Function Description

Query detailed information about a specified market.

Input Parameters

• market_id: Unique market identifier (string type)

Return Value

Returns JSON - formatted data containing the following fields:

• id: Unique market identifier
• event_name: Event name
• description: Event description
• start_time: Event start time (in ISO 8601 format)
• end_time: Event end time (in ISO 8601 format)
• outcomes: Possible event outcomes and their corresponding price information

Example Response

{
    "id": "market_1",
    "event_name": "2024 US Presidential Election Result",
    "description": "Predict who will win the 2024 US presidential election.",
    "start_time": "2023-01-01T00:00:00Z",
    "end_time": "2024-11-08T23:59:59Z",
    "outcomes": [
        {
            "outcome_id": "outcome_1",
            "label": "Joe Biden wins",
            "probability": 0.7,
            "price": 0.65
        },
        {
            "outcome_id": "outcome_2",
            "label": "Donald Trump wins",
            "probability": 0.3,
            "price": 0.45
        }
    ]
}

Get Market Historical Data

Function Description

Query market historical data within a specified time period.

Input Parameters

• market_id: Unique market identifier (string type)
• start_time: Data start time (in ISO 8601 format, optional, default is the earliest recorded time)
• end_time: Data end time (in ISO 8601 format, optional, default is the current time)

Return Value

Returns a list of JSON - formatted data, where each item contains the following fields:

• timestamp: Timestamp
• price: Market price at that time
• volume: Trading volume at that time

Example Response

[
    {
        "timestamp": "2023-10-01T00:00:00Z",
        "price": 0.65,
        "volume": 1234.56
    }
]

Error Handling

Error Codes

The following are common error codes and their meanings:

Error Response Example

{
    "error": {
        "code": 400,
        "message": "Parameter market_id is missing or invalid"
    }
}

Further Documentation

For more detailed information, please refer to the official documentation.

Contribution Guidelines

We welcome community developers to participate in project development, contribute code, or provide suggestions. Please visit the GitHub repository for more information.

⚠️ Important Note

Before using this API, please carefully read and comply with PolyMarket's terms of service and usage guidelines to ensure that all operations are legal and compliant.