Skip to main content
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.
Every API request costs a flat $0.01 USDC via the x402 micropayment protocol, settled on Arbitrum One. No subscriptions, no API keys to manage — just attach a payment header.

​
What You Can Do

Spot Trading

Swap any ERC-20 pair through Uniswap V3 on Arbitrum with automatic route optimization.

Perpetuals

Open, manage, and close leveraged long/short positions on GMX V2 markets.

Lending

Supply collateral, borrow assets, and monitor health factors on Aave V3.

TimeBoost

Bid for Arbitrum express lane priority to front-run your own transactions and capture MEV.

RWA Stocks

Scan and trade tokenized real-world-asset equities on Robinhood Chain (chain 46630).

Smart Accounts

ERC-4337 session keys with spending limits — delegate execution without exposing your private key.

​
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
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.

​
Access Methods

ChannelDescription
Web TerminalChat-based terminal UI at ouroborai.com/app
Telegram/trade, /perp, /portfolio commands via bot
TwitterMention @ouroborai with a trading intent
CLIPipe prompts directly from your terminal
MCP Server15-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

Quick Start

Get a local instance running in 5 minutes.

Architecture Deep Dive

Understand the request lifecycle, adapter pattern, and state management.

API Reference

Full REST API documentation with request/response examples.

Add a Skill

Extend the agent with custom protocol integrations.