Otto X — X Layer API

Documentation Index

Fetch the complete documentation index at: https://docs.useotto.xyz/llms.txt

Use this file to discover all available pages before exploring further.

• Landing Page — interactive endpoint explorer
• LLM Docs — machine-readable for AI agents
• Discovery Doc — x402 discovery document
• GitHub — open source

​

How It Differs from x402.ottoai.services

​

OKX Onchain OS Usage

​

Pricing Overview

​

X Layer DEX Endpoints

​

Market Intelligence

​

AI Tools

​

Trading Resources

​

Agentic Wallet V2 — Autonomous DeFi Execution

​

Custody Model (Important)

• Keys are generated and held inside OKX’s Trusted Execution Environment (TEE). Otto AI holds an API credential that authorizes signing; neither Otto nor OKX staff can export the underlying key.
• Users do not control their sub-wallet directly. There is no seed phrase to back up, no MetaMask connection, no co-signer role.
• This trades away the self-custodial property of Otto AI’s Safe-based Trade Execution Agent in exchange for fully autonomous execution (no user signing, no gas management, atomic operations).
• POST /auto-withdraw is the escape hatch: users can sweep any token balance to any external address at any time. No approvals, no holds.
• Otto runs an hourly GC that flags inactive empty sub-wallets to prevent capacity squat.

​

Aligned with Agent Payments Protocol §8.4

​

One-Call Flow via EIP-3009 principalAuth (recommended)

1. One-time preview — GET /sub-wallet?address=0xYOUR_WALLET (free). Cache sub_wallet.evm_address indefinitely; it’s deterministic per payer.
2. Sign two things — your wallet signs:
   • The x402 service fee (standard paywall, $0.25 USDT0 on X Layer → Otto treasury).
   • An EIP-3009 TransferWithAuthorization note authorizing your USDC on the target chain to flow into your sub-wallet. Modern wallets (MetaMask, Coinbase Wallet, Rabby, Phantom) can batch both into one confirmation screen.
3. POST the op — include principalAuth in the body:

{
  "fromToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "toToken":   "0x4200000000000000000000000000000000000006",
  "amount":    "10",
  "chain":     "base",
  "principalAuth": {
    "from":        "0xYOUR_WALLET",
    "to":          "0xYOUR_SUB_WALLET",
    "value":       "10000000",
    "validAfter":  0,
    "validBefore": 1776973646,
    "nonce":       "0x...",
    "signature":   "0x..."
  }
}

• principalAuth.from MUST equal your x402 payer (no impersonation).
• principalAuth.to MUST equal your provisioned sub-wallet (no draining to attacker addresses).
• principalAuth.value MUST be ≥ the op’s required amount.
• validBefore MUST be in the future; nonce MUST be unseen (replay-safe via a per-signer-per-token-per-nonce DB claim + on-chain authorizationState check).

​

Legacy Flow — HTTP 409 funds_required (fallback)

{
  "status": "funds_required",
  "code": "FUNDS_REQUIRED",
  "idempotency_key": "a1b2c3...",
  "retry_after_deposit": true,
  "deposit": {
    "deposit_address": "0xYourSubWallet...",
    "required_amount": "50",
    "token": "USDC",
    "chain": "base"
  },
  "instructions": "Deposit 50 USDC to this address on Base, then retry with header 'idempotency-key: a1b2c3...'. Your x402 payment for this attempt was NOT charged."
}

​

Free Endpoints

​

x402 Payment Flow (OKX)

1. Send request  →  GET /crypto-news
2. Get 402       ←  Payment Required ($0.001, X Layer)
3. Pay on-chain  →  Transfer on X Layer mainnet (chain 196)
4. Retry + proof →  GET /crypto-news + payment header
5. Verified      →  OKX Facilitator confirms payment
6. Get data      ←  News report with sentiment

​

Token Registry

​

Quick Start

# Health check (free)
curl https://xlayer.ottoai.services/health

# Token registry (free)
curl https://xlayer.ottoai.services/tokens

# AI-readable catalog (free)
curl https://xlayer.ottoai.services/llm.txt

# Paid endpoint (returns 402 with payment instructions)
curl https://xlayer.ottoai.services/crypto-news

​

Roadmap

• principalAuth chain expansion: add Ethereum, Optimism, Avalanche, BSC for EIP-3009 one-call flows once on-chain gas economics justify it
• Onchain OS One-Time / Batch Payment for principal on X Layer: reroute the principal leg through the OKX Payment protocol so the user’s principal transfer itself is zero-gas (today only the service fee is); offer aggr_deferred scheme on high-frequency reads so AI-agent hot loops can batch-settle signatures via TEE
• Agentic Wallet allowlist expansion: broaden beyond Aave / Lido / Compound / Morpho once each new protocol clears mainnet validation; add BSC, Avalanche, and Solana DeFi integrations
• AI-routed yield (/auto-yield): natural-language endpoint that picks the best allowlisted protocol automatically based on current APYs and risk tolerance
• Earn-pay-earn loops: Agents earn via x402, pay for intelligence via x402, compound returns through Otto X — all on X Layer
• OKX Onchain OS Skills integration: Publishing Otto services as first-class skills so Claude Code / Cursor / Codex CLI users can discover and pay for Otto intelligence natively
• Hyperliquid perps via Agentic Wallet: extend beyond OKX’s DeFi catalog by wiring wallet contract-call against Hyperliquid’s contracts for TP/SL-capable perp execution from the same sub-wallet
• Multi-master sharding: scale beyond 50 sub-wallets per OKX master by sharding across multiple execution masters with deterministic routing