Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

madeonsol_x402-0.2.1.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

madeonsol_x402-0.2.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

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

Hashes for madeonsol_x402-0.2.1.tar.gz
Algorithm Hash digest
SHA256 4440f457edafc4fd24eb7c8277a399de572f9382b275ed2ec8878f342d271a95
MD5 8d22939ba7508856edff4d7de0320081
BLAKE2b-256 06549ebbc4ea57024c6d8237668d995b92ea640b9c4709f8e5760b864329710b

See more details on using hashes here.

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

Hashes for madeonsol_x402-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2a3132197d309435d82d740dcb67f1039181cad69fc787bbae47f60ef6f6037c
MD5 0dd39a5eddc5119950359642282f00e2
BLAKE2b-256 e7101770cddea3ac826336c4658484b6af181ed3d5ef62936d10398d0ccbba25

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page