👽 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:

Terminal

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

server.ts

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

Endpoint	Price (USDC)	Description
`zora-scanner`	`$0.010`	Trending Zora coins + BUY / SELL / STRONG_BUY trading signals
`robinhood-scanner`	`$0.010`	Robinhood Chain trending tokens + momentum signals
`zora-rug-check`	`$0.020`	Rug risk scoring (0-100) + LOW/MEDIUM/HIGH/CRITICAL verdict
`zora-portfolio`	`$0.005`	Wallet token holdings, PnL tracking, and asset allocation
`zora-sentiment`	`$0.050`	Social sentiment scoring + ACCUMULATE/HOLD/REDUCE recommendations
`token-price`	`$0.015`	Real-time token pricing lookup by ID, symbol, or contract address
`token-compare`	`$0.005`	Side-by-side token comparison + automated winner verdict
`chart-roast`	`$0.008`	Brutal technical chart analysis + market breakdown
`alien-plugg-alpha`	`$0.050`	Daily curated trading signals — top alpha picks, rug warnings, DCA strategies
`honeypot-check`	`$0.040`	On-chain honeypot detection — tests buy/sell tax & execute rights
`price-alerts`	`$0.008`	Token price alert trigger management & state tracking

2. On-Chain Analysis & Forensics

Endpoint	Price (USDC)	Description
`whale-tracker`	`$0.080`	Real-time whale transfer detection on Base network
`wallet-profile`	`$0.003`	On-chain wallet profiler + behavioral labels & historical activity
`smart-money`	`$0.080`	Track smart money wallets, accumulation patterns, and DEX flow
`dex-flow`	`$0.120`	Uniswap V3 liquidity flow & volume depth analysis
`new-launches`	`$0.010`	Fresh token launch scanner on Zora & Base
`creator-lookup`	`$0.010`	Token creator profile analysis + portfolio of launched coins
`gas-tracker`	`$0.002`	Real-time Base network gas prices & fee estimates
`tx-status`	`$0.002`	Transaction execution status & receipt parser
`holder-analysis`	`$0.030`	Token holder concentration, distribution, and Gini coefficient

3. Web & Utility Tools

Endpoint	Price (USDC)	Description
`translate`	`$0.005`	Multi-language translation API supporting 100+ languages
`ip-info`	`$0.0015`	IP geolocation, ISP detection, and VPN/proxy flags
`expand-url`	`$0.015`	URL shortener expansion & HTTP redirect chain tracer
`tech-stack-detect`	`$0.008`	Website technology stack fingerprinting
`webpage-diff`	`$0.030`	Webpage content change monitoring + visual diff
`builder-score`	`$0.008`	AI-powered developer & builder reputation score

4. Discovery & Protocol Handshake

Endpoint	Price (USDC)	Description
`discovery`	`FREE`	Full catalog of endpoints, prices, descriptions, and token metadata
`.well-known/x402.json`	`FREE`	Standard x402 service discovery manifest
`mcp-server` / `mcpHandshake`	`$0.005`	Model Context Protocol (MCP) server providing 10 curated tools for AI agents
`health`	`FREE`	Gateway health check and service latency metric

💻 Code Examples

Complete script examples are located in the examples/ folder.

cURL (`examples/curl.sh`)

bash

# 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`)

server.ts

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`)

server.ts

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

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:

config.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.

👽 Alien Plugg x402 API SDK

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

1. Free Endpoint Discovery (0 Seconds Setup)

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

Python Quickstart

📋 Full API Endpoint Catalog (30 Endpoints)

1. Crypto & Trading

2. On-Chain Analysis & Forensics

3. Web & Utility Tools

4. Discovery & Protocol Handshake

💻 Code Examples

cURL (examples/curl.sh)

Python (examples/python.py)

Node.js (examples/nodejs.js)

🤖 MCP Server Setup for AI Agents

1. Claude Desktop Setup

2. Cursor IDE Setup

🔗 Official Links & Resources

🪙 Token Contracts

📄 License

cURL (`examples/curl.sh`)

Python (`examples/python.py`)

Node.js (`examples/nodejs.js`)