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

# Platform Overview

> AI-powered on-chain agent infrastructure for Arbitrum

ouroborai is an AI agent that translates natural language into on-chain DeFi
actions on Arbitrum. Describe what you want -- swap tokens, open a leveraged
position, supply collateral, bid for express lane priority -- and the agent
decomposes your intent into protocol-specific tool calls executed through an
ERC-4337 smart account.

<Note>
  Every API request costs a flat **\$0.01 USDC** via the
  [x402 micropayment protocol](/docs/agent-api/x402-payments), settled on Arbitrum
  One. No subscriptions, no API keys to manage -- just attach a payment header.
</Note>

## What You Can Do

<CardGroup cols={3}>
  <Card title="Spot Trading" icon="arrow-right-arrow-left" href="/docs/features/trading">
    Swap any ERC-20 pair through Uniswap V3 on Arbitrum with automatic route
    optimization.
  </Card>

  <Card title="Perpetuals" icon="chart-line-up" href="/docs/features/perpetuals">
    Open, manage, and close leveraged long/short positions on GMX V2 markets.
  </Card>

  <Card title="Lending" icon="building-columns" href="/docs/features/lending">
    Supply collateral, borrow assets, and monitor health factors on Aave V3.
  </Card>

  <Card title="TimeBoost" icon="bolt" href="/docs/features/timeboost">
    Bid for Arbitrum express lane priority to front-run your own transactions
    and capture MEV.
  </Card>

  <Card title="RWA Stocks" icon="chart-mixed" href="/docs/features/rwa-stocks">
    Scan and trade tokenized real-world-asset equities on Robinhood Chain
    (chain 46630).
  </Card>

  <Card title="Smart Accounts" icon="shield-halved" href="/docs/features/smart-accounts">
    ERC-4337 session keys with spending limits -- delegate execution without
    exposing your private key.
  </Card>
</CardGroup>

## How It Works

The platform follows a three-stage pipeline:

1. **Intent** -- You send a natural language prompt (e.g. "Swap 100 USDC for
   ARB and supply the ARB to Aave").
2. **Decomposition** -- The Claude-backed agent runner identifies the required
   skills, selects the right protocol adapters, and plans a sequence of tool
   calls.
3. **Execution** -- Each tool call is dispatched to an adapter (Uniswap V3,
   GMX V2, Aave V3, etc.) that builds and submits transactions through the
   user's ZeroDev Kernel smart account.

The agent maintains conversational context via persistent threads, so
follow-up prompts like "Now close half that position" resolve correctly.

## Architecture at a Glance

```
User (Web / Telegram / CLI / MCP)
  |
  v
Hono API Server --- x402 payment gate ($0.01 USDC)
  |
  v
Agent Runner (Claude) --- Skill detection + tool dispatch
  |
  v
Protocol Adapters --- UniswapV3 | GmxV2 | AaveV3 | RWA | TimeBoost
  |
  v
ZeroDev Kernel (ERC-4337) --- Session keys + spending limits
  |
  v
Arbitrum One / Robinhood Chain
```

<Info>
  Performance-critical on-chain logic (route optimization, liquidation
  monitoring, TimeBoost vault management) runs in **Stylus contracts** --
  Rust compiled to WASM executing natively on the Arbitrum VM.
</Info>

## Access Methods

| Channel          | Description                                           |
| ---------------- | ----------------------------------------------------- |
| **Web Terminal** | Chat-based terminal UI at `ouroborai.com/app`         |
| **Telegram**     | `/trade`, `/perp`, `/portfolio` commands via bot      |
| **Twitter**      | Mention `@ouroborai` with a trading intent            |
| **CLI**          | Pipe prompts directly from your terminal              |
| **MCP Server**   | 15-tool Model Context Protocol server for Claude Code |

## Payment Model

ouroborai uses the **x402** HTTP payment protocol. Every request to a paid
endpoint includes a `X-PAYMENT` header containing a signed USDC authorization
for \$0.01. The server verifies the signature, checks nonce uniqueness (via
Redis with 24-hour TTL), and settles payment on-chain before processing the
request.

No accounts, no rate limits, no monthly invoices -- just pay per request.

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/docs/getting-started/quickstart">
    Get a local instance running in 5 minutes.
  </Card>

  <Card title="Architecture Deep Dive" icon="sitemap" href="/docs/getting-started/architecture">
    Understand the request lifecycle, adapter pattern, and state management.
  </Card>

  <Card title="API Reference" icon="code" href="/docs/reference/api-endpoints">
    Full REST API documentation with request/response examples.
  </Card>

  <Card title="Add a Skill" icon="puzzle-piece" href="/docs/guides/add-a-skill">
    Extend the agent with custom protocol integrations.
  </Card>
</CardGroup>