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. 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


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.4.0.tar.gz (7.7 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.4.0-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file madeonsol_x402-0.4.0.tar.gz.

File metadata

  • Download URL: madeonsol_x402-0.4.0.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

Hashes for madeonsol_x402-0.4.0.tar.gz
Algorithm Hash digest
SHA256 b2d9b87041259475138880a3c2db6cc065bae0b74033efdbea45a8efc71c730e
MD5 95c2e3e6494932b2ba99eb95afe19bce
BLAKE2b-256 6a8338803d64b821d626f6a42abd69a5e706c41846c978c2178bfb5f74cb2f6b

See more details on using hashes here.

File details

Details for the file madeonsol_x402-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: madeonsol_x402-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 8.9 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.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 70b6724556ccf68c4464f0af5e211358b96c477a10f68e47085f6d13c6eafd2a
MD5 5ebead31aff3b44e3912f55f079220af
BLAKE2b-256 12c7beaba038179da881fc6e7fc1e362434af905efd87c0a699179206f8a55a4

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