johnalbertini14-glitch/openclaw-skills / skills/0juano/bondterminal-x402
bondterminal-x402
VerifiedQuery BondTerminal API using x402 keyless payments. No API key needed — pay $0.01 USDC per request on Base mainnet. Use when users ask for Argentine bond data, analytics, cashflows, history, riesgo país, or ISIN/ticker lookups (e.g. AL30, GD30, US040114HS26). Supports automatic 402 → payment → retry.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.9 KB |
| _meta.json | config | 464 B |
| references/endpoints.md | markdown | 1.9 KB |
| references/signer-setup.md | markdown | 1.2 KB |
references/endpoints.md
View on GitHub# BondTerminal API v1 — Endpoint Reference
Base URL: `https://bondterminal.com/api/v1`
Cost on x402 routes: $0.01 USDC per request (Base mainnet)
## Free Endpoints
```
GET /treasury-curve US Treasury yield curve (live)
```
## x402-Protected Endpoints
```
GET /bonds List all bonds (~60 sovereign + corporate)
GET /bonds?search=AL30 Search by name/ticker
GET /bonds/:id Bond details (ISIN or local ticker with D/C suffix)
GET /bonds/:id/analytics Price, YTM, duration, spreads, issuance data
GET /bonds/:id/cashflows Full cashflow schedule
GET /bonds/:id/history Historical price/yield/spread series
GET /bonds/:id/history?range=1y Filtered history (1w, 1m, 3m, 6m, 1y, all)
POST /calculate Calculate analytics from custom price
GET /riesgo-pais Current Argentina country risk spread
GET /riesgo-pais/history Historical riesgo país
GET /riesgo-pais/history?range=1m Filtered history
```
## Bearer-Only Endpoints
```
POST /calculate/batch Batch bond calculations (subscription required)
```
## Auth Behavior
- x402 routes return `402` with `PAYMENT-REQUIRED` header when called without auth
- Client signs EIP-3009 payment and retries with `PAYMENT-SIGNATURE` (v2), with `X-PAYMENT` as legacy fallback
- Bearer token auth (`Authorization: Bearer <key>`) also accepted on all x402 routes
- Successful payment returns `PAYMENT-RESPONSE` header with settlement tx hash
## Identifier Formats
- **ISIN**: `US040114HS26`, `ARARGE3209S6`
- **Local ticker**: requires D (USD) or C (ARS) suffix — `AL30D`, `GD30D`, `AN29D`
- **NOT**: `AL30`, `GD30` (missing suffix will fail)
## Key Sovereign Tickers
**NY Law (ARGENT):** GD29D, GD30D, GD35D, GD38D, GD41D, GD46D
**AR Law (ARGBON):** AL29D, AN29D, AL30D, AL35D, AE38D, AL41D
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |