🛠️ Service Catalog

Returns the full SparkForge service catalog: every endpoint with its price, supported parameters, average response time, and demo URL. This is a GET endpoint — no payment required. Ideal for agents that need to discover available tools programmatically.

Request Body

Parameter	Type	Required	Description	Default

Response Fields

Field	Type	Description
`services`	array	List of service objects with id, category, endpoint, name, price, description, parameters, avgTimeSeconds, demo
`payment`	object	Payment configuration: network, token, protocol, receiver address

Code Examples

cURL

bash

# Free — no payment required
curl https://sparkforge.sh/api/models

Python

python

import requests

r = requests.get("https://sparkforge.sh/api/models")
data = r.json()
for svc in data["services"]:
    print(f"{svc['name']}: {svc['price']} — {svc['endpoint']}")

TypeScript / Node.js

typescript

// No x402 needed — this is a free GET endpoint
const res = await fetch("https://sparkforge.sh/api/models");
const { services, payment } = await res.json();

services.forEach((svc: any) => {
  console.log(`${svc.name}: ${svc.price} → ${svc.endpoint}`);
});

Example Response

json

{
  "services": [
    {
      "id": "btc-signal",
      "category": "trading",
      "endpoint": "POST /api/btc-signal",
      "name": "BTC Direction Signal",
      "price": "$0.01",
      "priceRaw": "10000",
      "description": "BTC direction prediction using 8-signal composite...",
      "parameters": { "timeframe": "1m | 3m | 5m | 15m | 30m | 1h" },
      "avgTimeSeconds": 2,
      "demo": "GET /api/btc-signal?demo=true"
    }
  ],
  "payment": {
    "network": "Base (eip155:8453) + Solana (solana:mainnet)",
    "token": "USDC",
    "protocol": "x402",
    "receiver": "0x6dC88e65c36c256ed6937f83c4b22CBbBE1894FD"
  }
}

💳 Payment via x402

This endpoint costs Free per call, paid in USDC on Base, Polygon, or Solana. Use the @x402/fetch library to handle payments automatically, or implement the x402 handshake manually.

bash

# Free demo mode (no payment)
curl https://sparkforge.sh/api/models?demo=true

# Or try via MCP (Claude Desktop, Cursor, Windsurf)
# Add to mcp config: { "url": "https://sparkforge.sh/api/mcp" }

←

Agent Messaging

File Format Converter

→