API Reference
Everything you need to integrate SolSigs into your AI agent. 22 data workers plus ProofGuard, one protocol, pay-per-call in USDC.
How x402 Payments Work
SolSigs uses the x402 protocol — an HTTP 402 Payment Required standard for AI agents.
Your agent sends a request; if payment is needed, we respond with 402 + payment details.
Your agent pays in USDC on Solana and retries. The whole flow takes ~2 seconds.
Quickstart: 402 -> payment -> 200
SolSigs is intentionally wallet-safe for agent integrations. The merchant server publishes a receiving wallet and verifies a fresh Solana USDC transaction signature. Buyer agents sign from their own wallets; SolSigs does not expose a merchant hot wallet to autonomous clients.
# 1) Probe a paid endpoint without payment curl -i -X POST https://solsigs.com/dex \ -H "Content-Type: application/json" \ -d '{"token":"SOL"}' # Expected: HTTP 402 with JSON payment requirements. # 2) Client signs/sends the quoted USDC transfer from its own wallet. # 3) Retry with the confirmed transaction signature. curl -i -X POST https://solsigs.com/dex \ -H "Content-Type: application/json" \ -H "X-PAYMENT: <confirmed-solana-usdc-tx-signature>" \ -d '{"token":"SOL"}' # Expected: HTTP 200 + JSON data + X-ProofGuard-* receipt headers. # Devnet / facilitator candidate for staging experiments only: export X402_FACILITATOR_URL="https://facilitator.payai.network" export X402_NETWORK="solana-devnet" export X402_PAY_TO="$SOLSIGS_RECEIVING_WALLET" # receive-only address, not a private key
Coinbase CDP x402 Facilitator Option
SolSigs can use the Coinbase Developer Platform hosted x402 facilitator for production paid endpoints while keeping direct Solana verification available as a protocol-independent fallback. The facilitator verifies buyer-signed x402 payloads and settles payments onchain; it is non-custodial and does not require buyers or SolSigs to hand private keys to an agent.
solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1; production uses solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.payTo address for sellers and isolated buyer wallets for clients. Do not expose merchant private keys to autonomous agents.Seller setup
Pick one launch endpoint, publish x402 payment requirements with scheme exact, set the network to Solana Devnet for staging or Solana mainnet for production, and use a receive-only SolSigs address as payTo. Unpaid requests return 402 Payment Required; paid retries are verified and settled by the facilitator before SolSigs returns 200 plus ProofGuard receipt headers.
Buyer setup
Install an x402 client, connect an isolated Solana-capable wallet, make the normal HTTP request, parse the 402 payment requirements, sign locally, and retry with the payment header. Persist the facilitator response and Solana transaction signature as the buyer-side receipt.
# Staging facilitator, no CDP signup required export X402_FACILITATOR_URL="https://x402.org/facilitator" export X402_NETWORK="solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1" # Production hosted facilitator, CDP API keys required export X402_FACILITATOR_URL="https://api.cdp.coinbase.com/platform/v2/x402" export X402_NETWORK="solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" export X402_PAY_TO="HZAkkKbhN9hfJBiNxCuwap7XtPXgniy9MVjJR2MvHSJi" # receive-only seller address
Description
Real-time aggregated DEX prices across Jupiter, Raydium, and Orca. Returns best execution price, liquidity depth, and route. Ideal for trading bots and generalist agents needing live Solana pricing.
Request
# cURL curl -X POST https://solsigs.com/dex \ -H "Content-Type: application/json" \ -d '{"token": "So11111111111111111111111111111111111111112"}'
Response (200)
{
"price": 213.47,
"bestDex": "Jupiter",
"routes": [
{ "dex": "Jupiter", "price": 213.47, "depth": 450000 },
{ "dex": "Raydium", "price": 213.42, "depth": 320000 }
],
"timestamp": 1716739200
}
Description
Cross-DEX arbitrage scanner. Detects price discrepancies across Jupiter, Raydium, Orca, and Meteora. Returns opportunities ranked by net profit after fees and slippage. Ideal for DeFi bots and sniper agents.
Request
# cURL curl -X POST https://solsigs.com/arb \ -H "Content-Type: application/json" \ -d '{"token": "So11111111111111111111111111111111111111112", "minProfit": 1.0}'
Response (200)
{
"opportunities": [
{
"buyDex": "Orca",
"sellDex": "Jupiter",
"buyPrice": 213.42,
"sellPrice": 213.89,
"netProfit": 2.84,
"confidence": 0.92
}
],
"scannedDEXs": 4
}
Description
Score any Solana wallet address. Returns whale/bot/smart-money classification, PnL estimate, win rate, token diversity, and risk signals. Ideal for risk assessment agents and copy-trade bots.
Request
# cURL curl -X POST https://solsigs.com/wallet \ -H "Content-Type: application/json" \ -d '{"address": "7pnQEeHdHEpeWL7zQhGmktmqn1LZqUTwXXptqMvXqBci"}'
Response (200)
{
"address": "7pnQEeHd...",
"classification": "Smart Money",
"score": 87,
"winRate": 0.73,
"estimatedPnL": 124500,
"tokenDiversity": 12,
"riskFlags": ["high_volume_trader"]
}
Description
New token listing detection with rug-pull risk scoring. Monitors Raydium, Orca, and Meteora for new liquidity pools. Returns token details, initial liquidity, holder distribution, and risk assessment. Ideal for memecoin snipers and launch tracking bots.
Request
# cURL curl -X POST https://solsigs.com/launches \ -H "Content-Type: application/json" \ -d '{"minLiquidity": 5000, "maxAge": 120}'
Response (200)
{
"launches": [
{
"token": "7xKX...",
"symbol": "MOON",
"dex": "Raydium",
"initialLiquidity": 12000,
"ageSeconds": 45,
"rugRisk": 0.12,
"holders": 89
}
]
}
Description
Plain-English Solana chain narratives powered by Groq LLM. Converts raw on-chain data into human-readable summaries — market conditions, notable transactions, trending tokens, and whale movements. Ideal for generalist agents reporting to human users.
Request
# cURL curl -X POST https://solsigs.com/summary \ -H "Content-Type: application/json" \ -d '{"topic": "trending"}'
Response (200)
{
"topic": "trending",
"narrative": "SOL is up 4.2% in the last hour with $2.1B in DEX volume. Top movers: BONK (+18%), WIF (+12%), JUP (+8%). Whale wallet 7pnQE... moved $4.2M USDC to Raydium, signaling potential large buy. Market sentiment appears bullish with 73% of active traders in profit positions.",
"generatedAt": 1716739200,
"dataPoints": 247
}
Description
Polymarket prediction market data. Search and filter markets across politics, crypto, sports, science, economics, and more. Returns YES/NO odds, 24h volume, liquidity, and settlement dates. Free data source (Polymarket Gamma API) — you only pay for the SolSigs delivery layer.
Request
# cURL curl -X POST https://solsigs.com/predict \ -H "Content-Type: application/json" \ -d '{"query": "Bitcoin", "category": "crypto", "limit": 5}'
Response (200)
{
"markets": [
{
"id": "540817",
"question": "Bitcoin above $100k by Dec 31?",
"outcomes": ["Yes", "No"],
"prices": [0.62, 0.38],
"volume_usd": 2156430.00,
"liquidity_usd": 48210.00,
"volume_24h": 89430.00,
"end_date": "2026-12-31T23:59:00Z",
"category": "Crypto"
}
],
"total_count": 1,
"source": "Polymarket"
}
Description
Get real-time prices for multiple Solana tokens simultaneously, plus OHLCV candlestick data and token metadata. Powered by Jupiter aggregator and Birdeye.
Request
# cURL curl -X POST https://solsigs.com/price \ -H "Content-Type: application/json" \ -d '{"tokens": ["SOL", "BONK", "JUP"], "period": "1d"}'
Response (200)
{
"tokens": [{
"symbol": "SOL",
"price_usd": 145.23,
"change_24h": 2.4,
"volume_24h": 1234567890,
"market_cap": 67890123456,
"candles": [{
"time": "2026-05-30T12:00:00Z",
"open": 144.10,
"high": 146.50,
"low": 143.80,
"close": 145.23,
"volume": 567890
}]
}]
}
Description
Get NFT collection floor prices, rarity rankings, listing data, and wash trading detection across all major Solana marketplaces (Tensor, Magic Eden, Hyperspace).
Request
# cURL curl -X POST https://solsigs.com/nft \ -H "Content-Type: application/json" \ -d '{"collection": "mad_lads"}'
Response (200)
{
"collection": "Mad Lads",
"floor_price_sol": 68.5,
"floor_price_usd": 9943.25,
"listings": 127,
"volume_24h_sol": 3420,
"wash_trade_risk": "low",
"rarity": {
"rank": 3,
"score": 92.4
}
}
Description
Compare staking APY across major Solana protocols — Marinade, Jito, Blaze, and Sanctum. Includes TVL, validator counts, and fee structures.
Request
# cURL curl -X POST https://solsigs.com/staking \ -H "Content-Type: application/json" \ -d '{"protocol": "marinade"}'
Response (200)
{
"protocols": [{
"name": "Marinade Finance",
"apy": 6.82,
"tvl_sol": 12500000,
"tvl_usd": 1812500000,
"fee_pct": 6.0,
"validators": 650
}]
}
Description
Track whale wallet movements — large transfers, accumulation signals, and smart money discovery across Solana. Monitor wallets with balances above configurable thresholds.
Request
# cURL curl -X POST https://solsigs.com/whale \ -H "Content-Type: application/json" \ -d '{"min_amount": 500}'
Response (200)
{
"transfers": [{
"tx_hash": "5Uu7...xYz9",
"from": "7pnQE...Bci",
"to": "3oD8...Kp2",
"amount_sol": 15000,
"amount_usd": 2175000,
"signal": "accumulation",
"timestamp": "2026-05-30T11:45:00Z"
}],
"smart_money_wallets": 42
}
Description
Register webhook alerts for on-chain events — price thresholds, volume spikes, whale transfers, and new token launches. Receive POST callbacks to your webhook URL.
Request
# cURL curl -X POST https://solsigs.com/alerts \ -H "Content-Type: application/json" \ -d '{"alert_type": "price", "webhook_url": "https://mybot.example/hooks/solsigs", "conditions": {"token": "SOL", "above": 150}}'
Response (200)
{
"alert_id": "alrt_a1b2c3d4",
"status": "active",
"alert_type": "price",
"webhook_url": "https://mybot.example/hooks/solsigs",
"conditions": { "token": "SOL", "above": 150 },
"created_at": "2026-05-30T12:00:00Z"
}
Description
Track on-chain dev activity for Solana protocols — commit frequency, contributor counts, audit status, and GitHub metrics. Identify actively maintained projects.
Request
# cURL curl -X POST https://solsigs.com/dev \ -H "Content-Type: application/json" \ -d '{"protocol": "jupiter", "days": 90}'
Response (200)
{
"protocol": "Jupiter",
"github_org": "jup-ag",
"commits_90d": 847,
"active_contributors": 23,
"audits": ["Trail of Bits (2025)", "OtterSec (2026)"],
"repo_count": 42,
"activity_score": 94
}
Description
Analyze on-chain social sentiment signals and track known influencer wallets. Cross-reference social activity with on-chain behavior for alpha discovery.
Request
# cURL curl -X POST https://solsigs.com/social \ -H "Content-Type: application/json" \ -d '{"query": "BONK", "source": "twitter"}'
Response (200)
{
"query": "BONK",
"sentiment_score": 0.72,
"mention_count": 1240,
"influencer_activity": [{
"wallet": "5Q5...mN3",
"handle": "@solana_alpha",
"signal": "accumulating",
"confidence": 0.85
}],
"trending_topics": ["memecoin", "burn", "listing"]
}
Description
Track top Solana smart-money wallets with copy-trade signals. Monitors wallet holdings, detects accumulation patterns, and scores wallets 0-100 based on portfolio value and win rate. Use for copy-trading signals or whale movement alerts.
Request
# cURL curl -X POST https://solsigs.com/smartmoney \ -H "Content-Type: application/json" \ -d '{"minScore": 40, "topN": 3}'
Response (200)
{
"timestamp": 1717425600000,
"wallets_tracked": 5,
"wallets": [{
"address": "7VzHrV1...",
"label": "Whale Alpha",
"smart_score": 85,
"portfolio_value_usdc": 2500000.00,
"holdings": [...],
"signals_count": 3
}],
"signals": [{
"type": "momentum",
"token": "BONK",
"action": "accumulating",
"confidence": 75,
"wallet": "Whale Alpha"
}]
}
Description
Aggregated reliable RPC endpoint that load-balances across free Solana RPC providers. Returns the fastest healthy endpoint or proxies your request. Ideal for any Solana agent that needs dependable RPC access without managing endpoint rotation.
Request
# cURL curl -X POST https://solsigs.com/rpc \ -H "Content-Type: application/json" \ -d '{"method": "getBalance", "params": ["7pnQEeHdHEpeWL7zQhGmktmqn1LZqUTwXXptqMvXqBci"]}'
Response (200)
{
"jsonrpc": "2.0",
"result": { "value": 24500000000 },
"id": 1,
"backend": "helius",
"latencyMs": 87
}