Overview

API & Agent Integration

Overview

The Tator Trader API enables AI agents and autonomous wallets to execute trades, bridge assets, and interact with DeFi protocols using natural language — all without API keys or subscriptions.

---

Who Is This For?

• AI Agent Platforms — Lobster, OpenClaw, Coinbase Agentic Wallets

• Autonomous Trading Bots — Agents that manage their own wallets

• Developers — Building AI-powered trading interfaces

• MCP Integrations — Model Context Protocol tool builders

---

Key Benefits

🔓 Permissionless Access

No API keys. No registration. No approval process. Just pay per call with USDC and start trading.

🔐 Non-Custodial

You keep your keys. Tator returns unsigned transaction data that your agent signs and broadcasts. We never touch your funds.

🗣️ Natural Language

Send plain English instructions:

• "Buy $50 worth of ETH on Base"

• "Bridge 100 USDC from Arbitrum to Optimism"

• "What's the price of PEPE?"

⛓️ Multi-Chain

20+ blockchains supported including Ethereum, Base, Arbitrum, Optimism, Polygon, Solana, MegaETH, and more.

🛡️ Built-in Security

Every trade is scanned by Quick Intel for honeypots, scams, and risky contracts before execution.

---

How It Works

┌─────────────────┐
│    AI Agent     │
│  (Your Wallet)  │
└────────┬────────┘
         │
         │ 1. Send prompt + x402 payment ($0.20 USDC)
         ▼
┌─────────────────┐
│   Tator API     │
│  x402 Gateway   │
└────────┬────────┘
         │
         │ 2. Process with AI
         ▼
┌─────────────────┐
│  Tator Eliza    │
│  Trading Engine │
└────────┬────────┘
         │
         │ 3. Return unsigned transaction
         ▼
┌─────────────────┐
│    AI Agent     │
│  Signs & Sends  │
└────────┬────────┘
         │
         │ 4. Broadcast to blockchain
         ▼
    ⛓️ On-Chain

---

Supported Operations

Category	Operations
Trading	Buy, Sell, Swap
Transfers	Send, Bridge
Token Management	Wrap, Unwrap
DeFi	Yield deposit/withdraw/claim, Perpetuals (Avantis)
Prediction Markets	Buy/Sell positions (Myriad)
Identity	Register names (Base, MegaETH, Somnia)
Info Queries	Price check, Balance check, Token scan

---

Pricing

$0.20 per API call — paid in USDC via the x402 protocol.

No subscriptions, no minimums — pay only for what you use.

Note: You are charged per API call regardless of whether the prompt results in a transaction. Unclear or invalid prompts will return a clarifying response but still incur the fee. See Prompt Best Practices below.

---

Prompt Best Practices

To get the best results and avoid wasted calls, follow these guidelines:

✅ Good Prompts

"Buy $50 worth of ETH on Base"
"Swap 100 USDC for WETH on Arbitrum"
"Bridge 50 USDC from Ethereum to Base"
"What is the price of 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on Base?"
"Send 10 USDC to 0x742d35Cc6634C0532925a3b844Bc9e7595f7AAAA on Base"

❌ Bad Prompts

"Buy some crypto"           → Missing: token, amount, chain
"Get me ETH"                → Missing: amount, chain
"Trade tokens"              → Missing: everything
"What's the price?"         → Missing: token
"Buy XYZ"                   → Ambiguous token, no chain

Best Practices

Always Include	Why
Chain name	"on Base", "on Arbitrum", "on Ethereum"
Token symbol OR contract address	Use CA for obscure tokens
Amount with unit	"$50 worth" or "100 USDC"
Action	"buy", "sell", "swap", "bridge", "send"

What Happens with Unclear Prompts?

If your prompt is unclear or missing information:

1. You still pay the API fee ($0.20)

2. Response type will be info or error

3. The response text will ask for clarification

Example:

{
  "success": true,
  "type": "info",
  "response": "I'd be happy to help you buy tokens! Could you please specify: 1) Which token you want to buy, 2) How much (in USD or token amount), and 3) Which chain (e.g., Base, Ethereum, Arbitrum)?",
  "transactions": []
}

Tip: Validate prompts client-side before sending to avoid unnecessary charges.

---

Supported Payment Networks

Pay from any of these chains:

Chain	Token
Base	USDC
Ethereum	USDC
Arbitrum	USDC
Optimism	USDC
Polygon	USDC
Avalanche	USDC
Unichain	USDC
Linea	USDC
MegaETH	USDM

---

Quick Example

Request:

curl -X POST https://x402.quickintel.io/v1/tator/prompt \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: " \
  -d '{
    "prompt": "buy $10 worth of ETH on base",
    "walletAddress": "0xYourWallet...",
    "provider": "your-agent-name"
  }'

Response:

{
  "success": true,
  "type": "transaction",
  "response": "Your buy order is ready...",
  "transactions": [{
    "to": "0x6131B5fae...",
    "data": "0xe21fd0e9...",
    "value": "970400362929736",
    "chainId": 8453,
    "gas": "373855"
  }]
}

Your agent then signs the transaction and broadcasts it to the blockchain.

---

Next Steps

1. Authentication — Learn how x402 payments work

2. Endpoints — API reference

3. Request & Response — Detailed format documentation

4. Example Flows — Complete code examples