AgentBridge

A specialized gateway for AI agents to fetch and parse Chinese web content into clean Markdown. Pay-per-fetch via x402.

Documentation

AgentBridge Atlas - x402 M2M Micro-Payment Market

AI Agent → On-chain Signature & Payment (0.005 USDC) → Backend Verification & Settlement → National Bureau of Statistics GDP Data Delivered. The M2M (Machine-to-Machine) micropayment loop is live.

Quick Facts

ItemValue
API Basehttps://api.060504.shop
Payment Protocolx402 v2 (EIP-3009, USDC on Base)
Wallet0x1630c8E0833c367F39f0ca909b6b67f5159d7A00
ChainBase (Chain ID 8453)
Settled TXBlock #49848412, 0.005 USDC
Assets96
MCP Tools8 (4 free + 3 paid + 1 payment)
API Paths12

Live Endpoints

EndpointMethodPriceDescription
/healthGETFreeHealth check
/openapi.jsonGETFreeOpenAPI spec (12 paths)
/catalog.jsonGETFree96 assets catalog
/llms.txtGETFreeLLM-readable API docs
/.well-known/mcp/server-card.jsonGETFreeMCP server identity card
/v1/api/industryPOST$0.005 USDCChina NBS statistics (GDP, CPI, PPI)
/v1/api/policyPOST$0.005 USDCChina government policy search
/v1/api/companyPOST$0.003 USDCChina enterprise credit info
/v1/fetch/dynamicPOST$0.008 USDCDynamic web content fetch
/v1/assets/{id}GET$0.01-$9.99 USDCAsset delivery

How x402 Payment Works

1. Agent calls POST /v1/api/industry (no payment header)
2. Server returns 402 Payment Required (x402 v2 challenge)
   - x402Version: 2
   - paymentRequirements: {scheme, network, asset, payTo, maxAmountRequired, ...}
3. Agent signs EIP-3009 TransferWithAuthorization (no gas needed)
4. Agent retries with X-Payment header
5. Server verifies signature → settles on-chain → returns 200 + data
6. On-chain: 0.005 USDC transferred to wallet

On-Chain Proof

  • Transaction Hash: 0xef8d49e88cb58651e9bf30465597b50863dcc363f6e1f227779292149818ae28
  • Method: Transfer With Authorization (EIP-3009, gasless)
  • Amount: 0.005 USDC
  • Block: #49848412
  • Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
  • From: 0xc4217BD72b4dea480ed4879fcec530d92637C800
  • Recipient: 0x1630c8E0833c367F39f0ca909b6b67f5159d7A00
  • Scheme: EIP-3009 (gasless transfer authorization)

Verify on Basescan (Base Mainnet):

Transaction: https://basescan.org/tx/0xef8d49e88cb58651e9bf30465597b50863dcc363f6e1f227779292149818ae28
Wallet: https://basescan.org/address/0x1630c8E0833c367F39f0ca909b6b67f5159d7A00

MCP Server

MCP Server provides 8 tools for AI agents:

Free Discovery Tools

  • discover_capabilities - List all API endpoints
  • discover_china_data_apis - List China Data APIs with pricing
  • get_capability_info - Get details for specific capability
  • get_payment_instructions - Step-by-step x402 payment guide

Paid Data Tools (x402)

  • query_industry_statistics ($0.005) - NBS statistics
  • search_china_policies ($0.005) - Government policy search
  • query_company_credit ($0.003) - Enterprise credit info

Payment Tool

  • purchase_capability - Initiate x402 payment for any endpoint

Quick Start

Test with curl

# 1. Discover the API (free)
curl https://api.060504.shop/health
curl https://api.060504.shop/openapi.json
curl https://api.060504.shop/llms.txt

# 2. Trigger 402 payment challenge
curl -X POST https://api.060504.shop/v1/api/industry \
  -H "Content-Type: application/json" \
  -d '{"keyword":"GDP"}'
# Returns 402 with x402 payment requirements

# 3. Sign EIP-3009 and retry with payment
# See examples/agent_client.py for full implementation

Python Example

# See examples/agent_client.py for complete x402 payment client
python examples/agent_client.py

Data Sources & Compliance

APISourceCompliance
Industrydata.stats.gov.cnRate limited 3s/req, respects robots.txt
Policysousuo.www.gov.cnRate limited 3s/req, HTML fallback
Companygsxt.gov.cnNo captcha bypass, provides official links only

Architecture

AI Agent / User
    │
    ├── GitHub Pages (frontend catalog)
    │
    └── API Server (api.060504.shop)
            │
            ├── China Data APIs (3 endpoints)
            ├── x402 Payment (USDC on Base, EIP-3009)
            └── MCP Server (8 tools)

Tech Stack

  • Backend: FastAPI + Uvicorn (Python)
  • Service: Windows NSSM (NETWORK SERVICE account)
  • Payment: x402 v2 protocol, USDC on Base
  • MCP: Model Context Protocol (SSE & stdio)
  • Frontend: GitHub Pages
  • Data: Chinese government public platforms

Technical Blog & Dev Log

We document the engineering journey of building AgentBridge, exploring x402, MCP, and autonomous M2M commerce.

Read the deep dives on Medium:

🚀 Building an Autonomous M2M Payment Loop: AI Agents Paying for Data via x402)

🌉 AgentBridge: The Data Bridge Between China’s Public Information and Global AI Agents

🛡️ How AI Agents Can Legally Access Chinese Public Data: A Technical Deep Dive

Follow the full dev log on Medium:

Version History

  • v1.0 (2026-08-07): Initial deployment, 76 assets
  • v2.0 (2026-08-16): 5 new guides, cleanup, 94 assets
  • v3.0 (2026-08-16): China Data APIs + MCP Server, 96 assets
  • v3.1 (2026-08-17): x402 end-to-end payment verified, 0.005 USDC settled

License

Commercial. All data sourced from public government platforms.

🌐 Ecosystem & Trust

AgentBridge is recognized and indexed across the x402 and MCP ecosystems:

Protocol Indexes

  • x402scan — active service, listed with 12+ on-chain transactions in the past 30 days (search for "AgentBridge")

  • the402.ai — included in the x402 ecosystem directory (MCP-accessible catalog)

  • x402 Discovery Index — community discovery listing, PR pending merge → github.com/x402-index/x402-discovery-index/pull/35

Marketplaces

MCP Ecosystem

On-Chain Proof

Links

Disclaimer

The data provided by this API is sourced from public macroeconomic and educational statistics. We do not host or own the data. Users are responsible for complying with their local data usage regulations.