Project Zipo - Polymarket Trading Bot

Setup

1. Create Virtual Environment

python -m venv venv
source venv/bin/activate

2. Install Dependencies

pip install -r requirements.txt

3. Get Your Private Key

Export your private key from your wallet (e.g., MetaMask):

1. Open MetaMask
2. Click the three dots → Account Details
3. Click Show Private Key
4. Enter your password and copy the key

4. Get Your Funder Address

Get your Polymarket proxy wallet address from the UI:

1. Go to polymarket.com
2. Click on your profile → Settings
3. Click Deposit
4. Copy the Deposit Address - this is your FUNDER_ADDRESS

5. Create .env File

Create a .env file in the project root:

touch .env

Add your private key and funder address:

PRIVATE_KEY=0x_your_private_key_here
FUNDER_ADDRESS=0x_your_deposit_address_here

6. Generate API Credentials

Run the script to generate Polymarket API credentials:

python utils/getApiStuff.py

This will output:

API_KEY=xxx
API_SECRET=xxx
API_PASSPHRASE=xxx

7. Update .env File

Add the generated credentials to your .env file:

PRIVATE_KEY=0x_your_private_key_here
FUNDER_ADDRESS=0x_your_deposit_address_here
API_KEY=your_api_key
API_SECRET=your_api_secret
API_PASSPHRASE=your_api_passphrase

8. Verify Setup

Test your API keys:

python testUtils/getBalanceTest.py

Security

⚠️ Never commit your .env file or share your private key.

• The .env file is already in .gitignore
• Use a dedicated wallet with limited funds for trading bots
• API keys don't expire but can be regenerated

Signature Types

Type	Description
0	EOA (direct wallet)
1	Polymarket proxy wallet
2	Polymarket browser/magic wallet

Most users who trade via polymarket.com use type 2.