fluxa-agent-wallet-via-api（fluxa Agent wallet VIA API 文档）

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

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 transfer USDC to another agent by Agent ID? → Construct UPL URL https://walletapi.fluxapay.xyz/unifypaymentlink/agentid/<agentId>?amount=<atomic>&asset=usdc, then follow the x402 flow in 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

Common Patterns

Authentication Header

All Wallet API calls require:

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

Supported Currencies

Amount Format

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

Default Asset

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