Use Your 5 Free Trials — 7 Real API Calls for Your AI Agent

Step 0: Get Your Wallet Address (30 seconds)

# Self-custody: bring your own wallet, sign EIP-191 "minia2a register: ".
curl -X POST https://minia2a.uk/api/v1/register-simple \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","wallet":"0xYOUR_WALLET","signature":"0xYOUR_SIGNATURE"}'

1. Multi-Chain Gas Prices

export SERVICE=x402-gas
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/gas?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

2. Current Time (with timezone)

export SERVICE=x402-time
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/time?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

3. Token Security Audit

export SERVICE=x402-token-security
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/token-security?wallet=$WALLET&token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

4. Wallet Intelligence

# NOTE: wallet-intel profiles the SIGNING wallet only — its address= param is
# silently ignored, so asking for someone else's address returns your own profile.
export SERVICE=x402-wallet-intel
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/wallet-intel?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

5. Polymarket Data

export SERVICE=x402-polymarket
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/polymarket?wallet=$WALLET" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

6. Agent Knowledge Retrieval

export SERVICE=x402-recall
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/recall?wallet=$WALLET&q=ethereum+layer+2+scaling+solutions+2026" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

7. Web Search for Agents

export SERVICE=x402-find
export SIG=0xYOUR_SIGNATURE   # EIP-191 sign: minia2a trial:$WALLET:$SERVICE:$TS
curl "https://minia2a.uk/x402/find?wallet=$WALLET&q=best+AI+agent+frameworks+2026" \
  -H "X-Wallet-Signature: $SIG" -H "X-Trial-Timestamp: $TS" | python3 -m json.tool

Use From Python (1-Minute Integration)

Already building an agent? Here's the minimal integration — no SDK required:

import requests

WALLET = "0xYOUR_WALLET_ADDRESS"
BASE = "https://minia2a.uk"

def call_x402(endpoint, params=None):
    """Call any minia2a x402 endpoint with credits."""
    url = f"{BASE}{endpoint}"
    all_params = {"wallet": WALLET}
    if params:
        all_params.update(params)
    r = requests.get(url, params=all_params)
    return r.json()

# Example: Get gas prices and token security
gas = call_x402("/x402/gas")
print(f"Base fee: {gas.get('gas', {}).get('baseFee', 'N/A')}")

token = call_x402("/x402/token-security", {"token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"})
print(f"Token risk: {token.get('risk', 'unknown')}")

That's it. No API keys, no OAuth, no payment setup. The wallet address is all your agent needs.

Check Your Balance

Wondering how many credits you have left? V5 has no per-wallet balance endpoint (/api/v1/credits → 404) — your remaining trial calls come back in each 402 response, and platform-wide numbers live at /api/stats:

curl "https://minia2a.uk/api/stats"

Need more? Send USDC on Base to your wallet and they're added automatically. Or visit minia2a.uk/buy.html.

What's Next?

Once you've tried these 7 calls, here's what you can do: