Hackathon Guide
Welcome, builder! This guide gives you a fast, complete picture of what FluxA can do — and what you can build with it. Read this page first, pick a use case, and start hacking.
What is FluxA
FluxA is an AI agent payment infrastructure. It lets AI agents pay, get paid, and transfer money — all programmable via API, settled across USDC, credit, and card rails.
Your App / Agent ──── FluxA CLI / API ──── FluxA Wallet (USDC, Credit, Card)No private keys. No gas management. No manual approvals during runtime. Just API calls.
Try FluxA end-to-end first
Before you start coding, spend 5 minutes as a user of FluxA. Feeling the full loop — install → fund → spend — makes everything else in this guide click.
1. Install the wallet skill into your agent
Point your coding agent (Claude Code, OpenClaw, or any skill-compatible runtime) at the FluxA skill and let it install itself:
Read and install https://fluxapay.xyz/skill.mdThe agent will fetch the skill, drop it into the right skills directory, and gain the ability to pay for APIs, send USDC, and create payment links. See Agent Skills →.
2. Claim experience USDC from ClawPi
Open the FluxA Wallet, go to the ClawPi social module, and claim the welcome red packet — this drops some free experience USDC into your wallet so you can try everything without topping up first. You can ask your agent:
Go try ClawPi and claim the red packet for me3. Try a Oneshot API call
The wallet ships with Oneshot APIs built in — curated paid APIs you can call in a single prompt, with the payment handled automatically via your mandate. Pick one, call it, and watch the x402 + mandate flow complete without any glue code on your side.
Once you've paid an API, sent USDC, and received funds yourself, you have a real feel for what FluxA does. Now the building blocks below will map directly onto things you've already done.
Core building blocks
FluxA gives you 7 building blocks. Every hackathon project is a creative combination of these:
1. Agent ID
Every agent gets a unique, verifiable identity. The user authorizes the agent once, and the agent then operates autonomously within the user's guardrails.
2. Mandate (spending budget)
A mandate is a pre-approved spending budget: amount + time window + optional host scope. Once the user signs a mandate, the agent can spend within that budget without per-transaction approval.
"I authorize this agent to spend up to 10 USDC over the next 30 days on APIs hosted at api.example.com"This is the key to autonomous agent payments.
3. x402 Payment (pay for APIs)
When an API returns HTTP 402 (Payment Required), the agent uses its mandate to sign a payment, attaches the proof as an X-Payment header, and retries — all automatically.
Agent → GET /api → 402 Payment Required
Agent → sign payment via mandate → GET /api + X-Payment header → 200 OK4. Payment Link (collect payments)
Create a shareable URL with a fixed USDC price. Anyone (human or agent) can pay it. Optionally deliver digital content after payment.
POST /api/payment-links
→ { linkId: "pl_xxx", url: "https://...paymentlink/pl_xxx" }5. Unify Payment Link / UPL (pay any agent)
Send USDC to any agent using just their Agent ID. No wallet address needed. No setup by the recipient. Permanent endpoint.
https://walletapi.fluxapay.xyz/unifypaymentlink/agentid/<agentId>?amount=5000000&asset=usdc6. Payout (send USDC out)
Transfer USDC from the agent's wallet to any external address on Base. The user approves in the wallet UI, then the transfer is broadcast onchain.
7. Monetize Platform
Turn any HTTP API into a pay-per-call endpoint without writing payment code. Register on the Monetize platform, configure your endpoints and pricing, and the gateway handles x402 challenges, payment verification, and settlement for you.
Capabilities at a glance
| I want to... | Use this | Flow |
|---|---|---|
| Pay for an API automatically | x402 + Mandate | Agent signs payment → retries with proof |
| Charge per API call (zero code) | Monetize Gateway | Configure on platform → proxy handles everything |
| Sell something with dynamic pricing | Payment Link Checkout | Service creates order + link → agent pays → service verifies |
| Send money to another agent | UPL | Construct URL with Agent ID + amount → pay |
| Receive money from anyone | Payment Link | Create link → share → get paid |
| Distribute payments to many agents | UPL (batch) | Loop: construct UPL for each agent → pay |
| Send USDC to an external wallet | Payout | POST /api/payouts → user approves → onchain transfer |
| Refund a payment | Refund | Initiate → pay refund link → funds return to payer |
Use case ideas
Agent Commerce
| Idea | Description | Building blocks |
|---|---|---|
| AI Agent Marketplace | Agents list services with payment links, other agents browse and purchase | Payment Link + Payment Link Checkout |
| Agent-to-Agent Service Bus | Agent A calls Agent B's API, pays via x402 automatically | x402 + Mandate + Monetize Gateway |
| AI E-commerce Store | Agent sells digital goods (reports, images, code), delivers content after payment | Payment Link (resourceContent) |
Platform & Payroll
| Idea | Description | Building blocks |
|---|---|---|
| AI Agent Salary System | Platform distributes daily/weekly USDC salaries to working agents | UPL (batch) |
| Bounty Board | Post tasks with rewards, pay agents who complete them via UPL | UPL + Agent ID |
| Revenue Sharing | Agent receives payments, splits revenue to multiple addresses | Payment Link + Payout |
Finance & Payments
| Idea | Description | Building blocks |
|---|---|---|
| Expense Splitting Agent | Tracks shared costs between agents, settles via UPL | UPL + Agent ID |
| Invoice Agent | Creates payment links as invoices, tracks who paid | Payment Link + Received Payments |
| Escrow Service | Holds payment in a link, verifies condition met, releases funds via payout | Payment Link Checkout + Payout |
| Refund Manager | Monitors transactions, auto-issues refunds when conditions are met | Refund + Received Payments |
Data & AI Services
| Idea | Description | Building blocks |
|---|---|---|
| Paid AI Tool API | Wrap your ML model / data API with pay-per-call | Monetize Gateway |
| Research Report Store | Agents generate reports, sell via payment links with delivery | Payment Link (resourceContent) |
| Premium Data Feed | Agents subscribe by creating a mandate, access data via x402 | x402 + Mandate |
Multi-Agent Systems
| Idea | Description | Building blocks |
|---|---|---|
| Delegated Payments | Orchestrator agent delegates payment tasks to a payment specialist agent | Payment Link Checkout (A2A) |
| Agent Tipping Network | Users or agents tip AI agents for good work via UPL | UPL |
| Agent DAO Treasury | Collective agents vote on spending, execute via mandates | Mandate + Payout + UPL |
Want to see these ideas running? Browse existing reference implementations in the FluxA Playground → — live examples you can inspect, remix, and fork as a starting point for your project.
Architecture patterns
Pattern 1: Pay-to-access API
Your agent wraps an API with payment. Simplest pattern.
Client Agent → Your API (402) → FluxA Wallet (sign) → Your API (200 + data)Setup: Register on Monetize platform, configure endpoints and pricing. Done.
Pattern 2: Order → Pay → Deliver
Your service creates an order with dynamic pricing, the agent pays, you verify and deliver.
Agent → POST /order → Your Service → create payment link → return URL
Agent → pay URL → POST /confirm → Your Service → verify → deliverSetup: See Payment Link Checkout guide with Node.js example.
Pattern 3: Agent-to-agent transfer
One agent sends USDC to another agent directly.
Agent A → construct UPL (Agent B's ID + amount) → pay via x402 → doneSetup: Just need Agent B's Agent ID. See Pay to Agent guide.
Pattern 4: Platform batch payouts
Your platform pays multiple agents (salaries, bounties, rewards).
Platform → for each agent:
→ construct UPL URL → sign via mandate → submit → nextSetup: Create one mandate with sufficient budget, loop through agents.
5-minute quick start
Step 1 — Get a wallet
Go to agentwallet.fluxapay.xyz, log in, and fund your wallet with USDC.
Step 2 — Register an agent
curl -X POST https://agentid.fluxapay.xyz/register \
-H "Content-Type: application/json" \
-d '{ "agent_name": "Hackathon Agent", "client_info": "hackathon-2025" }'Save the returned agent_id, token, jwt.
Step 3 — Authorize the agent
Open the authorizationUrl from the response in your browser. Approve the agent in the FluxA Wallet UI.
Step 4 — Try a payment
Run the Quick Start playground prompt to see an end-to-end x402 payment in action.
Step 5 — Build your project
Pick a use case from above, combine the building blocks, and start building!
API base URLs
| Service | URL |
|---|---|
| Agent ID registration | https://agentid.fluxapay.xyz |
| Wallet API | https://walletapi.fluxapay.xyz |
| Wallet Dashboard | https://agentwallet.fluxapay.xyz |
| Monetize Platform | https://monetize.fluxapay.xyz |
Key reference links
| Topic | Guide | API Reference |
|---|---|---|
| Agent ID & Auth | Agent Guide | Registration API |
| x402 Payment | X402 Guide | X402 V3 API |
| Mandates | X402 Guide | Mandates API |
| Payment Link | Payment Link Guide | Payment Links API |
| UPL | UPL Guide | UPL API |
| Payout | Payout Guide | Payout API |
| Refund | Payment Link Guide | Refunds API |
| Accept Payments | Payment Guide | Received Payments |
| Monetize API | Monetize Gateway | Seller Guide |
| MCP Integration | Local MCP, Remote MCP | — |