📊 Token Research Report

Generate a comprehensive AI research report for any cryptocurrency token. Includes fundamental analysis, on-chain metrics, social sentiment, risk assessment, and investment thesis. Supports tokens on Ethereum, Base, Solana, and other major chains.

Request Body

Parameter	Type	Required	Description	Default
`token`	string	required	Token symbol or contract address (e.g. PEPE, 0x123...)	—
`chain`	string	optional	Blockchain network: ethereum, base, solana, polygon	`ethereum`

Response Fields

Field	Type	Description
`token`	string	Token identifier
`summary`	string	Executive summary of the token
`fundamentals`	object	Key fundamental metrics
`sentiment`	string	Market sentiment: bullish \| neutral \| bearish
`risk_level`	string	Risk assessment: low \| medium \| high \| extreme
`report`	string	Full research report in Markdown

Code Examples

cURL

bash

curl -X POST https://sparkforge.sh/api/token-research \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-token>" \
  -d '{
    "token": "PEPE",
    "chain": "ethereum"
  }'

Python

python

import requests

response = requests.post(
    "https://sparkforge.sh/api/token-research",
    headers={"Content-Type": "application/json", "X-PAYMENT": "<token>"},
    json={"token": "PEPE", "chain": "ethereum"}
)

data = response.json()
print(data["summary"])
print(f"Sentiment: {data['sentiment']} | Risk: {data['risk_level']}")

TypeScript / Node.js

typescript

const res = await fetch402("https://sparkforge.sh/api/token-research", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ token: "PEPE", chain: "ethereum" }),
});

const { summary, sentiment, risk_level, report } = await res.json();

Example Response

json

{
  "token": "PEPE",
  "chain": "ethereum",
  "summary": "PEPE is a meme token based on the Pepe the Frog meme...",
  "sentiment": "neutral",
  "risk_level": "high",
  "fundamentals": {
    "market_cap": "4.2B",
    "holders": "320000",
    "liquidity": "high"
  },
  "report": "# PEPE Token Research\n\n## Overview\n..."
}

💳 Payment via x402

This endpoint costs $0.10 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/token-research?demo=true

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