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.3.1.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.3.1-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

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

Hashes for madeonsol_x402-0.3.1.tar.gz
Algorithm Hash digest
SHA256 856337dc58af4c213b2b7fadcdf3a218efa82f8dcfe0e771ed9422c79d0d9f7e
MD5 8d7b69e0a3d281cf5494c6e826447e60
BLAKE2b-256 bf76b9ff5dd9ee15aea6c19048eecc896f461f4cb0aa35a22fbedefb0822c7e2

See more details on using hashes here.

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

Hashes for madeonsol_x402-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5c0102542a00fc23ab3a8866f7ec87d4e28d594e62ec28616bfa7ba7285be5b0
MD5 0e58dcb1253cca4d78807039cc23f846
BLAKE2b-256 4a545fe92d35c6118792f0d519563cd7b15e4f15f01fba383def93609c931f24

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