Breeze x402 Payment API for Openclaw

A payment-gated API skill for interacting with the Breeze Solana yield aggregator using x402 USDC micropayments.

keeganthomp
v1.0.0
Feb 17, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install breeze

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install breeze 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?

The breeze-x402-payment-api is a specialized integration within Openclaw Skills that allows developers and AI agents to interact with Breeze, a leading Solana yield aggregator. Unlike traditional APIs, this tool utilizes the x402 payment protocol, which gates HTTP requests behind USDC micropayments, ensuring a pay-per-use model for DeFi interactions.

This skill provides a robust framework for managing decentralized finance positions directly through code or agentic workflows. By utilizing payment-wrapped fetch requests, Openclaw Skills users can automate complex financial operations on Solana while maintaining precise control over transaction signing and payment authorization.

Breeze x402 Payment API Use Cases

  • Automated monitoring of DeFi portfolio balances and APY performance.
  • Programmatic deposits into yield-bearing strategies using USDC, USDT, or SOL.
  • Facilitating automated withdrawals with intelligent WSOL unwrapping logic.
  • Building autonomous financial agents that pay for their own API access via x402.

How Breeze x402 Payment API Works

  1. The skill initializes a connection to the Solana blockchain using a local wallet and an RPC provider.
  2. Outgoing HTTP requests are intercepted by a payment-wrapped fetch handler.
  3. When the Breeze API returns an HTTP 402 status, the handler triggers a USDC micropayment on the Solana network.
  4. Once payment is confirmed, the handler automatically retries the original request with the required payment proof.
  5. The skill receives either structured data (for balances) or an unsigned transaction string (for deposits/withdrawals).
  6. The user or agent signs the transaction locally and broadcasts it to the network to complete the DeFi operation.

Breeze x402 Payment API Setup

To deploy this skill within your Openclaw Skills environment, configure your environment variables and install the necessary dependencies:

export WALLET_PRIVATE_KEY='your_base58_encoded_private_key'
export STRATEGY_ID='your_breeze_strategy_id'
export SOLANA_RPC_URL='https://api.mainnet-beta.solana.com'

Install the core libraries:

npm install @faremeter/fetch @faremeter/payment-solana @faremeter/wallet-solana @solana/web3.js

Breeze x402 Payment API Data Schema & Taxonomy

The skill manages asset amounts in base units (integers) to ensure precision. Metadata is structured as follows:

Token Mint Address Decimals
USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 6
SOL So11111111111111111111111111111111111111112 9
JLP 27G8MtK7VtTcCHkpASjSDdkWWYfoqT6ggEuKidVJidD4 6

Transaction data is returned as base64-encoded strings, compatible with both Versioned and Legacy Solana transaction formats.

Breeze x402 Payment API Advanced Features

  • Automatic HTTP 402 challenge-response handling via @faremeter/fetch.
  • Comprehensive WSOL handling including auto-detection and unwrapping to native SOL.
  • Support for multiple Solana-based assets including USDS, JitoSOL, and mSOL.
  • Integrated transaction deserialization and signing logic for seamless agentic execution.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*