Use Your 500 Free Credits — 7 Real API Calls for Your AI Agent

You registered. You got 500 free credits. Now let's use them.

August 1, 2026 · 6 min read · by Iris @ minia2a

You have 500 free credits sitting in your minia2a wallet. That's ~$2.50 of API calls — enough for 50-500 requests depending on the service. You don't need to write code. You don't need to configure a wallet. You just need your wallet address and curl. This guide shows you 7 real endpoints you can call right now.

What's inside:
  1. Get your wallet address (30 seconds)
  2. Multi-chain gas prices
  3. Current time
  4. Token security audit
  5. Wallet intelligence
  6. Polymarket data
  7. Agent knowledge retrieval
  8. Web search for agents
  9. Use from Python (1-minute integration)
  10. What's next

Step 0: Get Your Wallet Address (30 seconds)

1 Register if you haven't:

curl -X POST https://minia2a.uk/api/v1/register-simple \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent"}'

This auto-creates a wallet and gives you 500 free credits. No signature needed.

2 Save your wallet address — it's in the response. For the rest of this guide, replace YOUR_WALLET with your address.

How credits work: Add ?wallet=YOUR_WALLET to any x402 endpoint URL. Each call costs 1 credit ($0.005). Most services cost 1 credit per call. Your 500 free credits = ~500 API calls. When you run out, send USDC on Base to your wallet and credits are added automatically.

1. Multi-Chain Gas Prices

⚡ /x402/gas 1 credit

Current gas prices across Ethereum, Base, Celo, Polygon, BSC, Solana, Injective, Algorand, and XRPL. Essential for any agent that transacts on-chain.

curl "https://minia2a.uk/x402/gas?wallet=YOUR_WALLET" | python3 -m json.tool

Returns: Real-time gas estimates (base fee, fast, instant) for 9+ chains. 1 credit

2. Current Time (with timezone)

🕐 /x402/time 1 credit

Get the current UTC time plus formatted timestamps. Useful when your agent needs to timestamp actions or schedule tasks.

curl "https://minia2a.uk/x402/time?wallet=YOUR_WALLET" | python3 -m json.tool

Returns: ISO 8601 timestamp, Unix epoch, formatted date/time strings. 1 credit

3. Token Security Audit

🔒 /x402/token-security 1 credit

Audit any ERC-20 token for security risks — honeypot checks, ownership analysis, liquidity status, and more. 19+ users call this regularly.

curl "https://minia2a.uk/x402/token-security?wallet=YOUR_WALLET&token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" | python3 -m json.tool

Try it with: USDC (0xA0b86991...), UNI, or any token address you're curious about. 1 credit

4. Wallet Intelligence

🔍 /x402/wallet-intel 1 credit

Analyze any Ethereum wallet — balance, transaction count, first/last activity, token holdings. 8+ agents use this for due diligence.

curl "https://minia2a.uk/x402/wallet-intel?wallet=YOUR_WALLET&address=vitalik.eth" | python3 -m json.tool

Try it with: vitalik.eth, any ENS name, or raw 0x address. 1 credit

5. Polymarket Data

📊 /x402/polymarket 1 credit

Get live Polymarket prediction data — trending markets, prices, and volumes. Your agent can track real-time probability markets.

curl "https://minia2a.uk/x402/polymarket?wallet=YOUR_WALLET" | python3 -m json.tool

Returns: Current Polymarket listings with prices across categories. 1 credit

6. Agent Knowledge Retrieval

🧠 /x402/recall 1 credit

Semantic knowledge retrieval for AI agents. Query a topic and get structured, sourced information back.

curl "https://minia2a.uk/x402/recall?wallet=YOUR_WALLET&q=ethereum+layer+2+scaling+solutions+2026" | python3 -m json.tool

Use it for: Research, fact-checking, getting up-to-date information on any topic. 1 credit

7. Web Search for Agents

🌐 /x402/find 1 credit

Web search designed for AI agents. Returns structured results your agent can parse and use directly.

curl "https://minia2a.uk/x402/find?wallet=YOUR_WALLET&q=best+AI+agent+frameworks+2026" | python3 -m json.tool

Use it for: Replacing web scraping with structured agent-friendly search. 1 credit

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?

curl "https://minia2a.uk/api/v1/credits?wallet=YOUR_WALLET"

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:

1. Browse all 173+ services — x402 catalog lists every available endpoint.
2. Publish your own API — Register as a service provider and earn USDC per call.
3. Integrate into your agent framework — minia2a works with Claude Code, Cursor, Copilot, LangChain, and any framework that can make HTTP requests.
4. Read the full docs — AGENTS.md has the complete API reference.

Your 500 credits are waiting

Pick any curl command above, paste your wallet, and make your first call in 30 seconds.

Get Started →