polymerdao/polymer-pay-spraay

Spraay

Full-stack DeFi infrastructure for AI agents. Spraay provides 50+ pay-per-use endpoints covering AI inference (Claude Opus 4.6 and Sonnet 4.6), token swaps, oracle price feeds, cross-chain bridges, payroll, invoicing, escrow, wallet analytics, on-chain intelligence, XMTP messaging, IPFS storage, scheduling, KYC, and compliance. Through the Polymer Pay proxy, each request is paid individually with no Spraay account or API key required.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/gateway.spraay.app

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

AI Chat Completions

Generate AI responses using Claude Opus 4.6 or Sonnet 4.6 models.

Pricing: $0.005

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/gateway.spraay.app/api/v1/chat/completions",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "model": "claude-opus-4-6",
    "messages": [
      {"role": "user", "content": "Explain how x402 micropayments work on Base."}
    ]
  }
}

Response: JSON with AI-generated completion including model, usage tokens, and response content.

Get Swap Quote

Get optimal token swap routing and pricing across chains.

Pricing: $0.002

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/gateway.spraay.app/api/v1/swap/quote?from=ETH&to=USDC&amount=1.0",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON with swap route, expected output amount, price impact, and estimated gas.

Oracle Price Feeds

Retrieve real-time token prices from on-chain oracles.

Pricing: $0.003

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/gateway.spraay.app/api/v1/oracle/prices?tokens=ETH,BTC,USDC",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON with current prices, sources, and timestamps for each requested token.

Wallet Analytics

Analyze a wallet's holdings, transaction history, and behavioral patterns.

Pricing: $0.005

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/gateway.spraay.app/api/v1/analytics/wallet?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response: JSON with wallet classification, token holdings, DeFi exposure, and risk indicators.

On-Chain Inference

Classify wallet addresses, explain smart contracts, or summarize transaction activity using AI.

Pricing: $0.008 - $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/gateway.spraay.app/api/v1/inference/classify-address",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }
}

Response: JSON with address classification (EOA, contract, multisig), risk score, and behavioral labels.

When to Use

• AI inference -- User wants Claude Opus 4.6 or Sonnet 4.6 chat completions at $0.005/request
• Token swaps -- User wants to swap tokens on-chain with optimal routing
• Price feeds -- User needs real-time token prices or gas costs from oracles
• Cross-chain bridges -- User wants to bridge tokens between chains
• Payroll -- User needs to execute batch crypto payroll
• Invoicing -- User wants to create or manage crypto invoices
• Escrow -- User needs trustless escrow for on-chain payments
• Wallet analytics -- User wants portfolio analysis or transaction history
• On-chain intelligence -- User wants AI-powered wallet classification, contract explanation, or tx analysis
• Messaging -- User wants to send XMTP messages, emails, or SMS
• Storage -- User needs to pin data to IPFS or Arweave
• Compliance -- User needs KYC verification, tax calculation, or audit trails

Best Practices

• List models first -- Call GET /api/v1/models to see available AI models before making chat requests
• Use oracle before swaps -- Check /api/v1/oracle/prices to verify token prices before executing swaps
• Estimate before executing -- Use /api/v1/payroll/estimate or /api/v1/batch/estimate before committing to batch operations
• Check bridge chains -- Call /api/v1/bridge/chains to verify chain support before requesting bridge quotes
• Use free endpoints -- /api/v1/tokens is free and useful for discovering supported tokens
• Batch where possible -- Use /api/v1/batch/execute for multiple payments instead of individual transactions
• For errors -- See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting