A specialized skill for interacting with Breeze payment-gated endpoints to manage Solana investment positions and execute x402 API calls.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install breeze-x402-payment-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install breeze-x402-payment-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Breeze x402 Payment API?
This skill enables AI agents to interact with Breeze through its unique x402 payment-gated HTTP API. By leveraging Openclaw Skills, developers can automate Solana-based financial operations where each protected request is authorized via a small USDC micropayment. The skill handles the complexities of the x402 protocol, including challenge-response cycles and transaction serialization, ensuring seamless integration into automated trading or portfolio management workflows.
It provides a bridge between high-level agent instructions and low-level Solana blockchain interactions. By returning raw API data or unsigned transactions, it allows for local signing and broadcasting, maintaining a high level of security while enabling autonomous financial management. This is essential for developers looking to build sophisticated agents that can manage liquidity and yield-bearing positions without manual intervention.
Breeze x402 Payment API Use Cases
- Check real-time Breeze account balances, deposited amounts, and APY stats.
- Automate deposits of USDC or other supported tokens into Breeze investment strategies.
- Execute withdrawals from Breeze strategies back to a native Solana wallet.
- Programmatically access payment-gated data using the x402 protocol for secure API interactions.
How Breeze x402 Payment API Works
- The skill initializes a connection to the Solana RPC and loads the WALLET_PRIVATE_KEY from the environment.
- A payment-wrapped fetch instance is configured using @faremeter handlers to manage USDC micropayments automatically when hitting gated endpoints.
- The agent sends a request (e.g., deposit or balance check) to the Breeze x402 API server.
- For transaction-based requests, the API returns an unsigned, base64-encoded transaction string.
- The skill deserializes the transaction, supporting both Versioned and Legacy formats, and signs it locally using the provided keypair.
- The signed transaction is broadcast to the Solana network and confirmed, returning the final signature and explorer link to the user.
Breeze x402 Payment API Setup
Ensure you have Node.js installed and a Solana wallet funded with USDC and at least 0.01 SOL. Install the required dependencies using the following command:
npm install @faremeter/fetch @faremeter/payment-solana @faremeter/wallet-solana @faremeter/info @solana/web3.js bs58 --legacy-peer-deps
Set your environment variables in a .env file:
WALLET_PRIVATE_KEY=your_base58_encoded_private_key
STRATEGY_ID=43620ba3-354c-456b-aa3c-5bf7fa46a6d4
Breeze x402 Payment API Data Schema & Taxonomy
The skill processes data using specific metadata and token standards to ensure transaction accuracy.
| Data Type | Format | Description |
|---|---|---|
| Balance Data | JSON | Contains positions, deposited base units, and earned yield. |
| Transaction | Base64 String | An unsigned Solana transaction (Versioned or Legacy). |
| Strategy ID | UUID | The unique identifier for the Breeze vault strategy. |
| Token Amounts | BigInt/Base Units | Values scaled by token decimals (e.g., 6 for USDC, 9 for SOL). |
| Wallet Key | Base58 | The public address used for ownership verification and fund routing. |
Breeze x402 Payment API Advanced Features
- Automatic x402 challenge-response handling for seamless, autonomous paid API access.
- Dual-transaction support for both VersionedTransactions and Legacy Transaction formats.
- Integrated WSOL management including automatic wrapping and unwrapping for native SOL withdrawals.
- Strategy-agnostic design allowing developers to point the skill at any valid Breeze strategy ID.
- Built-in preflight health checks to ensure API availability before committing micropayments.
SKILL.md
Loading
Related Openclaw Skills
API Gateway
A secure passthrough proxy that simplifies connecting AI agents to over 100 native third-party APIs using managed OAuth token injection.
Agent Browser
A high-performance Rust-based headless browser CLI designed for AI agents to interact with web pages via structured commands.
UI/UX Master
A comprehensive design skill combining Apple Human Interface Guidelines and modern web patterns for creating exceptional, universal user experiences.
Cluster Agent Swarm
A comprehensive multi-agent swarm designed to automate and coordinate Kubernetes and OpenShift platform operations across seven specialized domains.
Breeze x402 Payment API
A payment-gated API skill for interacting with the Breeze Solana yield aggregator using x402 USDC micropayments.
paradiz
An automated VK interaction skill that calculates hotel stay costs from Excel price lists and manages the full booking lifecycle.
METADATA
Featured*
