[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![MIT License][license-shield]][license-url]

Polymarket Agents

使用 AI Agent 在 Polymarket 上进行自动交易。

探索文档 »

查看演示 · 报告 Bug · 功能请求

Polymarket Agents

Polymarket Agents 是一个开发框架和实用工具集，用于构建在 Polymarket 上运行的 AI Agent。

本代码在 MIT License 开源协议下免费公开可用（参见 服务条款）！

特性

• 集成 Polymarket API
• 用于预测市场的 AI Agent 实用工具
• 支持本地和远程 RAG（检索增强生成）
• 从博彩服务、新闻提供商和网络搜索中获取数据
• 包含用于 Prompt Engineering（提示词工程）的全面 LLM 工具

入门指南

本项目旨在 Python 3.9 环境下使用。

1. 克隆仓库

   git clone https://github.com/{username}/polymarket-agents.git
   cd polymarket-agents
   

2. 创建虚拟环境

   virtualenv --python=python3.9 .venv
   

3. 激活虚拟环境

   • Windows:

   .venv\Scripts\activate
   

   • macOS 和 Linux:

   source .venv/bin/activate
   

4. 安装依赖：

   pip install -r requirements.txt
   

5. 设置环境变量：

   • 在项目根目录创建 .env 文件

   cp .env.example .env
   

   • 添加以下环境变量：

   POLYGON_WALLET_PRIVATE_KEY=""
   OPENAI_API_KEY=""
   

6. 为你的钱包充值 USDC。

7. 尝试使用命令行界面（CLI）...

   python scripts/python/cli.py
   

   或者直接开始交易！

   python agents/application/trade.py
   

8. 注意：如果在 Docker 之外运行，请设置以下环境变量：

   export PYTHONPATH="."
   

   如果更倾向于使用 Docker 运行，我们提供了以下脚本：

   ./scripts/bash/build-docker.sh
   ./scripts/bash/run-docker-dev.sh
   

架构

Polymarket Agents 的架构采用模块化组件，方便社区成员维护和扩展。

API

Polymarket Agents 连接器标准化了数据源和订单类型。

• Chroma.py: 用于向量化新闻源和其他 API 数据的 Chroma DB。开发者可以添加自定义的向量数据库实现。

• Gamma.py: 定义了 GammaMarketClient 类，用于与 Polymarket Gamma API 交互，以获取并解析市场和事件元数据。包含检索当前市场、可交易市场以及特定市场/事件详细信息的方法。

• Polymarket.py: 定义了 Polymarket 类，用于与 Polymarket API 交互以获取和管理市场/事件数据，并在 Polymarket DEX 上执行订单。它包括 API 密钥初始化、市场和事件数据检索以及交易执行的方法。该文件还提供用于构建和签名订单的实用函数，以及测试 API 交互的示例。

• Objects.py: 使用 Pydantic 定义的数据模型；包含对交易、市场、事件及相关实体的表示。

脚本

用于管理本地环境、设置远程运行服务器以及终端用户命令行交互的文件。

cli.py 是仓库的主要用户界面。用户可以通过运行各种命令与 Polymarket API 交互、检索相关新闻文章、查询本地数据、向 LLM 发送数据/提示词以及在 Polymarkets 执行交易。

命令格式如下：

python scripts/python/cli.py command_name [attribute value] [attribute value]

示例：

get-all-markets 检索并显示 Polymarket 的市场列表，按交易量排序。

python scripts/python/cli.py get-all-markets --limit  --sort-by 

• limit: 要检索的市场数量（默认值：5）。
• sort_by: 排序标准，可以是 volume（默认）或其他有效属性。

贡献

如果你想为本项目做出贡献，请遵循以下步骤：

1. Fork 本仓库。
2. 创建一个新的分支。
3. 提交你的修改。
4. 发起 Pull Request。

在贡献代码前，请运行 pre-commit 钩子。初始化命令如下：

pre-commit install

相关仓库

• py-clob-client: Polymarket CLOB 的 Python 客户端
• python-order-utils: 用于生成和签名 Polymarket CLOB 订单的 Python 工具
• Polymarket CLOB client: Polymarket CLOB 的 Typescript 客户端
• Langchain: 构建上下文感知推理应用程序的工具
• Chroma