x402 client SDK for MadeOnSol Solana KOL intelligence API. Works with LangChain, CrewAI, and standalone.
Project description
madeonsol-x402
Python 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 | Parameter / Env var | Best for |
|---|---|---|
| MadeOnSol API key (recommended) | api_key / MADEONSOL_API_KEY |
Developers — get a free key |
| RapidAPI key | rapidapi_key / RAPIDAPI_KEY |
RapidAPI subscribers |
| x402 micropayments | private_key / SVM_PRIVATE_KEY |
AI agents with Solana wallets |
Install
pip install madeonsol-x402 # core SDK
pip install madeonsol-x402[langchain] # + LangChain tools
pip install madeonsol-x402[crewai] # + CrewAI tools
x402 dependencies are only needed when using
private_key/SVM_PRIVATE_KEY.
Quick Start
from madeonsol_x402 import MadeOnSolClient
# Option 1: API key (simplest — get one free at madeonsol.com/developer)
client = MadeOnSolClient(api_key="msk_your_api_key_here")
# Option 2: RapidAPI key
# client = MadeOnSolClient(rapidapi_key="your_rapidapi_key")
# Option 3: x402 micropayments (AI agents)
# client = MadeOnSolClient(private_key="your_solana_private_key_base58")
# Real-time KOL trades
trades = client.kol_feed(limit=10, action="buy")
# KOL convergence signals
signals = client.kol_coordination(period="24h", min_kols=3)
# KOL leaderboard — 180 days of history retained
leaders = client.kol_leaderboard(period="7d") # today | 7d | 30d | 90d | 180d
# Deployer alerts — PRO/ULTRA can filter by tier
alerts = client.deployer_alerts(limit=10)
elite_only = client.deployer_alerts(limit=10, tier="elite") # PRO/ULTRA only
# Free discovery endpoint
info = client.discovery()
LangChain
from madeonsol_x402.langchain_tools import ALL_TOOLS
# Set MADEONSOL_API_KEY, RAPIDAPI_KEY, or SVM_PRIVATE_KEY env var
agent = create_react_agent(llm, tools=ALL_TOOLS)
CrewAI
from madeonsol_x402.crewai_tools import ALL_TOOLS
agent = Agent(role="Solana Analyst", tools=ALL_TOOLS)
Endpoints
| Method | Description |
|---|---|
kol_feed() |
Real-time KOL trade feed (1,000+ wallets) |
kol_coordination() |
Multi-KOL convergence signals |
kol_leaderboard() |
PnL and win rate rankings — windows: today, 7d, 30d, 90d, 180d (180-day retention) |
kol_pairs() |
KOL affinity matrix — which KOLs co-trade the same tokens |
kol_hot_tokens() |
KOL momentum tokens — accelerating buy interest |
deployer_alerts() |
Pump.fun deployer launches with KOL enrichment. PRO/ULTRA: filter by tier. |
token_info(mint) |
Token intelligence — price, market cap, volume, deployer, KOL activity |
api_status() |
System health — service status and uptime (no auth required) |
discovery() |
List all endpoints and prices (free) |
REST API (Pro/Ultra subscription)
| Method | Description |
|---|---|
rest.kol_timing(wallet) |
KOL entry/exit timing profile |
rest.deployer_trajectory(wallet) |
Deployer skill curve — streaks, rolling bond rate, trend |
Also Available
| Platform | Package |
|---|---|
| TypeScript SDK | madeonsol-x402 |
| MCP Server (Claude, Cursor) | mcp-server-madeonsol |
| ElizaOS | @madeonsol/plugin-madeonsol |
| Solana Agent Kit | solana-agent-kit-plugin-madeonsol |
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file madeonsol_x402-0.2.1.tar.gz.
File metadata
- Download URL: madeonsol_x402-0.2.1.tar.gz
- Upload date:
- Size: 9.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4440f457edafc4fd24eb7c8277a399de572f9382b275ed2ec8878f342d271a95
|
|
| MD5 |
8d22939ba7508856edff4d7de0320081
|
|
| BLAKE2b-256 |
06549ebbc4ea57024c6d8237668d995b92ea640b9c4709f8e5760b864329710b
|
File details
Details for the file madeonsol_x402-0.2.1-py3-none-any.whl.
File metadata
- Download URL: madeonsol_x402-0.2.1-py3-none-any.whl
- Upload date:
- Size: 10.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a3132197d309435d82d740dcb67f1039181cad69fc787bbae47f60ef6f6037c
|
|
| MD5 |
0dd39a5eddc5119950359642282f00e2
|
|
| BLAKE2b-256 |
e7101770cddea3ac826336c4658484b6af181ed3d5ef62936d10398d0ccbba25
|