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. Pay-per-request with USDC on Solana via the x402 protocol.
Install
pip install madeonsol-x402 # core SDK
pip install madeonsol-x402[langchain] # + LangChain tools
pip install madeonsol-x402[crewai] # + CrewAI tools
Quick Start
from madeonsol_x402 import MadeOnSolClient
client = MadeOnSolClient("your_solana_private_key_base58")
# Real-time KOL trades ($0.005/req)
trades = client.kol_feed(limit=10, action="buy")
# KOL convergence signals ($0.02/req)
signals = client.kol_coordination(period="24h", min_kols=3)
# KOL leaderboard ($0.005/req)
leaders = client.kol_leaderboard(period="7d")
# Deployer alerts ($0.01/req)
alerts = client.deployer_alerts(limit=10)
# Free discovery endpoint
info = client.discovery()
LangChain
from madeonsol_x402.langchain_tools import ALL_TOOLS
# Add to your LangChain agent
agent = create_react_agent(llm, tools=ALL_TOOLS)
Set SVM_PRIVATE_KEY env var for automatic x402 payments.
CrewAI
from madeonsol_x402.crewai_tools import ALL_TOOLS
agent = Agent(role="Solana Analyst", tools=ALL_TOOLS)
Endpoints
| Method | Price | Description |
|---|---|---|
kol_feed() |
$0.005 | Real-time KOL trade feed (946 wallets) |
kol_coordination() |
$0.02 | Multi-KOL convergence signals |
kol_leaderboard() |
$0.005 | PnL and win rate rankings |
deployer_alerts() |
$0.01 | Elite Pump.fun deployer launches |
discovery() |
Free | List all endpoints and prices |
How It Works
The SDK uses the x402 payment protocol. When you call an endpoint, the library automatically handles the 402 → sign USDC → retry flow. Your wallet needs USDC on Solana mainnet.
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.3.1.tar.gz.
File metadata
- Download URL: madeonsol_x402-0.3.1.tar.gz
- Upload date:
- Size: 7.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
856337dc58af4c213b2b7fadcdf3a218efa82f8dcfe0e771ed9422c79d0d9f7e
|
|
| MD5 |
8d7b69e0a3d281cf5494c6e826447e60
|
|
| BLAKE2b-256 |
bf76b9ff5dd9ee15aea6c19048eecc896f461f4cb0aa35a22fbedefb0822c7e2
|
File details
Details for the file madeonsol_x402-0.3.1-py3-none-any.whl.
File metadata
- Download URL: madeonsol_x402-0.3.1-py3-none-any.whl
- Upload date:
- Size: 9.0 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 |
5c0102542a00fc23ab3a8866f7ec87d4e28d594e62ec28616bfa7ba7285be5b0
|
|
| MD5 |
0e58dcb1253cca4d78807039cc23f846
|
|
| BLAKE2b-256 |
4a545fe92d35c6118792f0d519563cd7b15e4f15f01fba383def93609c931f24
|