👽 Alien Plugg x402 API SDK

"What I have is outta this world 👽🌌"

Welcome to the Alien Plugg x402 API SDK. Alien Plugg operates 30 pay-per-call x402 API endpoints and a Model Context Protocol (MCP) server on the Base network (Chain ID 8453). Built specifically for AI agents, trading bots, and Web3 developers, every endpoint is monetized natively using the open x402 protocol with USDC payments.

⚡ Quick Start (Time to First "Hello World" < 60s)

No API keys or registration required. You only pay micro-fractions of USDC per request via your EVM wallet.

1. Free Endpoint Discovery (0 Seconds Setup)

Fetch the live catalog of all available endpoints in less than 5 seconds:

curl -s https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery

2. Make Your First Paid Request (< 60 Seconds)

To make pay-per-call requests, use any x402-compatible SDK (coinbase for Python or @coinbase/x402 for Node.js):

Python Quickstart

from coinbase import x402
import os

# Initialize client with your Base wallet private key
client = x402.Client(
    private_key=os.getenv("EVM_PRIVATE_KEY"),
    chain_id=8453 # Base
)

# Call gas-tracker ($0.002) - x402 automatically handles the HTTP 402 handshake & payment
response = client.get("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker")
print(response.json())

📋 Full API Endpoint Catalog (30 Endpoints)

Base URL: https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/

1. Crypto & Trading

2. On-Chain Analysis & Forensics

3. Web & Utility Tools

4. Discovery & Protocol Handshake

💻 Code Examples

Complete script examples are located in the examples/ folder.

cURL (examples/curl.sh)

# 1. Discover endpoints (FREE)
curl -s https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery

# 2. Call gas-tracker ($0.002) with x402 payment header
curl -s -H "X-PAYMENT: <x402-payment-signature>" \
  https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker

# 3. Call daily trading signals ($0.05)
curl -s -H "X-PAYMENT: <x402-payment-signature>" \
  https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/alien-plugg-alpha

Python (examples/python.py)

import os
import json
from coinbase import x402

# Initialize Coinbase x402 client
x402_client = x402.Client(
    private_key=os.getenv("EVM_PRIVATE_KEY"),
    chain_id=8453
)

# 1. Free endpoint discovery
discovery_data = x402_client.get("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery").json()

# 2. Call gas-tracker ($0.002)
gas_data = x402_client.get("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker").json()

# 3. Fetch Alien Plugg Alpha Daily Report ($0.05)
alpha_report = x402_client.get("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/alien-plugg-alpha").json()

Node.js (examples/nodejs.js)

import { x402Client } from "@coinbase/x402";

const client = new x402Client({
  privateKey: process.env.EVM_PRIVATE_KEY,
  chainId: 8453
});

// 1. Discover endpoints
const discovery = await fetch("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery").then(r => r.json());

// 2. Call paid gas-tracker endpoint ($0.002)
const gasResponse = await client.fetch("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/gas-tracker");
const gasData = await gasResponse.json();

// 3. Fetch Alien Plugg Alpha signals ($0.05)
const alphaResponse = await client.fetch("https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/alien-plugg-alpha");
const alphaData = await alphaResponse.json();

🤖 MCP Server Setup for AI Agents

Alien Plugg provides a Model Context Protocol (MCP) server exposing 10 interactive tools for LLM platforms like Claude Desktop, Cursor, and custom agentic frameworks.

MCP Server Endpoint URL: https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake

1. Claude Desktop Setup

Add the following to your claude_desktop_config.json file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "alien-plugg": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake"
      ]
    }
  }
}

2. Cursor IDE Setup

Add the configuration in Cursor Settings -> Features -> MCP or in .cursor/mcp.json:

{
  "mcpServers": {
    "alien-plugg": {
      "url": "https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake",
      "transport": "http"
    }
  }
}

🔗 Official Links & Resources

• 🛰️ API Base URL: https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/
• 🔍 Discovery Endpoint: https://x402.bankr.bot/0xabf922abb2a9e782f0b187d5d1ab24deb4870c3d/discovery
• 🌐 Landing Page: Alien Plugg Web Portal
• 📄 llms.txt Specification: Alien Plugg llms.txt
• 🤖 MCP Handshake URL: https://base44.app/api/apps/6a5fdd57651262e86b24133e/functions/mcpHandshake

🪙 Token Contracts

• PLUGG on Base Network: 0xDe76415CeBe959CF0738e8A636d9153fF295bba3
• PLUGG on Robinhood Chain: 0x09d56eaCb69E85Dca856B6dc15fA6aE9eeaBFBa3

📄 License

MIT License. Built for the open AI agent ecosystem.