bondterminal-x402

What This Skill Does

The bondterminal-x402 skill provides a direct, pay-per-request interface to the BondTerminal API, specifically tailored for the Argentine sovereign debt market. Unlike traditional financial data providers that require expensive, cumbersome monthly subscriptions or restrictive API keys, this skill utilizes the x402 keyless payment standard on the Base mainnet. Users can query real-time analytics, yield curves, cashflow schedules, and historical data for instruments like AL30 or GD30 by paying a micro-fee of $0.01 USDC per request. The skill abstracts the complexity of the 402 payment flow, handling the header negotiation and EIP-3009 payment signing automatically, allowing agents to fetch high-fidelity institutional data seamlessly.

Installation

To integrate this capability into your OpenClaw agent, use the following command: clawhub install openclaw/skills/skills/0juano/bondterminal-x402

Ensure your agent environment is configured with a valid EVM-compatible signer containing a sufficient balance of USDC on Base mainnet. The skill relies on the @x402/core and @x402/evm libraries; verify that your project is set to ES module mode ("type": "module" in package.json).

Use Cases

• Investment Research: Retrieve instant YTM, duration, and spread analytics for Argentine treasury bonds.
• Risk Monitoring: Monitor real-time "riesgo país" (country risk) spikes or historical trends to inform macro-financial strategy.
• Automated Reporting: Build internal dashboards that pull cashflow schedules for specific bond holdings based on ISIN lookups.
• Price Discovery: Compare local ticker prices (e.g., AL30D) against international counterparts using the calculate endpoint.

Example Prompts

1. "What is the current yield to maturity and duration for the AL30 bond?"
2. "Show me the cashflow schedule for bond ISIN US040114HS26 for the next 12 months."
3. "Fetch the latest Argentine riesgo país value and compare it to the monthly average."

Tips & Limitations

• Cost Efficiency: Because each call costs $0.01, verify that your agent logic caches data where possible to avoid redundant payments.
• Network Requirements: The skill strictly operates on Base mainnet; ensure your wallet is funded with USDC.E or native USDC on the correct chain.
• Data Scope: The x402 payment model is required for specific endpoints only; standard treasury curve lookups remain free.
• Error Handling: If a payment fails due to insufficient gas or USDC balance, the skill will raise an exception; always check your wallet status before executing batch operations.