API Documentation

One Wallet. 33 Tools. Zero API Keys.

Give your agent USDC and instant access to 33 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

33
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 33 Endpoints

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

📄 Documents

PDF to Markdown$0.005
POST /api/pdf-to-markdown

Convert any PDF URL to clean Markdown text. Preserves headings, tables, and lists.

HTML to Markdown$0.001
POST /api/markdown

Convert any webpage URL to clean Markdown. Strips navigation, ads, and boilerplate.

Text Summarizer$0.005
POST /api/summarize

Extractive text summarization. Returns key sentences that capture the main ideas.

File Format Converter$0.005
POST /api/convert

Convert between CSV↔JSON, Markdown→HTML, and HTML→text. Pass content as base64 or a URL.

OCR — Text from Images$0.02
POST /api/ocr

Extract text from any image using Claude vision. Supports URLs, base64, and data URIs. Detects language automatically.

AI Smart Summarizer$0.02
POST /api/smart-summarize

AI-powered summarization with four modes: bullet points, executive, technical, and ELI5. Accepts text or URL.

🌐 Web

Webpage Screenshot$0.005
POST /api/screenshot

Capture full-page or viewport screenshots of any webpage as PNG.

Web Scraper$0.01
POST /api/scrape

Full web scraping with JavaScript execution. Returns HTML, text, or structured data.

URL Metadata$0.001
POST /api/url-metadata

Extract OG tags, title, favicon, description, and canonical URL from any webpage.

Site Crawler$0.02
POST /api/site-crawl

Crawl a website and extract structured content from multiple pages. Respects same-domain links.

Structured Data Extractor$0.03
POST /api/extract

Fetch a URL and extract structured data matching your JSON schema using Claude AI.

Domain & SSL Checker$0.005
POST /api/domain-check

Full domain health check: DNS records (A, AAAA, MX, NS, TXT), SSL certificate validity, issuer, and expiry.

Web Search$0.005
POST /api/search

Real-time web search via Brave Search API. Returns titles, URLs, descriptions, and optional news results.

🛠️ Developer

QR Code Generator$0.001
POST /api/qrcode

Generate QR codes from any text, URL, or data. Returns base64 PNG or CDN URL.

JSON Validator$0.001
POST /api/json-validate

Validate JSON syntax and optionally validate against a JSON Schema.

Text Diff$0.001
POST /api/diff

Generate a unified diff between two text strings. Returns standard diff format.

Language Detection$0.001
POST /api/detect-language

Detect the language of any text. Returns ISO 639-1 code and confidence score.

AI Code Review$0.01
POST /api/code-review

AI-powered code review with bug detection, security analysis, and improvement suggestions.

Key-Value Store$0.001
POST /api/store

Persistent key-value storage with TTL. Set, get, delete, and list keys. Namespaced by wallet address.

Cron Scheduler$0.01
POST /api/cron

Register webhooks to be called on a cron schedule. Supports standard 5-field cron expressions.

Agent Messaging$0.005
POST /api/notify

Agent-to-agent messaging using wallet addresses as identities. Send, receive, and acknowledge messages.

Service CatalogFree
POST /api/models

List all available SparkForge services with pricing, parameters, and endpoints. Free, no payment required.

Email Verifier$0.005
POST /api/email-verify

Verify email addresses: format validation, MX record lookup, disposable domain detection, and typo suggestions.

🤖 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 · 33 APIs · Built with x402 · ERC-8004 Agent #21187