> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luckylobster.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Trade Polymarket with AI agents using LuckyLobster

## What is LuckyLobster?

LuckyLobster is a secure trading platform that enables AI agents to trade on [Polymarket](https://polymarket.com) on your behalf. Connect your wallet, generate API keys, and let your OpenClaw agents execute prediction market strategies.

<CardGroup cols={2}>
  <Card icon="rocket" href="/quickstart" title="Quickstart">
    Get trading in under 5 minutes
  </Card>

  <Card icon="scroll" href="/skill" title="Skill Reference">
    Install the LuckyLobster skill for your agent
  </Card>

  <Card icon="code" href="/api-reference/overview" title="API Reference">
    Full API documentation for developers
  </Card>

  <Card icon="puzzle-piece" href="https://clawhub.com/skills/luckylobster" title="ClawHub Registry">
    Add LuckyLobster to your agent
  </Card>
</CardGroup>

## Key Features

<AccordionGroup>
  <Accordion icon="shield-check" title="Secure Wallet Management">
    Your Polymarket Magic Proxy Safe wallet keys are encrypted with AES-256-GCM. Private keys never leave your account and are only decrypted server-side during order execution.
  </Accordion>

  <Accordion icon="robot" title="OpenClaw Agent Integration">
    Native integration with OpenClaw (ClawdBot, MoltBot) and other AI agents. Simply install the skill.md and your agent can start trading.
  </Accordion>

  <Accordion icon="chart-line" title="Budget Controls">
    Set spending limits per API key to control how much your agents can trade. Track P\&L and performance metrics in real-time.
  </Accordion>

  <Accordion icon="gears" title="Autonomous Strategies">
    Define trading rules (Price Alert, Recurring Buy, Buy Low Sell High) once and let the server execute them 24/7 - even when your agent is offline. [Learn more](/strategies).
  </Accordion>

  <Accordion icon="bolt" title="Low Latency Trading">
    Direct integration with Polymarket's Builder API for fast order execution. Support for LIMIT, MARKET, FOK, and FAK order types.
  </Accordion>
</AccordionGroup>

## How It Works

```mermaid theme={null}
sequenceDiagram
    participant Agent as AI Agent
    participant LL as LuckyLobster
    participant PM as Polymarket

    Agent->>LL: 1. Search markets (API key auth)
    LL->>PM: Query markets
    PM-->>LL: Market data
    LL-->>Agent: Markets with tokens

    Agent->>LL: 2. Place order
    LL->>LL: Validate budget & permissions
    LL->>PM: Submit signed order
    PM-->>LL: Order confirmation
    LL-->>Agent: Order status
```

1. **Sign Up** - Create an account and connect your Polymarket wallet
2. **Install Skill** - Add the LuckyLobster skill to your AI agent
3. **Link Agent** - Your agent uses the device flow to get an API key automatically
4. **Trade** - Your agent searches markets and places orders within budget limits

## Supported Order Types

| Type     | Description                                          |
| -------- | ---------------------------------------------------- |
| `LIMIT`  | Order remains on book until filled or cancelled      |
| `MARKET` | Executes immediately at best available price         |
| `FOK`    | Fill or Kill - must fill entirely or cancel          |
| `FAK`    | Fill and Kill - fills what's available, cancels rest |

## Security First

LuckyLobster is built with security as a core principle:

* **Encrypted Keys** - All private keys encrypted at rest with AES-256-GCM
* **Budget Limits** - Hard spending caps per API key
* **Permission Scopes** - Fine-grained control over API key capabilities
* **Rate Limiting** - Protection against abuse
* **Audit Logging** - All actions tracked for accountability

<Warning>
  LuckyLobster handles real funds on Polymarket. Always start with small amounts and test thoroughly before deploying with larger budgets.
</Warning>

## Get Help

<CardGroup cols={2}>
  <Card icon="discord" href="https://discord.gg/luckylobster" title="Discord Community">
    Join our community for help and updates
  </Card>

  <Card icon="envelope" href="mailto:support@luckylobster.io" title="Contact Support">
    Reach out for technical support
  </Card>
</CardGroup>