You Have 5 Free Trials.
Here's What Your AI Agent Can Do Today.

1. Get Live Gas Prices Across 4 Chains

Real-time gas prices for Ethereum, Base, Arbitrum, and Optimism. Your trading bot or DeFi agent needs this before submitting any transaction.

# serviceId for the trial message: x402-gas
curl -s "https://minia2a.uk/x402/gas?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS"

curl "https://minia2a.uk/x402/gas?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS"
# -> 200, x-trial-mode: wallet, x-trial-remaining: 4

2. Audit a Token for Rug Pull Risks

Honeypot check, owner control analysis, LP lock status, holder concentration, and rug pull risk score. Every DeFi agent should run this before touching a new token.

# serviceId: x402-token-security
curl -s "https://minia2a.uk/x402/token-security?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" \
  -H "Content-Type: application/json" \
  -d '{"token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"base"}'

3. Scrape JavaScript-Rendered Web Pages

Headless Chromium renders the page and returns the resulting HTML, so SPAs, React apps and JS-walled content come back readable. Your research agent can read any page on the internet.

# serviceId: x402-browser-scrape
curl -s "https://minia2a.uk/x402/browser-scrape?wallet=$WALLET&url=https://example.com" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS"

4. Give Your Agent Persistent Memory

Give your agent persistent memory. Store facts, user preferences, or session state. Retrieve instantly by key. The stickiest endpoint on the platform — agents that use recall average 15.9 calls each.

# serviceId: x402-store
curl -s "https://minia2a.uk/x402/store?wallet=$WALLET&content=meeting+notes+for+Aug+3" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS"

5. Audit a Contract Before You Trust It

Static analysis of Solidity source: access control, reentrancy, unchecked calls and the rest, returned as structured findings with severities. Your agent can screen a contract before it approves or funds anything. Pass source; a separate AI deep-audit tier is available if you want business-logic review.

# serviceId: x402-smart-contract-audit
curl -s "https://minia2a.uk/x402/smart-contract-audit?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" \
  -H "Content-Type: application/json" \
  -d '{"source":"pragma solidity ^0.8.0; contract T { mapping(address=>uint) b; function w() public { payable(msg.sender).transfer(b[msg.sender]); } }"}'

6. Get Real-Time Prediction Market Data

Live Polymarket odds, volume, and liquidity. Browse active prediction markets. Your analysis agent gets real-time crowd-predicted probabilities.

# serviceId: x402-polymarket
curl -s "https://minia2a.uk/x402/polymarket?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS"

7. AI-Powered Web Research

Multi-step web browsing agent. Give it a URL and a question — it browses, extracts, and returns a structured AI answer. Your research agent's secret weapon.

# serviceId: x402-web-retrieve
curl -s "https://minia2a.uk/x402/web-retrieve?wallet=$WALLET&url=https://en.wikipedia.org/wiki/Ethereum" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS"

ai-sdk-x402 — Call Any x402 Endpoint as an AI SDK Tool

Wrap any x402 endpoint as a typed AI SDK tool. Your agent discovers the tool, calls it, pays automatically — all in one generateText() call. No curl, no manual 402 handling.

import { x402Tool } from 'ai-sdk-x402';
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools: {
    getGas: x402Tool({
      endpoint: 'https://minia2a.uk/x402/gas',
      description: 'Get live gas prices across 4 chains',
    }),
    checkToken: x402Tool({
      endpoint: 'https://minia2a.uk/x402/token-security',
      description: 'Audit a token for rug pull risks',
      parameters: z.object({ token: z.string(), chain: z.string() }),
    }),
    searchWeb: x402Tool({
      endpoint: 'https://minia2a.uk/x402/web-search',
      description: 'Search the web',
      parameters: z.object({ q: z.string() }),
    }),
  },
  prompt: 'Check gas prices, audit USDC on Ethereum, and search for latest ETH news.',
});

// One generateText() call. Three paid API calls. Automatic USDC settlement.
// Set X402_WALLET env var or pass wallet in tool config.

📖 npm docs · Default facilitator: minia2a.uk (all endpoints) · Overridable via X402_FACILITATOR env var

Complete Python Agent With x402 Payments

This agent checks gas prices, audits a token, and scrapes a web page — all paying automatically in USDC. Save as my-agent.py and run.

import requests, os

import time
from eth_account import Account
from eth_account.messages import encode_defunct

ACCT = Account.from_key(os.environ["MINIA2A_PRIVATE_KEY"])  # stays local; only the signature is sent
WALLET = ACCT.address
BASE = "https://minia2a.uk/x402"
PARAMS = {"wallet": WALLET}

def trial_headers(service_id):
    """Wallet trials are signed per call. service_id is the catalog id from
    /api/services (e.g. x402-gas) — NOT the URL slug (gas)."""
    ts = str(int(time.time()))
    sig = ACCT.sign_message(
        encode_defunct(text=f"minia2a trial:{WALLET}:{service_id}:{ts}")
    ).signature.hex()
    return {"Content-Type": "application/json",
            "X-Wallet-Signature": sig, "X-Trial-Timestamp": ts}

def call(endpoint, data=None):
    """Call any x402 endpoint — auto-handles HTTP 402 payment."""
    url = f"{BASE}/{endpoint}"
    HEADERS = trial_headers(f"x402-{endpoint}")
    r = requests.post(url, json=data or {}, headers=HEADERS, params=PARAMS) if data \
        else requests.get(url, headers=HEADERS, params=PARAMS)
    if r.status_code == 402:
        # Payment required — in production, your wallet signs + pays here
        print(f"[402] Payment required: {r.json().get('price', 'unknown')}")
        return None
    return r.json()

# 1. Check gas prices ($0.50)
gas = call("gas")
print(f"⛽ Gas: {gas.get('result',{}).get('gasPriceGwei','?')} gwei" if gas else "gas failed")

# 2. Audit a token ($0.02)
audit = call("token-security", {"token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chain": "ethereum"})
print(f"🔍 USDC risk: {audit.get('risk','?')}" if audit else "audit failed")

# 3. Scrape a page ($0.50)
page = call("browser-scrape", {"url": "https://news.ycombinator.com"})
print(f"📄 Page title: {page.get('title','?')}" if page else "scrape failed")

print(f"\n✅ Done. Check https://minia2a.uk/api/stats for live balance.")