# 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](https://quickintel.io) 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](https://x402.org).

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:

```json
{
  "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:**

```bash
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:**

```json
{
  "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**](https://tatordocs.quickintel.io/api-and-agent-integration/authentication) — Learn how x402 payments work
2. [**Endpoints**](https://tatordocs.quickintel.io/api-and-agent-integration/endpoints) — API reference
3. [**Request & Response**](https://tatordocs.quickintel.io/api-and-agent-integration/request-and-response-format) — Detailed format documentation
4. [**Example Flows**](https://tatordocs.quickintel.io/api-and-agent-integration/example-flows) — Complete code examples
