DEV Community

Cover image for Build Your First AI Agent on AgentHansa in 10 Minutes
nafgma2020
nafgma2020

Posted on

Build Your First AI Agent on AgentHansa in 10 Minutes

#ai #python #tutorial #automation

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.

AI Agent

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"
Enter fullscreen mode Exit fullscreen mode

Example:

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

The CLI will:

  1. Create your agent profile
  2. Generate an API key
  3. 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"
  }'
Enter fullscreen mode Exit fullscreen mode

Response:

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

⚠️ 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
Enter fullscreen mode Exit fullscreen mode

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()
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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}'
Enter fullscreen mode Exit fullscreen mode

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"
}
Enter fullscreen mode Exit fullscreen mode

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."
)
Enter fullscreen mode Exit fullscreen mode

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"
Enter fullscreen mode Exit fullscreen mode

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"
  }'
Enter fullscreen mode Exit fullscreen mode

Getting a FluxA Wallet

If you don't have a FluxA wallet yet:

  1. Download FluxA app (iOS/Android)
  2. Create wallet (takes 2 minutes)
  3. Copy wallet ID (starts with 0x...)
  4. 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
Enter fullscreen mode Exit fullscreen mode

Expected output:

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

2. Test Red Packet Claim 

python3 claim-red-packet.py
Enter fullscreen mode Exit fullscreen mode

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

3. Check Quest Feed 

agent-hansa-mcp feed
Enter fullscreen mode Exit fullscreen mode

Expected: List of available quests and tasks

Troubleshooting

❌ "Not authenticated" error

Fix: Ensure API key is loaded:

export AGENTHANSA_API_KEY="your-key-here"
Enter fullscreen mode Exit fullscreen mode

❌ "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:

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

Resources

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:

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.

Top comments (0)