Payments & Spending
ClawCredit is strictly for x402 Service Endpoints. It enables your Agent to consume paid APIs, buy compute, or access premium data feeds. It is not a general-purpose wallet for P2P transfers.
What You Can Pay For
x402 Services
Any API or tool that supports the x402 payment protocol. The Agent delegates the request to ClawCredit, which handles the payment and retrieval.
General Transfers
Sending crypto to a friend's wallet, exchange deposits, or arbitrary P2P transfers are not supported and will be rejected by the Trustline.
The Process (x402)
The Agent does not need to handle payment challenges manually. It simply delegates the task to the SDK:
1. Identify Service
The Agent finds an x402 endpoint it needs to call (e.g., "Premium Search").
2. Delegate Request
It sends the request details to ClawCredit via credit.pay(), declaring the intent to use credit.
3. Execution & Settlement
ClawCredit validates the request, pays the merchant on-chain, and proxies the HTTP call.
4. Result Delivery
ClawCredit returns the actual service response (JSON/Data) directly to the Agent.
Conversation Flow: Making a Payment
You don't need to write code. Just talk to your Agent and it handles everything.
"I want to use my ClawCredit to call this x402 endpoint: https://x402.org/sample"
Provide any x402 service URL. The Agent will identify the payment requirement automatically.
"I've detected this is an x402 endpoint requiring $0.01 USDC on Base. Let me pay with your ClawCredit and retrieve the result..."
The Agent calls credit.pay() behind the scenes — ClawCredit handles the on-chain payment and proxies the request.
"Done! Payment settled on Base (USDC). Here is the response from the service: ..."
The Agent reports which chain the transaction settled on, the cost, and delivers the service response. Your Universal Credit balance is used by default; if you have a chain-specific Credit Grant, it will be consumed first.
Conversation Flow: Redeem a Credit Grant
We are working with some top ecosystems and partners who will distribute Credit Grant codes. Your Agent can redeem them instantly to get extra credit on specific chains.
"I have a ClawCredit redeem code: T54-GRANT-50USD. Please redeem it."
You may receive a redeem code from a partner, hackathon, or promotional campaign.
"Redeem code applied successfully! You've received a $50.00 Credit Grant on Solana. This credit can be used for any x402 service on the Solana chain."
The Agent calls credit.redeemCode(). The granted credit appears immediately in your balance, scoped to the specific chain if applicable.
Supported Chains
