Quickstart: Make a nanopayment

Deposit USDC into Gateway, find an x402-compatible service, and pay for it with your agent wallet.

By the end of this quickstart, your agent will have made a nanopayment to an x402-compatible service.

Prerequisites

Before you begin, ensure you have:

• Installed Node.js v20.18.2 or later.

• Installed Circle CLI:

  npm install -g @circle-fin/cli
  

• Completed the Agent Wallets quickstart (authenticates and funds your wallet).

Steps

1. Deposit USDC into your nanopayments balance

   Deposit 5 USDC from your wallet on Base:

   circle gateway deposit --amount 5 --address 0xYourWalletAddress --chain BASE --method direct
   
2. Find an x402-compatible service

   Search the Circle Agent Marketplace for available services:

   circle services search "weather"
   

   Pick a service and inspect its payment requirements:

   circle services inspect https://api.example.com/weather
   
3. Pay for the service

   Pay with your Gateway balance on Base. Replace 0xYourWalletAddress with your wallet address:

   circle services pay https://api.example.com/weather \
     --address 0xYourWalletAddress \
     --chain BASE \
     --max-amount 0.01
   

   The CLI prints the service’s response body. The payment settles against your Gateway balance.

4. Check your balance

   Confirm your remaining Gateway balance:

   circle gateway balance --address 0xYourWalletAddress --chain BASE
   

Next steps

• Pay for more services using your remaining balance.
• Withdraw your balance back to your wallet when you’re done.