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.2.0.tar.gz (6.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.0-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: madeonsol_x402-0.2.0.tar.gz
  • Upload date:
  • Size: 6.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.0.tar.gz
Algorithm Hash digest
SHA256 bbf6df563226309c6db4b09387c14ad1913888c7d14e3d298ba1c9c595ce0ea7
MD5 d99948c6970ee4cd0234a8818c9c17eb
BLAKE2b-256 fe626294df324aef10c38d802b3a943540ffba0f1e7d82897d97a2cdbcd456b8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: madeonsol_x402-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 8.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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 51dcfe6fbe1d4b5ee97c22188333ff2befda6badf4f75f300aad05e820a753c5
MD5 561f80ab0e825c41775e0b985b530210
BLAKE2b-256 dd847334b7274b19ef9127b355b76816a3456ebaeb232ddd270910a0bbe37427

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