sponge-wallet

Sponge Wallet API — Agent Skills Guide (OpenClawd Edition)

This skill gives Clawd access to the Sponge Wallet REST API — a full crypto wallet with swaps, bridges, trading, payments, banking, and paid external services.

Quick Start

# Base URL
SPONGE_API_URL="https://api.wallet.paysponge.com"
SPONGE_API_KEY="sponge_live_..."  # set in .env or export

# Required header on every request
# Sponge-Version: 0.2.2
# Authorization: Bearer $SPONGE_API_KEY
# Content-Type: application/json

What You Can Do

1. Manage crypto — check balances, transfer tokens (EVM/Solana/Tempo), swap on Solana/Base/Ethereum/Polygon/Arbitrum/Tempo, bridge cross-chain
2. Create payment links — generate reusable x402 payment URLs
3. Access paid external services — search, image gen, web scraping, AI, data enrichment
4. Banking — KYC onboarding, virtual bank accounts (receive USD as USDC), off-ramp to bank
5. Trade — Polymarket prediction markets, Hyperliquid perpetuals
6. Checkout — shop from online stores via URL checkout
7. Store cards — encrypted card data for checkout, virtual cards, Sponge Card
8. Fiat onramp — buy crypto with card/bank via Stripe or Coinbase

Top-Level API Reference

Base:   https://api.wallet.paysponge.com
Auth:   Authorization: Bearer <SPONGE_API_KEY>
Ver:    Sponge-Version: 0.2.2  (REQUIRED on every request)

Paid services (search, image gen, scraping, AI, data, etc.):
  GET  /api/discover                     -> find services by query/category
  GET  /api/discover/:serviceId          -> get endpoints, params, pricing
  POST /api/paid/fetch                   -> call service (auto-selects x402 or MPP)
  POST /api/x402/fetch                   -> call service (x402 USDC only)
  POST /api/mpp/fetch                    -> call service (MPP on Tempo)

Wallet & tokens:
  GET  /api/balances                     -> get all balances
  POST /api/transfers/evm                -> EVM transfer (ETH/USDC)
  POST /api/transfers/solana             -> Solana transfer (SOL/USDC)
  POST /api/transfers/tempo              -> Tempo transfer (pathUSD etc.)
  POST /api/transactions/swap            -> Solana/EVM swap
  POST /api/transactions/base-swap       -> Base swap
  POST /api/transactions/tempo-swap      -> Tempo swap
  POST /api/transactions/bridge          -> cross-chain bridge
  GET  /api/solana/tokens                -> list SPL tokens
  GET  /api/solana/tokens/search         -> search Jupiter token list
  GET  /api/transactions/status/:txHash  -> transaction status
  GET  /api/transactions/history         -> transaction history

Trading:
  POST /api/polymarket                   -> Polymarket prediction markets
  POST /api/hyperliquid                  -> Hyperliquid perps/spot

Banking:
  POST /api/bank/onboard                 -> start KYC
  GET  /api/bank/status                  -> KYC status
  POST /api/bank/virtual-account         -> create virtual bank account
  GET  /api/bank/external-accounts       -> list linked bank accounts
  POST /api/bank/external-accounts       -> link bank account
  POST /api/bank/send                    -> off-ramp USD to bank

Cards & checkout:
  POST /api/cards                        -> fetch user's card
  POST /api/virtual-cards                -> issue per-transaction virtual card
  POST /api/checkout                     -> URL checkout from online stores
  GET  /api/checkout/:sessionId          -> checkout status
  POST /api/credit-cards                 -> store encrypted card data
  POST /api/onramp/crypto                -> fiat-to-crypto onramp link

Planning:
  POST /api/plans/submit                 -> submit multi-step plan
  POST /api/plans/approve                -> approve and execute plan
  POST /api/trades/propose               -> propose single swap