FluxA Agent Wallet (via API)

FluxA Agent Wallet lets AI agents perform onchain financial operations — payments, payouts, and payment links — without managing private keys. All signing is handled server-side by FluxA Wallet; agents only need an Agent JWT to authenticate API calls.

Capabilities

Capability	What it does	When to use
x402 Payment (v3)	Pay for APIs using the x402 protocol with intent mandates	Agent hits HTTP 402, needs to pay for API access
Payout	Send USDC to any wallet address	Agent needs to transfer funds to a recipient
Payment Link	Create shareable URLs to receive payments	Agent needs to charge users, create invoices, sell content

Prerequisites

Every API call requires an Agent JWT obtained by registering an Agent ID.

Register Agent ID

curl -X POST https://agentid.fluxapay.xyz/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "agent@example.com",
    "agent_name": "My AI Agent",
    "client_info": "Agent v1.0"
  }'

Response returns agent_id, token, and jwt. Use the jwt as Authorization: Bearer <jwt> for all subsequent calls.

Refresh JWT when expired (via CLI):

fluxa-wallet refreshJWT

Or via API:

curl -X POST https://agentid.fluxapay.xyz/refresh \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "<AGENT_ID>", "token": "<TOKEN>"}'

Quick Decision Guide

Need to pay for an API that returned HTTP 402? → See X402-PAYMENT.md
Need to send funds to a wallet address? → See PAYOUT.md
Need to receive payments via a shareable link? → See PAYMENT-LINK.md

Base URLs

Service	URL
Agent ID API	`https://agentid.fluxapay.xyz`
Wallet API	`https://walletapi.fluxapay.xyz`

Common Patterns

Authentication Header

All Wallet API calls require:

Authorization: Bearer <AGENT_JWT>
Content-Type: application/json

Supported Currencies

Currency	Value	Description
`USDC`	`USDC`	USD Coin
`XRP`	`XRP`	XRP
`FLUXA_MONETIZE_CREDITS`	`FLUXA_MONETIZE_CREDITS`	Credits for FluxA Monetize, used to consume FluxA Monetize resources

Amount Format

All amounts are in smallest units (atomic units). For USDC (6 decimals):

Human-readable	Atomic units
0.01 USDC	`10000`
0.10 USDC	`100000`
1.00 USDC	`1000000`
10.00 USDC	`10000000`

Default Asset

Network: Base (chain ID 8453)
Currency: USDC
Asset address: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913