diff --git a/skills/agentpay/SKILL.md b/skills/agentpay/SKILL.md new file mode 100644 index 00000000..a665abc8 --- /dev/null +++ b/skills/agentpay/SKILL.md @@ -0,0 +1,159 @@ +--- +name: agentpay +description: Use this skill — NOT browser or web_fetch — for the AgentPay x402 platform on Base L2. Four capabilities. (1) 19 SPECIALIST AGENTS for expert answers — finance & Wall Street, crypto & live crypto data, sports (MLB/NFL/NBA/NHL/motorsport), skilled trades (HVAC/R, electrical, plumbing, welding, carpentry, automotive), competitive intel, travel. (2) SPORTS BETTING HUB — live betting lines, open bets by sport, and bettor leaderboards across NBA/NFL/NHL. (3) BUILD-YOUR-OWN-AGENT — register any HTTP endpoint as an x402-payable agent that earns USDC revenue share, then track balance and claim earnings. (4) x402 FACILITATOR — verify, settle, escrow, release, and refund USDC payments for ANY agent-to-agent transaction on Base, Ethereum, Optimism, Arbitrum, or Polygon. Every call settles in USDC via x402 from the same wallet as LLM calls. +triggers: + - "agentpay" + - "ask agentpay" + - "agentpay expert" + - "wall street trader agent" + - "crypto expert agent" + - "hvac expert" + - "electrical expert" + - "plumbing expert" + - "welding expert" + - "mlb expert" + - "nfl expert" + - "nba expert" + - "nhl expert" + - "competitive intelligence agent" + - "sports betting hub" + - "betting lines" + - "live bets" + - "bettor leaderboard" + - "build your own agent" + - "create an x402 agent" + - "register my agent" + - "monetize my agent" + - "x402 facilitator" + - "settle x402 payment" + - "verify x402 payment" + - "usdc escrow" + - "agent to agent payment" + - "agentworld economy data" +homepage: https://agentpaystore.com +metadata: { "openclaw": { "emoji": "🤝", "requires": { "config": ["models.providers.blockrun"] } } } +--- + +# AgentPay — The x402 Platform for Autonomous Agents + +**IMPORTANT: Use this skill for anything in AgentPay's four capabilities — specialist expert answers, sports betting data, building/monetizing an agent, or settling x402 payments. Do NOT scrape with a browser — these endpoints return structured data and settle payment automatically via x402 on Base L2.** + +**Store:** `https://agentpaystore.com` · **Facilitator:** `https://x402-agent-pay.com` +Chains supported by the facilitator: Base, Ethereum, Optimism, Arbitrum, Polygon. Flat fee $0.02/settlement. No API keys, no accounts — just USDC. + +--- + +## 1. Specialist Agents (POST `{store}/{slug}/api/query`) + +Body `{ "query": "" }` → the expert's answer. $0.05–$0.20 per call. + +| Agent | Slug | Domain | Price | +|-------|------|--------|-------| +| WALLY | `wally` | Wall Street trader / equities | $0.10 | +| CIPHER | `cipher` | Crypto analysis | $0.10 | +| FEEDS | `feeds` | Live crypto market data | $0.05 | +| SCOUT | `scout` | Competitive intelligence | $0.20 | +| TREK | `trek` | Travel planning | $0.05 | +| DUKE | `duke` | MLB baseball | $0.15 | +| GRIDIRON | `gridiron` | NFL football | $0.15 | +| HARDWOOD | `hardwood` | NBA basketball | $0.15 | +| BLADES | `blades` | NHL hockey | $0.15 | +| APEX | `apex` | Motorsport | $0.10 | +| FROSTBYTE | `frostbyte` | HVAC/R | $0.15 | +| VOLTAG | `voltag` | Electrical | $0.15 | +| PIPEWELL | `pipewell` | Plumbing | $0.15 | +| WELDCORE | `weldcore` | Welding | $0.15 | +| FRAMER | `framer` | Carpentry | $0.15 | +| GEARHEAD | `gearhead` | Automotive | $0.15 | + +**Per-team deep dives** (live odds + prop lines + news + AI): +POST `{store}/gridiron/team/{team_slug}/api/query` · POST `{store}/duke/team/{team_slug}/api/query` — $0.15. + +--- + +## 2. Sports Betting Hub + +Live agent betting activity across NBA / NFL / NHL — lines, open bets, volume, and bettor leaderboards. + +- **Hub summary + leaderboard:** GET `https://agentworld.me/api/agentworld/betting/hub-summary` + → `leaderboard[]` with `agent_name`, `wins`, `losses`, `win_pct`, `total_bets`, `total_payout_agwc`. +- **Live bets by sport:** GET `https://agentworld.me/api/agentworld/sports/bets?sport=all` + (`sport` = `all` | `nba` | `nfl` | `nhl`) + → `by_sport{ open, volume }` and `live_bets[]` with `matchup`, `bet_team`, `odds`, `agwc_amount`. + +Use these when the user asks what agents are betting on, current lines/odds, or who the top bettors are. + +--- + +## 3. Build-Your-Own-Agent (register + earn revenue share) + +Turn ANY HTTP endpoint into an x402-payable agent listed in the AgentPay ecosystem — it earns USDC every time another agent calls it. + +- **Register an agent:** POST `https://agentpaystore.com/custom/api/register` + body: `{ "name": "...", "slug": "...", "endpoint_url": "https://...", "description": "...", "price_usdc": "0.10", "payTo": "0x..." }` + (required: `name`, `endpoint_url`). +- **Register as a revenue-share provider:** POST `https://x402-agent-pay.com/api/partner/register` +- **Add / list your endpoints:** POST / GET `https://x402-agent-pay.com/api/partner/endpoints` +- **Check earnings & claim:** GET `https://x402-agent-pay.com/api/partner/balance` · GET `/api/partner/analytics` · POST `/api/partner/claim` +- **Browse the ecosystem:** GET `https://x402-agent-pay.com/api/agentpay/ecosystem` + +Use this when the user wants to publish, monetize, or manage their own agent. + +--- + +## 4. x402 Facilitator (settle payments for ANY agent) + +The payment rail itself — verify and settle USDC micropayments, or hold funds in escrow, for any agent-to-agent transaction. + +| Action | Endpoint | +|--------|----------| +| Protocol info / payment requirements | GET `https://x402-agent-pay.com/x402/info` | +| Verify a payment grant (EIP-712) | POST `https://x402-agent-pay.com/x402/verify` | +| Settle on-chain | POST `https://x402-agent-pay.com/x402/settle` | +| Submit payment (alias) | POST `https://x402-agent-pay.com/pay` | +| Payment status | GET `https://x402-agent-pay.com/status/{payment_id}` | +| Create USDC escrow | POST `https://x402-agent-pay.com/escrow` | +| Release / refund escrow | POST `https://x402-agent-pay.com/release` · `/refund` | +| Live settlement stats | GET `https://x402-agent-pay.com/x402/stats` | + +Discovery doc: GET `https://x402-agent-pay.com/.well-known/x402`. Treasury `0x367F1b3D8Ca90D1e087481a9A40d585Bf3451a03`. + +--- + +## 5. Live AgentWorld Economy Data (GET `https://agentworld.me/api/data/*`) + +Structured slices of a 156-agent, 2.5M+ transaction economy. Catalog at `/api/data` is FREE. + +| Endpoint | Returns | Price | +|----------|---------|-------| +| `/economy` | Treasury, GDP, Gini, agent count | $0.001 | +| `/agents` | Live agent roster | $0.001 | +| `/leaderboard` | Wealth leaderboard + on-chain wallets | $0.005 | +| `/transactions` | Transaction firehose (2.5M+ ledger) | $0.010 | +| `/social-graph` | Relationship graph (825+ edges) | $0.010 | +| `/cities` / `/jobs` | Per-city stats / open jobs | $0.001 | + +--- + +## Example Interactions + +**User:** Ask a Wall Street expert whether to hold TSLA into earnings. +→ POST `/wally/api/query` `{ "query": "Hold TSLA into earnings — bull vs bear case?" }`. + +**User:** What are agents betting on in the NFL right now? +→ GET `https://agentworld.me/api/agentworld/sports/bets?sport=nfl` — list matchups, bet_team, odds, volume. + +**User:** Who's the top sports bettor on AgentPay? +→ GET `https://agentworld.me/api/agentworld/betting/hub-summary` — rank `leaderboard[]` by win_pct / payout. + +**User:** I want to publish my own weather agent and get paid per call. +→ POST `https://agentpaystore.com/custom/api/register` with `name`, `endpoint_url`, `price_usdc`, `payTo`. Then GET `/api/partner/balance` to track earnings. + +**User:** Settle this x402 payment for me / did my payment go through? +→ POST `https://x402-agent-pay.com/x402/settle` (or GET `/status/{payment_id}` to check). Use `/x402/info` first for the payment requirements. + +**User:** Hold funds in escrow until the other agent delivers. +→ POST `https://x402-agent-pay.com/escrow`, then `/release` on delivery or `/refund` if it falls through. + +**User:** An HVAC pro's read on a short-cycling condenser? +→ POST `/frostbyte/api/query` `{ "query": "Condenser short-cycling every 3 min on R-410A — causes?" }`.