​
Agents API

Core Feature: Agents are autonomous financial entities with their own wallets, balances, and transaction rules.

Each agent has its own blockchain wallet, balance, and configurable payment rules. Use the Agents API to create, fund, and manage your AI financial agents.

In sandbox mode only agent-to-agent transactions are currently supported. Agent-to-bank account, agent-to-businesses, and agent-to-checkout pages are coming soon.

​
Agent Model

Complete Control: Configure transaction limits, approval requirements, and other rules to precisely control how your agents handle funds.

An agent consists of:

  • Identity: Unique ID, name, and description
  • Financial Details: Associated wallet address and balance
  • Payment Rules: Transaction limits and approval requirements
  • Status: Current operational status (active, inactive, paused)
  • Metadata: Tags, creation timestamp, and other attributes

​
Agent Structure

{
  "id": "agent_k77NTwxp2Ym3JCmVsKtXQA",
  "name": "Payment Assistant",
  "description": "Handles payment processing for customer support",
  "status": "active",
  "walletAddress": {
    "addressId": "0x9d20dE668c8F9fb431cf6D6BBA48ee60Fe8E2BAB",
    "networkId": "base-sepolia",
    "walletId": "07f490dc-34e3-447f-9972-df2778fcb3c3"
  },
  "balance": "100",
  "currency": "USDC",
  "paymentRules": {
    "dailyLimit": 1000,
    "transactionLimit": 100,
    "requireApprovalForAll": false,
    "requireApprovalAboveAmount": 50.00
  },
  "tags": [
    "customer-support",
    "payments"
  ],
  "createdat": "2025-04-15T11:00:08.432269+00:00"
}

​
Available Endpoints

Get Agent

Fetch details of a specific agent

Create Agent

Create a new agent and fund its wallet

List User Agents

Fetch all agents for a user

Deposit to Agent

Deposit funds into an agent’s wallet

Withdraw from Agent

Withdraw funds from an agent’s wallet

​
Agent Lifecycle

The typical lifecycle of an agent includes:

  1. Creation: An agent is created with a name, description, and initial funding
  2. Configuration: Payment rules are set to control transaction limits and approval requirements
  3. Active Operation: The agent processes transactions according to its configured rules
  4. Maintenance: Funds can be added or withdrawn as needed
  5. Status Changes: An agent’s status can be modified as needed

​
Payment Rules

Safety First: Configure rules to prevent unauthorized spending and ensure financial operations stay within your defined parameters.

Payment rules determine how an agent can spend funds:

  • Daily Limit: Maximum amount the agent can spend in a 24-hour period
  • Transaction Limit: Maximum amount for a single transaction
  • Approval Requirements:
    • requireApprovalForAll: When true, all transactions require manual approval
    • requireApprovalAboveAmount: Transactions above this amount require approval

​
Best Practices

  • Create separate agents for different purposes or departments
  • Use descriptive names and tags to easily identify agents
  • Set appropriate transaction limits based on expected usage patterns
  • Consider requiring approval for large transactions to prevent unauthorized spending
  • Regularly monitor agent activity to ensure proper operation

Blockchain Integration: All agent wallets are real blockchain wallets, with transactions recorded on-chain for maximum transparency and security.