GitHub - wilnowilx/aetheriusxapi: Operating System for AI Agent Commerce 🤖 | 60+ live APIs paid in USDC via x402 on Base ⚡️ | No accounts, just your wallet and code. · GitHub
Skip to content
BranchesTags

Repository files navigation

AETHERIUS Mainnet x402 USDC Endpoints Tests Dashboard SDK License YouTube Stars Forks

AETHERIUS — aetheriusxAPI

🛡️ OUR DOCTRINE IS NOT DOGMA, IT'S A GUIDE FOR ACTION

The Operating System for AI Agent Commerce

80 live APIs (120+ on the roadmap) where autonomous AI agents pay per request in USDC on Base. No accounts. No API keys. No subscriptions. Just your wallet and code.

What does "xAPI" mean? The x stands for x402 — the HTTP payment protocol that makes this possible. AETHERIUS is an API marketplace powered by x402 crypto payments. We have APIs. We're just different: agents pay per request with USDC instead of signing up for monthly subscriptions.

Website · Documentation · Tutoriales (ES) · Twitter · Telegram · x402 Protocol

Table of Contents

⏱️ Time Since Repo Born

Days

Repo born: Sep 2, 2026 — 3a6aeb6 "Initial commit" Mainnet deploy: Sep 5, 2026 — Real x402 payments on Base Mainnet 🚀

🗺️ Build Timeline

timeline
    title AETHERIUS journey (Sep 2-6, 2026 — 4 days)
    Research : x402 study : market mapping : VM stabilization
    Sep 2 : Repo born : landing + docs : Python SDK : persistent telemetry
    Sep 2+47min : Backend v2.0 : 40 endpoints : real USDC on Base
    Sep 3 : Dashboard + HTTPS : 60 endpoints : JS SDK : demo player : 10 tutorials
    Sep 3 : README brutal : release v2.0.0 : player v2 : wiki tooltips
    Sep 4 : Interactive playground : Docker : YouTube demo : 60 tests passing
    Sep 5 : Mainnet deploy : real x402 payments on Base Mainnet
    Sep 5 : x402 Intelligence : 4 exclusive FREE on-chain analytics endpoints
    Sep 5 : 80 endpoints : crypto, web, data, news, defi, token, maps
    Sep 5 : x402 Intelligence expanded to 20 FREE endpoints
    Sep 5 : Favicon : purple heart on all 3 sites
    Sep 6 : SDK v2.0 : typed sub-clients for all 20 x402 Intelligence endpoints
    Sep 6 : Bot welcome handler : channel-only updates : landing page polish
Loading
Phase Work Time Verify
May–Aug 2026 Research, x402 study, VM stabilization — an idea this size needs study before it can be visualized ~4 months workspace history
Sep 2 — 1st deploy Repo born, landing page, docs, Python SDK, persistent SQLite telemetry t+0 min git log --oneline 3a6aeb6
Sep 2 — 2nd deploy Backend v2.0, 40 endpoints, real USDC on Base Mainnet, 5-source price chain t+47 min git log --oneline --since="2026-09-02" --until="2026-09-03"
Sep 3 — 3rd deploy Dashboard OS mode, HTTPS (Let's Encrypt), CORS, JS SDK, 60/60 tests t+18h 23min git log --oneline --since="2026-09-03"
Sep 3 — 4th deploy Demo player, cast replay, typewriter, 10+ tutorials EN/ES t+22h 41min same
Sep 3 — 5th deploy README brutal (7 SVG diagrams), release v2.0.0, 15 GitHub topics t+23h 15min git tag -l
Sep 3 — 6th deploy Player v2 (wiki tooltips, SVG icons, right-aligned), dashboard catalog fix t+48h 06min git log -1 --format=%H
Sep 4 — 7th deploy Interactive playground (live API testing), waitlist, Docker, JS SDK, grant submissions, YouTube demo, 60/60 tests t+55h git log -1 --format=%H
Sep 5 — 8th deploy 64→80 endpoints (+16): crypto market, web tools, data utils, news, DeFi tools, NFT t+55h+ git log -1 --format=%H
Sep 5 — 9th deploy x402 Intelligence expanded to 20 FREE endpoints, mainnet live t+56h+ git log -1 --format=%H
Sep 5 — 10th deploy Mainnet deploy — real x402 USDC payments on Base Mainnet t+72h curl https://34-156-149-38.sslip.io/aetherapi/health
Sep 5 — 11th deploy Purple heart favicon on all 3 sites, README v2.2, pitch deck link t+73h git log --oneline
Sep 6 — 12th deploy Landing page polish (80 endpoints, uptime %, footer links), bot welcome handler, channel-only updates t+96h git log --oneline
Sep 6 — 13th deploy Python SDK v2.0 — typed sub-clients for all 80 endpoints including 20 x402 Intelligence t+97h pip install -e ./sdks/python

Total commits: 130+ and counting (git log --oneline | wc -l — velocity is public).

Build velocity: 80 endpoints (60 paid + 20 free x402 Intelligence) + 60 tests + 2 SDKs (v2.0) + dashboard + landing + playground + demo + 2 grant submissions + Telegram bot + GitHub Actions in 4 days. If one person builds this in 96 hours, imagine what funded builders ship on Base.

🔥 The Problem

Problem statement

Most APIs are designed for a human-led workflow: a developer creates an account, provisions credentials, accepts a subscription or credit limit, and reconciles usage through a separate billing system. That model works for teams, but adds coordination and trust boundaries when the client is an autonomous agent.

An agent needs to discover a service, authorize a bounded amount, call it, and receive a verifiable result without a human present for every transaction. API keys identify a client but do not provide per-request authorization; subscription billing separates consumption from settlement; and conventional payment rails are not optimized for low-value, high-frequency machine-to-machine calls.

What we verified in production

  • Testnet facilitators verify signatures without always settling on-chain — our volume metric counts facilitator-approved payments, stated as such.
  • Datacenter IPs get throttled by free upstreams (CoinGecko 429s, Etherscan V1 deprecation) — hence mirror chains and multi-source fallbacks, not bigger promises.
  • A 402 with an empty body is the honest challenger: no proof, no data.
  • Naming these plainly is what separates our docs from generic API-marketplace copy.

Thesis

If payment authorization and API access are expressed in the same HTTP interaction, an agent can consume external capabilities autonomously while the provider keeps a standard request/response interface. x402 provides that interaction: the provider returns 402 Payment Required with machine-readable requirements, the client supplies a payment proof, and the request is verified and settled with USDC on Base.

Engineering requirements

Requirement Design implication
Programmatic authorization Approve a specific request and amount without sharing a long-lived secret.
Usage-based economics Keep price, request, response, and settlement correlated at the API boundary.
Low-value viability Support micro-payments without monthly commitments.
Provider compatibility Keep services as ordinary HTTP APIs protected by middleware.
Operational verifiability Measure health, latency, payment events, and failures independently.

AetheriusX hypothesis: a marketplace of capability APIs with x402-native settlement can reduce the operational friction of agent commerce while preserving familiar HTTP semantics. The hypothesis is testable through payment conversion, latency, repeat usage, request success rate, and settled volume.

🔭 The Vision

Ecosystem

Mission: Become the default API layer for autonomous agents — the Stripe of the agent economy.

Strategy:

  1. Live now: 11 categories, 80 endpoints (60 paid + 20 free x402 Intelligence) verified with real USDC on Base Mainnet
  2. Next: expand depth per category + more on-chain analytics
  3. Scale to 120+ with grant funding, then 500+
  4. Become the infrastructure that AI agents depend on

🧠 Mental Model: How x402 Changes Everything

The Old World (API Key Era)

Old world

The New World (x402 Protocol)

New world

Key Concepts

Concept Definition Why It Matters
x402 HTTP 402 status code repurposed for crypto payments Standardized machine-to-machine payment protocol
USDC USD-pegged stablecoin on Base L2 Stable value, sub-cent fees, instant settlement
Base Ethereum L2 by Coinbase Low gas fees, high throughput, Coinbase integration
Facilitator Service that verifies payment proofs on-chain Trustless verification without intermediaries
Wallet-as-Identity Your Ethereum address = your account No signup, no KYC, no email, no password

🗺️ System Overview

System flow

x402 payment sequence

🏗️ Architecture

Architecture

📡 Live Status

Signal Value
Network Base Mainnet eip155:8453 🔴 LIVE
Mode real — on-chain USDC verification via x402 facilitator
Health GET /health (free)
Telemetry GET /v1/telemetry (free): uptime, per-endpoint stats, settled USDC volume
Playground / — interactive endpoint testing
Dashboard /dashboard/ + backend bar
Live API https://34-156-149-38.sslip.io/aetherapi
Version v2.3.0 · 80 endpoints (60 paid + 20 free x402 Intelligence) · 60/60 tests green · Python SDK v2.0
YouTube ▶ Demo — real 402→200 mainnet USDC

🚀 Sep 5, 2026: Deployed to Base Mainnet! Real USDC payments now live. 💵 Wallet: 0x677B483128D0399bCD0A5AB36eE990C0246d7f61 (receiving real payments)

🎬 Live Demo

Unedited terminal replay. One agent, one call, real USDC on Base Mainnet. What you see is exactly what a paying client gets.

▶ Watch the demo · interactive player

The replay shows the full x402 loop — discovery, payment challenge, settlement, data. No cuts, no simulated responses, no fake data. Every response is a real endpoint on mainnet. The telemetry you see on the dashboard updates live.

Dashboard · raw .cast · script

🐍 SDKs

Python (sdks/python/) — v2.0

pip install -e ./sdks/python
from aetheriusx import AetheriusXClient

# Connects to mainnet by default
client = AetheriusXClient()

# ── FREE x402 Intelligence (20 endpoints, no payment needed) ──────────

stats = client.x402.base_stats()       # Chain health snapshot
gas = client.x402.gas()                 # Gas price analysis
whales = client.x402.whales()           # Large transfers (>$10K)
top = client.x402.top_agents()          # Top USDC spenders
risk = client.x402.risk("0x677B...")    # Wallet risk score (0-100)
history = client.x402.history("0x...")  # Transfer history

# ── Paid endpoints (auto-handles 402 challenge) ───────────────────────

weather = client.data.weather(lat=10.5, lon=-66.9)
price = client.token.price(token="bitcoin")
email_ok = client.email.validate(email="user@example.com")

# ── Catalog browsing ──────────────────────────────────────────────────

print(client.catalog.summary())           # Full catalog
cheapest = client.discover_cheapest()     # (route, price)
free = client.discover_free()             # All 20 free routes

JavaScript (sdks/javascript/)

npm install aetheriusx
import { AetheriusXClient } from "aetheriusx";

const client = new AetheriusXClient();
const health = await client.health();
console.log(health.version);

const { route, price } = await client.discoverCheapest();
const res = await client.paidGet(route, { email: "user@example.com" }, { payment: "anything" });
console.log(res.status, res.data);

Runnable flows: examples/

🚀 Quick Start

For AI Agents (Buyers)

# Install the SDK
pip install -e ./sdks/python
from aetheriusx import AetheriusXClient

# Connects to mainnet by default
client = AetheriusXClient()

# Free x402 Intelligence — no payment needed
stats = client.x402.base_stats()
print(stats)

# Paid endpoint — auto-handles 402 challenge
weather = client.data.weather(lat=10.5, lon=-66.9)
print(weather)

For API Providers (Sellers)

from fastapi import FastAPI
from x402.http import FacilitatorConfig, HTTPFacilitatorClient
from x402.http.middleware.fastapi import PaymentMiddlewareASGI

app = FastAPI()

# Add x402 payment middleware
facilitator = HTTPFacilitatorClient(
    FacilitatorConfig(url="https://x402.org/facilitator")
)

app.add_middleware(PaymentMiddlewareASGI, routes={
    "GET /your-endpoint": {
        "accepts": [{
            "scheme": "exact",
            "pay_to": "0xYourWallet",
            "price": "$0.01",
            "network": "eip155:8453"
        }],
        "description": "Your premium API endpoint",
    }
}, server=facilitator)

🎛️ Dashboard

Interactive control room (no build step, vanilla JS) served by the backend itself:

uvicorn main:app --reload --port 4020
# open http://127.0.0.1:4020/dashboard/
  • API Catalog — all 80 endpoints with live prices from /health
  • Explorer — param forms, one-click paid calls, Show 402 renders the payment challenge
  • Live Metrics — REAL server telemetry (/v1/telemetry): uptime, totals, settled USDC volume, wallets seen, latency bars, event feed. Zero simulated numbers.
  • Wallet — memory-only demo connect (real x402 signing in production client)
  • Storage Drift — probes /v1/storage/drift, shows planned payload until Phase 2
  • Activity — client-side call log

Live (mainnet): https://wilnowilx.github.io/aetheriusxapi/#dashboard

🔌 Endpoints

Endpoint Description Price Latency
GET /v1/maps/search Business search via OpenStreetMap $0.01 ~120ms
GET /v1/maps/reviews Place lookup via OpenStreetMap $0.02 ~200ms
GET /v1/maps/nearby Nearby places by coordinates $0.015 ~90ms
GET /v1/maps/reverse Coordinates to address $0.01 ~80ms
GET /v1/maps/geocode Forward geocoding $0.01 ~90ms
GET /v1/token/analyze Token contract analysis $0.02 ~80ms
GET /v1/token/holders Holder distribution (key-gated) $0.03 ~60ms
GET /v1/token/price Real-time token price $0.005 ~30ms
GET /v1/token/prices Batch token prices $0.01 ~40ms
GET /v1/token/gas Gas oracle $0.01 ~25ms
GET /v1/token/balance ETH balance $0.01 ~35ms
GET /v1/token/transactions Wallet transactions $0.02 ~70ms
GET /v1/token/global Global crypto stats $0.01 ~50ms
GET /v1/web/scrape Universal web scraper $0.01 ~150ms
GET /v1/web/screenshot Website screenshot capture $0.025 ~300ms
GET /v1/web/geoip IP geolocation $0.008 ~40ms
GET /v1/web/dns DNS lookup $0.005 ~30ms
GET /v1/email/validate Email verification $0.005 ~40ms
GET /v1/data/weather Current weather $0.008 ~50ms
GET /v1/data/forecast 7-day forecast $0.008 ~60ms
GET /v1/data/airquality Air quality index $0.008 ~45ms
GET /v1/data/define Dictionary definitions $0.005 ~30ms
GET /v1/data/words Word relations (syn/ant) $0.005 ~25ms
GET /v1/data/elevation Elevation lookup $0.005 ~35ms
GET /v1/storage/drift Cross-RPC slot drift $0.02 ~140ms
GET /v1/defi/yields Top yield pools $0.02 ~90ms
GET /v1/defi/stablecoins Stablecoin list $0.01 ~60ms
GET /v1/defi/fees Protocol fees $0.015 ~70ms
GET /v1/defi/tvl Chain TVLs $0.01 ~55ms
GET /v1/defi/protocols Protocols by TVL $0.01 ~65ms
GET /v1/defi/dexs DEX volumes $0.015 ~75ms
GET /v1/defi/stablecoinchains Stables by chain $0.01 ~50ms
GET /v1/defi/stablecoin-history Stable history $0.01 ~80ms
GET /v1/forex/rates Fiat FX rates $0.008 ~40ms
GET /v1/forex/history Historical FX $0.01 ~60ms
GET /v1/forex/convert Currency conversion $0.008 ~35ms
GET /v1/news/hackernews HN front page $0.01 ~50ms
GET /v1/news/hn-item HN item by ID $0.005 ~30ms
GET /v1/news/hn-user HN user profile $0.005 ~25ms
GET /v1/news/hn-feed HN Ask/Show/Jobs $0.01 ~45ms
GET /v1/crypto/market Global crypto market data $0.01 ~50ms
GET /v1/crypto/fear-greed Fear & Greed Index $0.005 ~30ms
GET /v1/crypto/trending Trending coins $0.008 ~40ms
GET /v1/crypto/ohlcv OHLCV candlestick data $0.015 ~60ms
GET /v1/crypto/dominance BTC/ETH dominance $0.005 ~35ms
GET /v1/web/whois Domain WHOIS lookup $0.015 ~80ms
GET /v1/web/headers HTTP headers checker $0.008 ~40ms
GET /v1/web/ssl SSL certificate info $0.008 ~45ms
GET /v1/data/ip IP geolocation $0.005 ~30ms
GET /v1/data/ua User-Agent parser $0.003 ~15ms
GET /v1/data/hash Hash generator (MD5/SHA) $0.003 ~10ms
GET /v1/data/uuid UUID generator $0.003 ~10ms
GET /v1/data/qrcode QR code generator $0.005 ~25ms
GET /v1/data/translate Text translation $0.01 ~50ms
GET /v1/data/summarize Text summarizer $0.015 ~70ms
GET /v1/news/reddit Reddit posts $0.008 ~45ms
GET /v1/news/devto Dev.to articles $0.008 ~40ms
GET /v1/defi/impermanent-loss IL calculator $0.005 ~20ms
GET /v1/defi/staking-apy Staking APY tracker $0.008 ~35ms
GET /v1/token/nft NFT metadata $0.015 ~60ms
x402 Intelligence (FREE)
GET /v1/x402/payments/recent Recent USDC transfers on Base FREE ~2s
GET /v1/x402/agent/{address} Wallet spending intelligence FREE ~2s
GET /v1/x402/analytics Network health & trends FREE ~3s
GET /v1/x402/top-agents Top spenders leaderboard FREE ~3s

60 paid endpoints + 20 FREE x402 Intelligence endpoints = 80 total. With grant funding, we'll expand to 120+ endpoints across 12 categories.

🔬 x402 Intelligence — Exclusive On-Chain Analytics

20 FREE endpoints that read USDC transfers directly from Base Mainnet. No other API provider offers this.

Core Intelligence

Endpoint What it does Example
GET /v1/x402/payments/recent Recent USDC transfers on Base /v1/x402/payments/recent?hours=1&min_amount=100
GET /v1/x402/agent/{address} Wallet intelligence — spending patterns /v1/x402/agent/0x677B...7f61
GET /v1/x402/analytics Network health — volume, trends /v1/x402/analytics
GET /v1/x402/top-agents Top spenders leaderboard /v1/x402/top-agents?limit=10

Chain & Gas

Endpoint What it does Example
GET /v1/x402/base-stats Chain health snapshot /v1/x402/base-stats
GET /v1/x402/gas Gas price analysis & cost estimates /v1/x402/gas
GET /v1/x402/network Full network dashboard /v1/x402/network

Activity Tracking

Endpoint What it does Example
GET /v1/x402/whales Large transfers (>$10K) /v1/x402/whales?min_amount=50000
GET /v1/x402/velocity Transfer frequency (24h) /v1/x402/velocity
GET /v1/x402/hourly Hourly volume breakdown /v1/x402/hourly?hours=12
GET /v1/x402/mint-burn USDC supply changes /v1/x402/mint-burn
GET /v1/x402/bridge Cross-chain bridge flow /v1/x402/bridge

Wallet Intelligence

Endpoint What it does Example
GET /v1/x402/search Address or tx lookup /v1/x402/search?q=0x677B...
GET /v1/x402/history/{address} Transfer history /v1/x402/history/0x677B...7f61
GET /v1/x402/compare Compare two wallets /v1/x402/compare?a=0x...&b=0x...
GET /v1/x402/risk/{address} Wallet risk score (0-100) /v1/x402/risk/0x677B...7f61

Market Intelligence

Endpoint What it does Example
GET /v1/x402/token/{address} ERC-20 token metadata /v1/x402/token/0x8335...2913
GET /v1/x402/contracts Top USDC-receiving contracts /v1/x402/contracts?limit=10
GET /v1/x402/stablecoins All stablecoin activity /v1/x402/stablecoins
GET /v1/x402/defi-pulse DeFi protocol activity /v1/x402/defi-pulse

Why this matters: Nobody else is providing on-chain analytics for the agent economy. AETHERIUS reads Base Mainnet directly — no API keys, no rate limits, no middlemen. This is the intelligence layer that makes x402 payments transparent and actionable.

100% FREE — no payment required. These endpoints are our gift to the community and proof of our on-chain intelligence capability.

🗂️ Categories

Category APIs Examples
Maps & Location 5 Geocoding, business search, nearby places, reverse geocode, place lookup
Token & Crypto 13 Price feeds, token analysis, holder tracking, gas oracle, balance, tx history, NFT metadata, global stats
Web 7 Web scraper, screenshots, DNS, WHOIS, headers, SSL, IP geolocation
Data 12 Weather, forecasts, air quality, definitions, elevation, words, IP, User-Agent, hash, UUID, QR code, translate, summarize
Email 1 Email validation (syntax, MX, disposable check)
DeFi 10 Yields, TVL, stablecoins, DEX volumes, protocol fees, impermanent loss, staking APY
Forex 3 Live rates, historical data, currency conversion
News 6 Hacker News (stories, items, users, feeds), Reddit, Dev.to
Storage 1 Cross-RPC slot drift
Crypto 5 Market data, Fear & Greed, trending coins, OHLCV, dominance
x402 Intelligence 20 USDC transfers, agent wallets, network analytics, whales, gas, DeFi pulse, stablecoins, risk scores (ALL FREE)

🧱 Tech Stack

Tech stack

Component Technology Purpose
Server FastAPI (Python) High-performance async API server
Protocol x402 HTTP 402 with crypto payments
Payments USDC on Base Stablecoin payments on L2
Facilitation Coinbase CDP Payment verification and settlement
Hosting GCP Compute Engine Global edge deployment
Proxy Nginx Rate limiting, SSL, load balancing
Process Systemd Service management and auto-restart
Dashboard Vanilla JS Zero-build interactive control room
SDKs Python + JavaScript Agent integration libraries

💜 DonateX — Open-Source Donation Infrastructure

Part of the AETHERIUS ecosystem. Accept USDC donations on Base in 5 minutes. Zero fees. Zero KYC. One line of code.

Quick Start

<script
  src="https://wilnowilx.github.io/aetheriusxapi/donatex/widget.js"
  data-wallet="0xYOUR_WALLET_ADDRESS"
  data-currency="USDC"
  data-amounts="1,5,10,25"
></script>

Features

  • 3KB — Smaller than most favicons
  • 0% Fees — Stripe charges 2.9%, we charge nothing
  • No KYC — No identity verification, no bank accounts
  • Instant Settlement — USDC arrives in ~2 seconds
  • QR Code — Works with MetaMask, Coinbase Wallet, Rainbow
  • Verification API — Build dashboards and trust badges

Links

Resource URL
Demo wilnowilx.github.io/aetheriusxapi/donatex
GitHub donatex/
Widget.js widget.js
Dev.to Weekend Challenge Submission

🛣️ Roadmap

Phase 1: Foundation (Current)

  • Core API server with x402 middleware (simulated + real modes)
  • 80 endpoints (60 paid + 20 free x402 Intelligence), verified live with real USDC payments
  • E2E payment flow proven on mainnet (6/6 → 200, real USDC settled)
  • Upstream resilience (Overpass mirrors, 5-source price chain, Nominatim fallbacks)
  • Interactive dashboard (/dashboard/) with API explorer
  • Interactive playground — try any endpoint live from the landing page
  • Coinbase CDP API credentials
  • Professional landing page with aurora plasma background
  • Demo player with wiki tooltips and typewriter replay
  • Python + JavaScript SDKs
  • 10+ tutorials EN/ES
  • Base Batches 004 application submitted (result: Sep 17)
  • Base Creator Grant application submitted ($4K)
  • Waitlist with email + wallet capture
  • Dockerfile + docker-compose for local dev
  • Mainnet deployment ✅ Live on Base Mainnet since Sep 5, 2026
  • x402 Intelligence: 20 FREE on-chain analytics endpoints (Core, Chain, Activity, Wallet, Market)
  • Python SDK v2.0 with typed sub-clients for all 80 endpoints
  • Purple heart favicon on all 3 sites
  • Landing page polish (80 endpoints, uptime %, fixed timeline)
  • Telegram bot: welcome handler, channel-only updates
  • Base Ecosystem Fund application

Phase 2: Scale (Post-Grant)

  • Expand to 120+ endpoints
  • 12 API categories
  • SDK releases (Go, Rust)
  • Developer dashboard with analytics
  • Rate limit management UI
  • Community-contributed endpoints

Phase 3: Ecosystem (Q1 2027)

  • Third-party API provider onboarding
  • Revenue sharing model
  • Agent marketplace
  • Enterprise tier with SLA
  • Multi-chain support (Ethereum, Polygon, Arbitrum)

💰 Grant Applications

We are building on Base with support from the ecosystem:

📋 Our Full Pitch Deck

→ Read the complete application deck — company overview, thesis, use of funds, 90-day targets, and verifiable metrics. Everything a grant reviewer needs in one document.

Base Batches 004 — Applied ✅

  • Amount: $100K + accelerator
  • Status: Submitted. Result: Sep 17, 2026
  • Use of funds: Mainnet deployment, expand to 120+ endpoints, SDK development

Base Creator Grant — Applied ✅

  • Amount: $4K
  • Status: Submitted
  • Use of funds: Spanish tutorials, content creation, documentation

Base Ecosystem Fund — Next

  • Amount: Variable
  • Status: Pending (LinkedIn required — can't create due to KYC)

Full application text · Base Builder Grants

📢 Distribution Channels

AETHERIUS is live and being promoted across multiple platforms:

Developer Communities

Platform Status Link
Dev.to ✅ Article live dev.to/wilnowilx
Hacker News 📝 Pending submission news.ycombinator.com
Reddit ⚠️ New account (low karma) r/webdev, r/cryptocurrency
Postman Network 📝 To publish postman.com/publish
OSSDrop 📝 To submit ossdrop.com

API Marketplaces

Platform Status Notes
Postman API Network 📝 To publish 40M+ developers reach
ApyHub 📝 To list MCP-ready, 65K+ developers
API.market 📝 To list 500+ APIs, managed gateway
MCP Registry 📝 To publish Claude, Cursor, LangChain discovery

Social & Content

Platform Handle Status
Twitter/X @aetheriusxAPI 254 followers, 87 posts
Telegram Channel @aetherius_xAPI Active
Telegram Group @aetheriusxAPI_global Forum enabled
YouTube AETHERIUS Demo video live
Typefully Scheduled tweets 35 premium tweets queued

Builder Platforms

Platform Status Notes
Stackrift 📝 To submit Self-promotion encouraged
Hatch Zone 📝 To submit Investor-facing
Forg 📝 To publish API founder stories

Grant Applications

Grant Amount Status
Base Batches 004 $100K + accelerator ✅ Applied, result Sep 17
Base Creator Grant $4K ✅ Applied
Base Ecosystem Fund Variable ⏳ Pending (LinkedIn blocked)

🤝 Contributing

AETHERIUS is open-source. Every line of code is public. Every transaction is verifiable on-chain.

Why contribute?

What you build Why it matters
New API endpoints Every endpoint you add becomes part of the agent economy — discoverable, payable, verifiable
SDK improvements Better SDKs = more agents = more volume = more fees for everyone
Documentation English + Spanish tutorials expand the market from 1B to 1.5B developers
Infrastructure Nginx configs, CI/CD, monitoring — the boring stuff that makes everything else work
Community Translations, examples, bug reports, Discord support

The vision you're building toward

"The operating system for AI agent commerce."

A world where autonomous agents discover, pay for, and consume APIs without human friction. No accounts. No subscriptions. Just code and crypto.

AETHERIUS is building the infrastructure layer for that world. Every endpoint, every SDK improvement, every documentation page brings us closer to a future where 500M+ Spanish-speaking developers have equal access to the agent economy.

What you get

  • Lifetime 50% off every endpoint (Founding Agents)
  • Vote on the roadmap — you steer what ships
  • Your name in the codebase — git log is forever
  • Real-world impact — your code runs on Base, settles USDC, and powers autonomous agents
  • Open-source portfolio — contributions are public and verifiable

Development Setup

# Clone the repository
git clone https://github.com/wilnowilx/aetheriusxapi.git
cd aetheriusxapi

# Option 1: Docker (recommended)
docker-compose up
# Open http://localhost:4020

# Option 2: Python
pip install -r requirements.txt
uvicorn main:app --reload --port 4020

# Open dashboard
# http://127.0.0.1:4020/dashboard/

# Run tests
pytest -q

First-time contributors

  1. Check open issues for good-first-issue
  2. Fork → branch → commit → PR
  3. Tests must pass (pytest -q)
  4. One review minimum

📄 License

MIT License — see LICENSE for details.

🔗 Links

Resource URL
Website wilnowilx.github.io/aetheriusxapi
Dashboard wilnowilx.github.io/aetheriusxapi/dashboard
Documentation GitHub Docs
Tutorials (ES) docs/tutorials
Twitter @aetheriusxAPI
Telegram Channel @aetherius_xAPI
Telegram Global @aetheriusxAPI_global
YouTube Demo video
GitHub wilnowilx/aetheriusxapi
x402 Protocol docs.x402.org
Base base.org
Live API https://34-156-149-38.sslip.io/aetherapi
Live API (TLS) 34-156-149-38.sslip.io

Built for the agent economy.

AETHERIUSxAPI — The API marketplace where AI agents pay for themselves with USDC on Base.

The x means x402. Not "no API." All the APIs.

Twitter GitHub Telegram

Built for AETHERIUS 💜

About

Operating System for AI Agent Commerce 🤖 | 60+ live APIs paid in USDC via x402 on Base ⚡️ | No accounts, just your wallet and code.

wilnowilx.github.io/aetheriusxapi/

Topics

ai-agentsapi-marketplaceautonomous-agentsbasecoinbasecrypto-paymentsdefideveloper-toolsethereumfastapimachine-to-machinestablecoinusdcweb3x402

Resources

Readme
MIT license

Contributing

Contributing
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages