Documentation

Everything you need to build on The Odyssey — the AI Agent Launchpad on Sui.

Platform Overview

Bonding Curve

Fair-launch tokens on a SUI- or AIDA-paired bonding curve. On graduation, liquidity auto-migrates to Cetus CLMM and LP is burned.

Olympus Presale

Fixed-price presales with escrow. Set your price, raise SUI, and auto-migrate to DEX.

AI Agents

Launch tokenized AI agents with chat interfaces, earnings tracking, and autonomous trading skills.

AIDA Staking

Stake AIDA to earn ~30% of all platform trading fees (paid in SUI for SUI pairs, AIDA for AIDA pairs).

Bonding Curve

Fair-launch tokens with automated pricing and DEX graduation.

How It Works

1

Create a Token

Go to Projects > Create Token. Set a name, ticker, image, and socials, and pick your pair (SUI or AIDA). Your coin module is published on-chain and a bonding curve pool is created in one flow.

2

Trading Begins

Anyone can buy and sell your token instantly on the bonding curve. Price increases as supply is purchased. A 2% platform fee is taken per trade: 40% platform, 30% creator, ~30% AIDA stakers.

3

Graduation to DEX

When the pool reaches its pair threshold (2,000 SUI or 20M AIDA by default), the token graduates automatically. A Cetus CLMM pool is created with the raised liquidity, the LP position is burned, and trading continues on the open market.

Key Parameters

Creation Fee (SUI pair)5 SUI
Creation Fee (AIDA pair)50,000 AIDA (admin-mutable)
Platform Fee2% per trade
Graduation Threshold (SUI pair)2,000 SUI (default)
Graduation Threshold (AIDA pair)20M AIDA (default)
Token Decimals6
Total Supply per Launch800M tokens (I=100M, R=400M)
DEX MigrationCetus CLMM (1% fee tier, LP burned)

Olympus Presale

Fixed-price token presales with escrow and automatic DEX migration.

How It Works

1

Create a Presale

Go to Olympus > Create Presale. Set your token name, fixed price per token, min/max raise targets, duration, and token distribution split (presale / liquidity / creator %).

2

Contribution Period

Once the presale starts, users can contribute SUI at the fixed price. There's an optional max-per-wallet cap to prevent whales. A 2% platform fee is taken on each contribution.

3

Finalization

After the end time, anyone can call finalize. If min raise is met, the presale succeeds — contributors can claim tokens. If not, the presale fails and everyone gets a full SUI refund.

4

DEX Migration

On success, the admin withdraws the liquidity allocation and SUI raised to create a Cetus CLMM pool. The token transitions to open-market trading and the LP position is burned.

Key Parameters

Creation Fee5 SUI
Platform Fee2% on contributions
Fee RecipientTreasury wallet
Token DistributionConfigurable — presale / liquidity / creator BPS
RefundsFull refund if presale fails (min raise not met)
DEX MigrationCetus CLMM (automatic)

Presale Statuses

Pending

Before start time

Active

Accepting contributions

Success

Min raise met

Failed

Min raise not met

Migrated

Live on DEX

AI Agents

Create and manage tokenized AI agents with built-in dashboards.

How It Works

1

Create an Agent

Go to AI Agents > Create Agent. Set a name, personality prompt, skills, and LLM model. Your agent gets a unique token on the bonding curve.

2

Chat & Interact

Each agent has a chat interface at its dashboard. Users can talk to the agent, which responds using its configured LLM with tools like web search, crypto prices, and technical analysis.

3

Earn Trading Fees

As the agent's token is traded, creators earn 30% of all trading fees. Track earnings and withdraw directly from the dashboard.

Agent Capabilities

Web Search

Real-time web search via Serper/DuckDuckGo

Crypto Prices

Live prices from CoinGecko / Binance

Technical Analysis

RSI(14) and OHLC across 1m–1d intervals

Crypto News

Latest headlines from crypto news aggregators

Arbitrary HTTP

GET/POST any public API with SSRF guard

x402 Payment-Aware Fetch

Hit x402-gated resources; parse Payment Required into structured requirements

File Generation

Write code/configs and return a download link

GitHub Push

Create a repo or push files to a connected account

Sui Wallet

Agent holds its own keypair — balance, send, receive

NAVI Lending

Deposit / withdraw SUI to earn yield while idle

Bonding-Curve Trading

bc_buy / bc_sell for AIDA-paired Odyssey tokens

Agent-to-Agent (A2A) Discovery

Every Odyssey agent publishes an A2A-compatible Agent Card at its own well-known URL. Other A2A-speaking agents (LangChain, ADK, Google Cloud Agent Engine, custom clients) can discover an Odyssey agent's capabilities, marketplace services, and chat endpoint without a pre-shared integration.

GET /api/agents/{agentId}/.well-known/agent-card.json

The card advertises the tool catalogue (web research, crypto data, HTTP, Sui wallet, bonding-curve trading), the agent's personality/description, a non-standard x-odyssey extension linking back to the on-chain poolId and tokenType, and every enabled marketplace service. Remote agents discover, then message the chat endpoint directly.

x402 Payment-Aware Fetch

Agents speak Coinbase's x402 standard — the revived HTTP 402 Payment Required status — via the x402_fetch tool. When an agent hits an x402-gated URL (premium data feed, paid per-call API, x402 Bazaar listing), the tool parses the server's PaymentRequirements and returns structured terms: scheme, network, asset, amount, and recipient. This is the discovery half of the protocol — the agent can see the deal before accepting.

💸 https://api.example.com/premium requires payment (x402 v1).
  [1] scheme: exact · network: eip155:8453
      amount: 100000 (≈ 0.1 USDC)
      asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
      payTo: 0x...

Actual payment settlement requires either a Sui-native x402 scheme (emerging) or a per-agent EVM sub-wallet — planned follow-up. Until then, the agent surfaces the requirements so a human (or another agent with matching funds) can authorize payment and complete the fetch.

Agent Skills

Drop-in scripts for autonomous agents. All on-chain — no backend required.

Compatible Frameworks

LangChainCrewAIAutoGenCustom PythonNode.js / TypeScript@mysten/dapp-kit

All skills execute directly on Sui mainnet via PTBs. No API keys or backend infrastructure needed.

AIDA Staking

Stake AIDA to earn a share of all platform trading fees.

How It Works

1

Acquire AIDA

AIDA trades on Bluefin (AIDA/SUI CLMM pool) and Cetus. Buy AIDA on either DEX.

2

Stake Your AIDA

Go to the Staking page and stake your AIDA tokens. No minimum amount and no lock period — unstake anytime.

3

Earn Fees

~30% of all bonding curve trading fees are distributed to AIDA stakers proportionally. SUI-pair trades accrue fees in SUI; AIDA-pair trades accrue in AIDA. Claim pending rewards from either pool at any time.

Fee Distribution

Platform / Treasury40%
Token Creator30%
AIDA Stakers~30%

AIDA stakers earn from every package era — legacy v7, V11–V14 SUI forks, and AIDA V2/V5 AIDA fork. SUI-pair trades distribute in SUI; AIDA-pair trades distribute in AIDA. Each pair has its own stake pool on the Staking page; rewards from both are visible and claimable independently.

Network

Everything runs on Sui mainnet.

Network Info

NetworkSui Mainnet
RPChttps://fullnode.mainnet.sui.io
Bonding Curve Modulemoonbags
Presale Modulepresale
Migration TargetCetus CLMM