Quickstart

Prerequisites

Before you begin, make sure you have:

Polymarket Account

A Polymarket account with a Magic Proxy Safe wallet. Sign up at Polymarket if you don’t have one.

USDC Balance

Some USDC in your Polymarket wallet for trading. You’ll also need a small amount of MATIC for gas fees.

OpenClaw Agent (Optional)

If using with AI agents, install ClawdBot or another compatible agent.

Step 1: Create Your Account

Email
Social Login
Passkey

Go to luckylobster.io/signup
Enter your email and create a password
Verify your email address
Enable 2FA for additional security (recommended)

Step 2: Connect Your Wallet

After signing in, you need to connect your Polymarket wallet.

You’ll need the private key from your Polymarket Magic Safe wallet. This key is encrypted and stored securely, but handle it with care.

Navigate to Dashboard > Wallets
Click Import Wallet
Enter your wallet details:
- Private Key: Your Magic Safe EOA private key
- Proxy Address: Your Polymarket proxy/Safe address

# Your private key looks like this (keep it secret!)
0x1234567890abcdef...

# Your proxy address looks like this
0xABCD...1234

Click Import & Verify
LuckyLobster will verify the wallet and check balances

Your wallet is now connected! You can see your USDC and MATIC balances.

Step 3: Generate an API Key

API keys let your AI agents authenticate with LuckyLobster.

Navigate to Dashboard > API Keys
Click Create New API Key
Configure your key:

Setting	Recommended	Description
Name	”ClawdBot Trading”	Identify which agent uses this key
Permissions	`read`, `trade`	Start with essential permissions
Budget Limit	$50	Maximum total spend for this key
Rate Limit	100/min	Requests per minute

Click Create Key
Copy your API key immediately - it won’t be shown again!

# Your API key format
ll_live_abc123xyz789...

Start with a small budget limit (

50-

100) while testing. You can increase it later once you’re confident in your setup.

Step 4: Install the Skill (For AI Agents)

If you’re using OpenClaw or another compatible agent:

ClawHub
Manual

Visit ClawHub Skills
Search for “LuckyLobster”
Click Install
Enter your API key when prompted

Point your agent to the skill file:

https://luckylobster.io/skill.md

Configure the API key in your agent’s settings:

skills:
  - name: luckylobster
    url: https://luckylobster.io/skill.md
    config:
      api_key: ll_live_abc123xyz789...

Step 5: Make Your First Trade

Via Agent
Via API

Tell your AI agent:

“Search for Bitcoin prediction markets and buy $10 of YES on the most liquid one”

The agent will:

Search markets using /markets/search?q=bitcoin
Analyze liquidity and find the best market
Place a BUY order via /orders
Report back with the order status

Test directly with curl:

# Search for markets
curl -X GET "https://luckylobster.io/api/agent/v1/markets/search?q=bitcoin" \
  -H "Authorization: Bearer ll_live_abc123xyz789..."

# Check your balance
curl -X GET "https://luckylobster.io/api/agent/v1/balance" \
  -H "Authorization: Bearer ll_live_abc123xyz789..."

# Place a test order (dry run)
curl -X POST "https://luckylobster.io/api/agent/v1/orders" \
  -H "Authorization: Bearer ll_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "tokenId": "TOKEN_ID_HERE",
    "side": "BUY",
    "price": 0.55,
    "size": 10,
    "type": "LIMIT",
    "dryRun": true
  }'

Next Steps

Skill Reference

Full skill.md documentation for agents

API Reference

Complete API documentation

Budget Limits

Configure spending controls

Authentication

Security and auth details

Troubleshooting

Order fails with 'insufficient balance'

Check your wallet balance at Dashboard > Wallets or via the /balance API endpoint. Make sure you have enough USDC for the order plus some MATIC for gas.

Order fails with 'budget exceeded'

Your API key has reached its spending limit. Either:

Wait for the budget period to reset
Increase the budget limit in Dashboard > API Keys
Create a new API key with a higher budget

API returns 401 Unauthorized

Verify your API key is correct and hasn’t been revoked
Check the key hasn’t expired
Ensure you’re using Bearer auth: Authorization: Bearer ll_live_...

Order stuck in PENDING status

Market orders should fill quickly. For limit orders:

Check if your price is competitive using /orderbook or /spread
Consider using MARKET or FOK order types for immediate execution

Getting Started

Platform

Prerequisites

Step 1: Create Your Account

Step 2: Connect Your Wallet

Step 3: Generate an API Key

Step 4: Install the Skill (For AI Agents)

Step 5: Make Your First Trade

Next Steps

Skill Reference

API Reference

Budget Limits

Authentication

Troubleshooting

Getting Started

Platform

​Prerequisites

​Step 1: Create Your Account

​Step 2: Connect Your Wallet

​Step 3: Generate an API Key

​Step 4: Install the Skill (For AI Agents)

​Step 5: Make Your First Trade

​Next Steps

Skill Reference

API Reference

Budget Limits

Authentication

​Troubleshooting

Prerequisites

Step 1: Create Your Account

Step 2: Connect Your Wallet

Step 3: Generate an API Key

Step 4: Install the Skill (For AI Agents)

Step 5: Make Your First Trade

Next Steps

Troubleshooting