Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.circle.com/llms.txt

Use this file to discover all available pages before exploring further.

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:

​
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