x402 · agent-native API
MadeOnSol speaks HTTP 402. Your agent calls our endpoint, gets a payment challenge, signs a $0.005–$0.02 USDC payment from its own wallet, retries — and the data is yours. One request, one transaction, agent-native. No signup, no API key, no monthly minimum.
USDC on Solana mainnet · Facilitator-sponsored fees · Failed payments don't charge
The economics
What the protocol costs, what it ships, and what it doesn't require.
Per KOL-feed request
PayAI on-chain finality
KOL · deployer · wallet intel
Wallet IS identity
Why agents love it
Your AI agent's Solana wallet IS the identity. No OAuth, no client secrets, no rotation, no human in the loop. Drop into LangChain, CrewAI, ElizaOS, Solana Agent Kit, or your own runtime.
$0.005 to $0.02 per call, settled in USDC on Solana mainnet. No monthly minimum, no overage tiers, no auto-renew. Your agent stops calling, your spend stops. Period.
x402 responses match the exact shape of the equivalent paid REST endpoints — full wallet addresses, real tx signatures, full precision. No truncation for paying per call.
Cost anchor
$1 in your agent's wallet covers up to 200 KOL-feed calls or 100 deployer-alert checks or 50 coordination queries. A subscription tier with the same data costs you €43/mo — with x402 an agent making a few hundred calls a month spends about $1.50.
The flow
Plain HTTP GET. No auth header.
Response carries a PAYMENT-REQUIRED header with amount, recipient, asset (USDC), Solana network.
SDK builds a USDC transfer, signs with the agent's keypair, base64-encodes the payload as PAYMENT-SIGNATURE.
Facilitator verifies + settles on-chain in ~1s. Server returns the data + PAYMENT-RESPONSE proof.
GLu63pRCYrp4BJu5P5ciYKxgeZFW9c8TJ8jWzK3TB9ARon Solana mainnet. Facilitator:PayAI. Failed payments don't charge.Catalog
Building on Robinhood Chain? The same pay-per-call model is live there too — pay in USDG on Robinhood Chain or USDC on Solana. Robinhood Chain x402 →
| Endpoint | What you get | Price |
|---|---|---|
KOL Trade Feed /kol/feed | Real-time trade events from 2,000+ tracked Solana KOL wallets, MC-stamped at trade time. | $0.005 |
KOL Leaderboard /kol/leaderboard | Ranked KOLs by PnL, winrate, profit factor, ROI, consistency. 7d / 30d / 90d / 180d windows. | $0.005 |
Hot KOL Tokens /kol/tokens/hot | Tokens with accelerating KOL interest — acceleration scoring, not raw flow. | $0.01 |
Trending KOL Tokens /kol/tokens/trending | Tokens by KOL buy volume. Capital-flow signal: where smart money is right now. | $0.01 |
KOL Coordination /kol/coordination | Multi-KOL clusters on a single token — distinct KOL count, net SOL flow, and buy/sell signal. | $0.02 |
KOL Affinity Matrix /kol/pairs | Pairs of KOLs that frequently co-trade the same tokens within tight time windows. | $0.02 |
KOL Entry Order /kol/tokens/{mint}/entry-order | Ranked KOL first-buyers for a token — who got in first (seconds after the first buy) with each KOL's winrate + strategy. | $0.01 |
KOL Compare /kol/compare | Side-by-side comparison of 2–5 KOL wallets — full score profiles plus the tokens they overlap on (30d). | $0.02 |
Recent KOL Alerts /kol/alerts/recent | Unified recent KOL alert feed — consensus clusters, fresh-token buys by winning KOLs, and heating-up wallets. | $0.01 |
Deployer Alerts /deployer-hunter/alerts | Real-time launches from tracked Pump.fun deployers — each tagged with its deployer tier + KOL buy cross-reference. | $0.01 |
Wallet Stats /wallet/{address} | Any Solana wallet — 90d trade counts, SOL flow, unique tokens, plus cross-product flags (is_kol / is_alpha_tracked + bot_confidence / is_deployer). | $0.005 |
Wallet PnL (FIFO) /wallet/{address}/pnl | Realized + unrealized SOL, profit factor, max drawdown, hold-time stats, daily curve, closed positions sorted by pnl desc, open positions with live mc-tracker prices. | $0.02 |
Wallet Open Positions /wallet/{address}/positions | Open lots only — shares the /pnl cache, lighter response. Each position carries cost basis + live unrealized SOL. | $0.01 |
Wallet Trades /wallet/{address}/trades | Cursor-paginated raw trades for any wallet — filter by action / token_mint / time window. Stable DESC pagination. | $0.005 |
Token Risk Score /tokens/{mint}/risk | Transparent 0–100 token safety / rug-risk score with a per-factor breakdown (liquidity, mint/freeze authority, LP status, holder concentration). The "is this safe to buy?" decision call an agent pays for at the moment of a trade. | $0.02 |
Buyer Quality /tokens/{mint}/buyer-quality | Early-buyer quality score (dump-cluster exposure, recycled-wallet rate, smart-money presence) with the live, out-of-sample Signal Scorecard efficacy stat attached. | $0.02 |
Token Snapshot /token/{mint} | Live token snapshot — price (USD/SOL), VWAP, market cap, FDV, liquidity, liquidity-to-MC ratio, primary DEX/pool, token-2022 + transfer-fee flags, and KOL buyer activity. | $0.01 |
Token Candles (OHLCV) /tokens/{mint}/candles | OHLCV candles aggregated from the 1-minute base — all timeframes 1m–1d, 30 days of history, per-candle volume, trade count, and market cap. | $0.01 |
Token Trade Flow /tokens/{mint}/flow | Buy/sell flow over 1h or 24h — unique buyers/sellers, SOL in/out, net flow, and a trades-per-wallet wash-trading proxy. Organic volume or churn? | $0.01 |
Token Top Traders /tokens/{mint}/top-traders | Wallets ranked by realized PnL (or ROI) on a token — up to 25, each enriched with KOL identity and alpha-wallet reputation. | $0.02 |
Token Cap Table /tokens/{mint}/cap-table | First 10 non-deployer early buyers — entry size/time, realized PnL, exit status, bundle/KOL/alpha flags, plus a 0–100 buyer-quality score. | $0.02 |
Almost-Bonded Tokens /tokens/almost-bonded | Launchpad tokens approaching graduation (pump.fun + LetsBonk) — bonding progress, velocity, ETA to bond, and deployer reputation. Ranked by velocity. | $0.01 |
Sniper Deploy Feed /sniper/recent | Recent deploys from elite/good-tier tracked deployers, deshred-detected seconds after launch — deployer stats plus a slot-window snipe footprint. | $0.01 |
Deployer Trajectory /deployer-hunter/{address}/trajectory | A deployer's bond-rate trajectory — streaks, rolling 10-token windows, improving/declining trend, deploy cadence, and best/worst stretches. | $0.01 |
Signal Scorecard /signals/{name}/performance | Auditable, machine-readable signal reliability — hit rate vs base rate, lift, sample size, test window — so an agent can verify a signal before trusting it. ?history=true adds the daily drift series. Signals: dump_cluster_count, runner_rate, recycled_early_buyer_count, coordination_count. | $0.01 |
Signal Catalog /signals | Free catalog of available signals — name, methodology, and the performance_endpoint to fetch each signal's live efficacy. | FREE |
Try it
The SDK handles the 402 challenge, signs the USDC transfer from your agent's wallet, and retries — one call from your code.
# Discover the catalog (free, no payment)
curl -s https://madeonsol.com/api/x402 | jq
# Hit a paid endpoint — first call returns 402 with the payment challenge
curl -i https://madeonsol.com/api/x402/kol/feed?limit=5When to use which
x402 isn't a replacement for the subscription API — it's a different billing model for a different workload.
| Use case / property | x402per-call | API keyPro · Ultra |
|---|---|---|
Autonomous AI agent (LangChain, ElizaOS, CrewAI, Agent Kit) | ||
Per-call pricing · no monthly minimum | ||
Account / signup required | ||
Predictable monthly cost at high volume | ||
Webhooks · WebSocket streaming · copy-trade rules | ||
DEX firehose (all-DEX trade stream) | ||
Wallet-tracker watchlist | ||
Wallet IS the identity (no API key to rotate) |
SDKs
$ npm install madeonsol-x402
$ pip install madeonsol-x402
FAQ
Ready to wire your agent
No signup · USDC on Solana mainnet · Failed payments don't charge