API Documentation

One Wallet. 25 Tools. Zero API Keys.

Give your agent USDC and instant access to 25 APIs. No signups, no API keys โ€” pay per call via x402 (USDC on Base) or access free via MCP.

Agent-friendly ยท No API keys ยท No subscriptions ยท From $0.001 per call

25
Endpoints
$0.001
Min Price
Base ยท Polygon ยท Solana
Chains
21187
Agent #

๐Ÿš€ Quick Start

Try any endpoint with a demo request (no payment required):

bash
# Free demo โ€” no payment required
curl https://sparkforge.sh/api/btc-signal?demo=true
curl https://sparkforge.sh/api/generate?demo=true
curl https://sparkforge.sh/api/crypto-price?demo=true

Paid request with x402 (JavaScript/Node.js):

javascript
import { wrapFetchWithPayment } from "@x402/fetch";
import { createWalletClient } from "viem";

// Set up your wallet
const wallet = createWalletClient({ ... });
const fetch402 = wrapFetchWithPayment(fetch, wallet);

// Call any SparkForge endpoint โ€” payment handled automatically
const res = await fetch402("https://sparkforge.sh/api/btc-signal", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ timeframe: "5m" }),
});

const { direction, confidence, price } = await res.json();
// โ†’ { direction: "up", confidence: 0.72, price: 84521 }

๐Ÿ” Authentication โ€” x402 Payment Protocol

SparkForge uses the x402 protocol โ€” a standard for machine-to-machine HTTP micropayments. No API keys, no accounts. Your wallet pays directly per request.

1
Request without payment
Send a POST request to any endpoint. If no payment header is present, you get a 402 response with payment options.
2
402 Payment Required
The server responds with required payment details: amount, chain, and wallet address. Your x402 client handles this automatically.
3
Pay & retry
The x402 client sends USDC on Base (or Polygon/Solana) and retries the request with the payment proof header.

Supported chains:

Baseeip155:8453
Polygoneip155:137
Solanasolana:mainnet

๐Ÿ”Œ MCP โ€” Free Access

Add SparkForge to any MCP-compatible client (Claude Desktop, Cursor, Windsurf) for free access to all tools:

json
{
  "mcpServers": {
    "sparkforge": {
      "url": "https://sparkforge.sh/api/mcp"
    }
  }
}

Via stdio bridge: npx -y mcp-remote https://sparkforge.sh/api/mcp

๐Ÿ“ก All 25 Endpoints

Click any endpoint to view full documentation, request schemas, and code examples.

๐Ÿค– ACP โ€” Virtuals Marketplace

SparkForge is listed on the Virtuals Protocol Agent Commerce Protocol (ACP) marketplace as Agent #21187.

AI agents built with Virtuals can discover and call SparkForge tools autonomously โ€” no human in the loop required. Service discovery happens via the ERC-8004 agent card:

bash
curl https://sparkforge.sh/.well-known/agent-card.json
curl https://sparkforge.sh/.well-known/agent.json
SparkForge ยท 25 APIs ยท Built with x402 ยท ERC-8004 Agent #21187