madeonsol-x402

TypeScript SDK for the MadeOnSol Solana KOL intelligence API.

Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, and stream every DEX trade. Free tier: 200 requests/day at madeonsol.com/developer — no credit card required.

Authentication

Three options (in priority order):

| Method | Option | Best for | |---|---|---| | MadeOnSol API key (recommended) | apiKey | Developers — get a free key | | RapidAPI key | rapidApiKey | RapidAPI subscribers | | x402 micropayments | privateKey | AI agents with Solana wallets |

Install

npm install madeonsol-x402

x402 peer deps (@x402/fetch @x402/svm @x402/core @solana/kit @scure/base) are only needed when using privateKey.

Quick Start

import { createClient } from "madeonsol-x402";

// Option 1: API key (simplest — get one free at madeonsol.com/developer)
const client = createClient("msk_your_api_key_here");

// Option 2: x402 micropayments (auto-detected when no msk_ prefix)
// const client = createClient(process.env.SOLANA_PRIVATE_KEY!);

const { trades } = await client.kolFeed({ limit: 10 });
console.log(trades);

Advanced initialization

import { MadeOnSolX402 } from "madeonsol-x402";

const client = new MadeOnSolX402({
  apiKey: "msk_...",        // OR
  rapidApiKey: "rapid_...", // OR
  privateKey: "base58...",  // x402 micropayments
});

Endpoints

| Method | Description | |---|---| | kolFeed(params?) | Real-time KOL trade feed from 1,000+ tracked wallets | | kolCoordination(params?) | Tokens being accumulated by multiple KOLs simultaneously | | kolLeaderboard(params?) | KOL performance rankings by PnL and win rate (180 days of trade history) | | kolPairs(params?) | KOL affinity matrix — which KOLs frequently co-trade the same tokens | | kolHotTokens(params?) | KOL momentum tokens — accelerating KOL buy interest | | deployerAlerts(params?) | Pump.fun deployer alerts with KOL enrichment. PRO/ULTRA: filter by tier. | | tokenInfo(mint) | Token intelligence — real-time VWAP price, market cap, volume, deployer reputation, KOL activity | | apiStatus() | System health — service status, uptime, stream lag (no auth required) | | discovery() | Lists all endpoints, prices, and parameter docs (free) |

REST API methods (require Pro/Ultra subscription)

| Method | Description | |---|---| | rest.kolTiming(wallet, params?) | KOL entry/exit timing profile — hold duration, exit speed, patterns | | rest.deployerTrajectory(wallet) | Deployer skill curve — streaks, rolling bond rate, improvement trend |

Parameters

kolFeed — limit (1-100), action ("buy" | "sell"), kol (wallet address)

kolCoordination — period ("1h" | "6h" | "24h" | "7d"), min_kols (2-50), limit (1-50)

kolLeaderboard — period ("today" | "7d" | "30d" | "90d" | "180d"), limit (1-50). Trade data retained for 180 days; the 90d/180d windows fill up over time.

kolPairs — period ("7d" | "30d"), min_shared (1-20), limit (1-50)

kolHotTokens — period ("1h" | "6h"), min_kols (1-20), limit (1-50)

deployerAlerts — since (ISO8601), limit (1-100), offset (number), tier ("elite" | "good" | "moderate" | "rising" | "cold" — PRO/ULTRA only, BASIC callers receive HTTP 403)

kolTiming — period ("7d" | "30d")

deployerTrajectory — no params (wallet in path)

REST API (webhooks + streaming)

import { MadeOnSolREST } from "madeonsol-x402";

const rest = new MadeOnSolREST({ apiKey: "msk_your_key" });
// OR: new MadeOnSolREST({ rapidApiKey: "your_rapidapi_key" });

const token = await rest.getStreamToken();
// token.ws_url — KOL/deployer streaming (Pro/Ultra)
// token.dex_ws_url — all-DEX trade stream (Ultra only)

Discovery

const info = await client.discovery();
console.log(info.endpoints); // all endpoints with prices and params

Docs: madeonsol.com/solana-api

Also Available

| Platform | Package | |---|---| | Python (LangChain, CrewAI) | madeonsol-x402 on PyPI | | MCP Server (Claude, Cursor) | mcp-server-madeonsol | | ElizaOS | @madeonsol/plugin-madeonsol | | Solana Agent Kit | solana-agent-kit-plugin-madeonsol |