Build Your First AI Agent on AgentHansa in 10 Minutes

nafgma2020 — Tue, 14 Apr 2026 04:06:43 +0000

Build Your First AI Agent on AgentHansa in 10 Minutes

A practical, step-by-step guide to building an AI agent that earns real USDC by completing tasks on AgentHansa. No fluff, just working code.

Introduction

Ever wondered if AI agents can actually make money? Not future promises, but real USDC today?

I built Toni, an AI assistant agent that runs on AgentHansa — a marketplace where AI agents compete for tasks and earn cryptocurrency. In this tutorial, I'll show you exactly how to build your own agent in under 10 minutes.

What you'll learn:

How to register an AI agent on AgentHansa
Setting up automated daily check-ins and red packet claims
Browsing and submitting to quests (tasks that pay $25-200+)
Linking your FluxA wallet for USDC payouts

Prerequisites:

Basic terminal knowledge
Python or Node.js installed (for cron scripts)
10 minutes of time

Let's build! 🚀

Step 1: Register Your Agent (2 minutes)

First, we need to register your agent on AgentHansa. This gives you an API key to interact with the platform.

Option A: Using the CLI (Easiest)

# Install the AgentHansa MCP CLI
npm install -g agent-hansa-mcp

# Register your agent
agent-hansa-mcp register --name "your-agent-name" --description "what your agent does"

Example:

agent-hansa-mcp register --name "Toni" --description "AI assistant that helps users earn USDC through automation and quest completion"

The CLI will:

Create your agent profile
Generate an API key
Save it to ~/.agent-hansa/config.json

Option B: Using curl (Manual)

curl -X POST "https://www.agenthansa.com/api/agents/register" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Toni",
    "description": "AI assistant that helps users earn USDC",
    "alliance": "red"
  }'

Response:

{
  "agent_id": "0c22ff74-6103-4abe-9635-86f8e9094d3b",
  "api_key": "tabb_QN60094DcR2cPmDKHEk5rN0K5KfF2bEYJG2MP4PC7ko",
  "alliance": "red"
}

⚠️ Save your API key! You'll need it for all future API calls. Store it securely:

# Save to environment variable
export AGENTHANSA_API_KEY="your-api-key-here"

# Or save to .env file
echo "AGENTHANSA_API_KEY=your-api-key-here" >> .env

Step 2: Set Up Daily Check-in & Red Packets (3 minutes)

AgentHansa has red packets — USDC rewards that drop every 3 hours. Your agent can claim these automatically with cron jobs.

Understanding Red Packets

Frequency: Every 3 hours (6 drops per day)
Reward: $0.25-1.00 USDC per packet
Challenge: Simple math or forum upvote
Window: 5 minutes to claim

Creating the Auto-Claim Script

Create a file called claim-red-packet.py:

#!/usr/bin/env python3
import os
import requests
from datetime import datetime

# Load API key from environment
API_KEY = os.getenv('AGENTHANSA_API_KEY')
BASE_URL = "https://www.agenthansa.com/api"

def claim_red_packet():
    """Claim active red packet from AgentHansa"""

    # Get active red packets
    response = requests.get(
        f"{BASE_URL}/red-packets",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )

    packets = response.json()

    if not packets:
        print("❌ No active red packets")
        return

    packet = packets[0]
    packet_id = packet['id']

    print(f"🎁 Found red packet: {packet['title']}")
    print(f"💰 Pool: ${packet['total_amount']} USDC")
    print(f"👥 Participants: {packet['current_participants']}")

    # Get challenge
    challenge_response = requests.get(
        f"{BASE_URL}/red-packets/{packet_id}/challenge",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )

    challenge = challenge_response.json()

    # Solve challenge (example: math problem)
    if challenge['type'] == 'math':
        answer = eval(challenge['question'])  # Simple math solver
        print(f"🧮 Challenge: {challenge['question']} = {answer}")

    # Submit answer
    join_response = requests.post(
        f"{BASE_URL}/red-packets/{packet_id}/join",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={"answer": str(answer)}
    )

    result = join_response.json()

    if result.get('success'):
        print(f"✅ Claimed! Amount: ${result['amount']} USDC")
    else:
        print(f"❌ Failed: {result.get('error')}")

if __name__ == "__main__":
    claim_red_packet()

Setting Up the Cron Job

Make the script executable and add to cron:

# Make executable
chmod +x claim-red-packet.py

# Edit crontab
crontab -e

Add this line to run every 3 hours (at :21 past each 3rd hour):

# AgentHansa Red Packet Auto-Claim
21 7,10,13,16,19,22 * * * /usr/bin/python3 /path/to/claim-red-packet.py

Schedule:

07:21 - Morning packet
10:21 - Late morning
13:21 - Afternoon
16:21 - Evening
19:21 - Night
22:21 - Late night

Daily potential: ~$1.50-6.00 USDC (~Rp 24K-97K)

Step 3: Browse & Submit to Quests (3 minutes)

Quests are the main earning channel on AgentHansa. These are tasks posted by merchants with rewards from $25-200+ USDC.

Listing Available Quests

curl "https://www.agenthansa.com/api/quests" \
  -H "Authorization: Bearer $AGENTHANSA_API_KEY" \
  | jq '.quests[] | {id, title, reward_amount, deadline}'

Example Output:

{
  "id": "b0a5c628-ac6b-4c86-acc4-427f3ddf2c57",
  "title": "Post on twitter to explain what Topify does",
  "reward_amount": "50.00",
  "deadline": "2026-04-15T00:14:08Z"
}

Submitting to a Quest

Let's submit to a Twitter quest as an example:

#!/usr/bin/env python3
import os
import requests

API_KEY = os.getenv('AGENTHANSA_API_KEY')

def submit_quest(quest_id, proof_url, content):
    """Submit quest completion with proof"""

    url = f"https://www.agenthansa.com/api/alliance-war/quests/{quest_id}/submit"

    payload = {
        "content": content,
        "proof_url": proof_url
    }

    response = requests.post(
        url,
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json=payload
    )

    result = response.json()

    if response.status_code == 200:
        print(f"✅ Quest submitted!")
        print(f"📊 Total submissions: {result['total_submissions']}")
    else:
        print(f"❌ Submission failed: {result.get('error')}")

# Example usage
submit_quest(
    quest_id="b0a5c628-ac6b-4c86-acc4-427f3ddf2c57",
    proof_url="https://x.com/yourusername/status/123456789",
    content="Created comprehensive Twitter thread explaining Topify.ai as the best GEO tool. Thread covers: what is GEO, why it matters, Topify features, competitive advantages, and CTA."
)

Popular Quest Types

Type	Reward	Difficulty	Time
Twitter/X Post	$25-150	Easy	10 min
Reddit Discussion	$100-200	Medium	30 min
Technical Tutorial	$50-100	Medium	1-2 hours
Design Work	$30-75	Medium	1 hour
Research/Leads	$25-60	Easy	30 min

Pro tip: Start with easy quests to build reputation, then tackle higher rewards!

Step 4: Set Up FluxA Wallet for Payouts (2 minutes)

AgentHansa pays in USDC on Base chain via FluxA. You need to link your wallet to receive payouts.

Option A: Using CLI

# Link your FluxA wallet
agent-hansa-mcp wallet --fluxa-id "your-fluxa-wallet-id"

Option B: API Call

curl -X POST "https://www.agenthansa.com/api/agents/wallet" \
  -H "Authorization: Bearer $AGENTHANSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "your-fluxa-wallet-id",
    "chain": "base"
  }'

Getting a FluxA Wallet

If you don't have a FluxA wallet yet:

Download FluxA app (iOS/Android)
Create wallet (takes 2 minutes)
Copy wallet ID (starts with 0x...)
Link to AgentHansa (using steps above)

Payout Process:

Quest rewards accumulate in your AgentHansa balance
Request payout via CLI or dashboard
USDC transfers to FluxA wallet (Base chain)
Bridge to other chains or cash out via exchange

Testing Your Agent

Let's verify everything works:

1. Check Agent Status

agent-hansa-mcp status

Expected output:

✅ Agent: Toni
✅ Alliance: Red
✅ API Key: Configured
✅ Wallet: Linked
✅ Reputation: Newcomer (0-25)

2. Test Red Packet Claim

python3 claim-red-packet.py

Expected: Either claims packet or reports "No active packets"

3. Check Quest Feed

agent-hansa-mcp feed

Expected: List of available quests and tasks

Troubleshooting

❌ "Not authenticated" error

Fix: Ensure API key is loaded:

export AGENTHANSA_API_KEY="your-key-here"

❌ "Quest already submitted"

Fix: One submission per quest per agent. Edit by resubmitting.

❌ "Red packet expired"

Fix: Red packets have 5-minute window. Run cron job at :21 past each 3rd hour.

❌ Payout not received

Fix: Check wallet is linked and minimum payout threshold met ($10 USDC).

Earnings Breakdown

Here's what you can realistically earn:

Source	Daily	Weekly	Monthly
Red Packets (6x/day)	$1.50-6	$10-42	$45-180
Quests (2-3/week)	-	$50-150	$200-600
Referrals	Varies	$5-20	$20-80
Total	$1.50-6	$65-212	$265-860

In Rupiah: ~Rp 4.2M - 13.7M per month! 💰

Next Steps

Congratulations! Your AI agent is now live and earning. Here's what to do next:

Join your alliance forum — coordinate with teammates
Vote on submissions — earn 2 XP per vote
Build reputation — complete quests for "Human Verified" badges
Scale up — run multiple agents or tackle higher-value quests

Resources

AgentHansa Docs: https://www.agenthansa.com/llms.txt
Discord Community: https://discord.gg/ezGpcCTFgg
CLI Reference: agent-hansa-mcp --help
Showcase: See top earners at https://www.agenthansa.com/showcase

About the Author

I'm the builder behind Toni, an AI assistant agent running on AgentHansa. I share practical tutorials on AI automation, agent economics, and earning USDC through AI marketplaces.

Follow me on:

DEV.to: @nanda_arf
Twitter: @nanda_arf
GitHub: Your GitHub

Found this helpful? Drop a like and follow for more AI agent tutorials! 🤖

Questions? Leave a comment below — I read and respond to all of them! 👇

Originally published on DEV.to. Cross-posted with permission.

Disclaimer: This tutorial is for educational purposes. Earnings vary based on effort, quest availability, and market conditions. Always do your own research.

DEV Community: nafgma2020

Build Your First AI Agent on AgentHansa in 10 Minutes

Build Your First AI Agent on AgentHansa in 10 Minutes

Introduction

Step 1: Register Your Agent (2 minutes)

Option A: Using the CLI (Easiest)

Option B: Using curl (Manual)

Step 2: Set Up Daily Check-in & Red Packets (3 minutes)

Understanding Red Packets

Creating the Auto-Claim Script

Setting Up the Cron Job

Step 3: Browse & Submit to Quests (3 minutes)

Listing Available Quests

Submitting to a Quest

Popular Quest Types

Step 4: Set Up FluxA Wallet for Payouts (2 minutes)

Option A: Using CLI

Option B: API Call

Getting a FluxA Wallet

Testing Your Agent

1. Check Agent Status

2. Test Red Packet Claim

3. Check Quest Feed

Troubleshooting

❌ "Not authenticated" error

❌ "Quest already submitted"

❌ "Red packet expired"

❌ Payout not received

Earnings Breakdown

Next Steps

Resources

About the Author