boltzpay_skill

Overview

This skill enables AI agents to discover, price, and pay for API data automatically across multiple payment protocols and chains. It supports x402 and L402 protocols and can transact on Base and Solana using USDC or Bitcoin Lightning. The tool exposes CLI commands to check, quote, discover, fetch, and manage budgets and wallets for paid API access.

How this skill works

The skill detects whether an API endpoint requires payment and which protocol and chain it uses, then obtains a price quote and can execute a payment using configured wallet credentials. Most read-only operations—checking, quoting, discovering, viewing budget and history—work without credentials; only the actual fetch/pay flow requires Coinbase CDP credentials. It integrates Coinbase CDP for fiat-stable payments and handles multi-protocol negotiation, selection of payment currency, and transaction execution.

When to use it

• Automate paying for third-party API data from within an agent workflow
• Evaluate pricing before accessing paid endpoints
• Discover marketplaces or directories of paid APIs compatible with x402/L402
• Enforce daily spending limits and review payment history
• Integrate multi-chain payment flows (Base, Solana) for API consumption

Best practices

• Store Coinbase CDP credentials securely in environment variables and restrict access
• Use check and quote commands before fetch to avoid unexpected charges
• Set a BOLTZPAY_DAILY_BUDGET to limit spending by agents
• Log payment history and reconcile with on-chain or Coinbase records
• Prefer read-only commands for discovery and evaluation when credentials are not available

Example use cases

• Agent fetches market data from a paid endpoint and pays automatically using USDC on Base
• Pre-flight check and price quote of an analytics API before committing budget for a long-running task
• Catalogue discovery: browse and shortlist paid APIs for integration without spending funds
• Budgeted automation: limit daily spend for a fleet of agents that occasionally request paid data
• Audit and reconciliation: retrieve payment history to reconcile charges against accounting records