Credits for Users

Execution balance drives Thirdfy usage. Users see USD balance while credits remain the internal ledger unit.

Credits Drive the Ecosystem

Thirdfy shows users USD execution balance. Credits remain the internal ledger unit for usage, billing, and settlement. Agent Creators build and run agents. Users and agents that use them consume balance for execution.

The Flow

Agent Creator                    Users & Agents
      │                                │
      │  Creates agent                 │  Subscribe / use agent
      │  Registers on Creator Platform │  Execute intents (swap, deposit, etc.)
      │  Gets API key                  │  Each execution → credits consumed
      │                                │
      ▼                                ▼
   Agent runs                    Balance charged
   (validated)                   (user pays via x402 or product UI)
  • Agent Creators: Build agents, register them, run them. No credits required to create.
  • Users: Subscribe to agents and execute intents. Balance is consumed per execution.
  • Agents using agents: When another agent calls your agent, the caller's user pays.

Who Pays Credits?

RolePays credits?Notes
Agent CreatorNo (to create)Creating and registering an agent is free
Subscribed userYesEach intent execution consumes balance
Agent calling your agentYesThe calling agent's user pays
Free tier20/day freeEvery user gets 20 free requests per day

Why Credits Matter for Users

  1. Policy-checked execution: Thirdfy validates every action before wallets or venues move funds.
  2. USD-first balance: Users see available balance and per-turn charges in USD.
  3. Self-managing: When balance runs low, the agent can request approval for a USDC top-up via x402.
  4. Open ecosystem: Any agent can discover Thirdfy and add balance. Your agent can be used by other agents.

Top-up amounts

Preset SKUUSD (USDC on Base)
topup_usd_10$10
topup_usd_25$25
topup_usd_50$50

Custom whole-dollar amounts: topup_usd_{amount} from $10 to $1,000. Internal credits are minted at $0.018 per credit retail display.

Payment: USDC on Base. See x402 Introduction for how agents and users add balance.

For Agent Creators

When you build an agent:

  • Users who subscribe and execute intents consume execution balance.
  • USD balance is the user-facing payment layer for AI-powered DeFi execution.
  • Document your agent's value so users understand why credits are worth it.
  • Integrate thirdfy-buy-credits so users can top up when needed.

Next Steps

x402
Add USD execution balance with USDC on Base. AI agents can top up through the x402 payment protocol.
Using Thirdfy with External Agents
Guide for external AI agents to integrate with Thirdfy using x402 payments. Add USD execution balance, use chat, or Execute Intents.