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.

Funded Polymarket Account

USDC deposited into your Polymarket wallet. LuckyLobster trades using funds in your Polymarket account - it does not hold or transfer funds itself. How to deposit USDC on Polymarket.

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 > Settings > 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 balance.

Step 3: Link Your AI Agent

API keys are generated automatically when an AI agent links to your account through the device authorization flow.

ClawHub (Recommended)
Manual Skill Install
Direct API

Visit ClawHub Skills
Search for “LuckyLobster”
Click Install
Your agent will initiate the device flow automatically
Approve the link when prompted

Point your agent to the skill file:

https://luckylobster.io/skill.md

Your agent will read the skill and initiate the device flow:

Agent calls POST /api/auth/device and shows you a link with a code
Visit the link and approve the connection
Agent receives its ll_* API key automatically

If you’re building your own integration:

# 1. Request device code
curl -X POST "https://luckylobster.io/api/auth/device" \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "My Agent"}'

# Response includes user_code and verification_uri_complete
# 2. Visit the link and approve
# 3. Poll for the API key
curl "https://luckylobster.io/api/auth/device/token?device_code=abc123..."

See the Skill Reference for the complete flow.

Once linked, configure your agent’s budget at Dashboard > Manage Agents.

Start with a small budget limit while testing. You can increase it later once you’re confident in your setup.

Step 4: 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_abc123..."

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

# Place a test order (dry run)
curl -X POST "https://luckylobster.io/api/agent/v1/orders" \
  -H "Authorization: Bearer ll_abc123..." \
  -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 > Settings > Wallets or via the /balance API endpoint. Make sure you have enough USDC for the order. If you need to add funds, deposit through Polymarket directly - see How to Deposit.

Order fails with 'budget exceeded'

Your agent has reached its spending limit. Either:

Increase the budget limit in Dashboard > Manage Agents
Wait for position values to decrease (if using percentage-based budget)

API returns 401 Unauthorized

Verify the agent’s API key hasn’t been revoked
Check if the agent is paused in Dashboard > Manage Agents
Ensure you’re using Bearer auth: Authorization: Bearer ll_...

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: Link Your AI Agent

Step 4: 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: Link Your AI Agent

​Step 4: 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: Link Your AI Agent

Step 4: Make Your First Trade

Next Steps

Troubleshooting