API Reference

Everything you need to integrate SolSigs into your AI agent. 14 endpoints, 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.

1
Agent requests data
POST to an endpoint with your query
2
402 + payment details
We return USDC amount, wallet address, and network
3
Pay & retry
Send USDC, retry the request — get your data
POST /dex $0.002 USDC DEX Price Feed

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

token — Solana token mint address (required)
# 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
}
POST /arb $0.010 USDC Arbitrage Scanner

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

token — Solana token mint address (required)
minProfit — Minimum profit threshold in USDC (optional, default 0.50)
# 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
}
POST /wallet $0.005 USDC Wallet Intelligence

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

address — Solana wallet address (required)
# 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"]
}
POST /launches $0.003 USDC Launch Detector

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

minLiquidity — Minimum initial liquidity in USDC (optional, default 1000)
maxAge — Maximum pool age in seconds (optional, default 300)
# 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
    }
  ]
}
POST /summary $0.008 USDC AI Chain Summarizer

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

topic — What to summarize: "market", "whales", "trending", "overview" (required)
# 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
}
POST /predict $0.003 USDC Prediction Markets

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

query — Search term (optional, e.g. "Bitcoin", "FOMC")
category — Filter: crypto, politics, sports, science, economics, world, pop-culture (optional)
limit — Max results, default 20 (optional)
# 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"
}
POST /price $0.003 USDC Multi-Token Price Feed

Description

Get real-time prices for multiple Solana tokens simultaneously, plus OHLCV candlestick data and token metadata. Powered by Jupiter aggregator and Birdeye.

Request

tokens — list of token symbols or mint addresses (default: ["SOL"])
period — candlestick interval: 1h, 4h, 1d, 7d (optional)
# 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
    }]
  }]
}
POST /nft $0.004 USDC NFT Data & Wash Trading Detection

Description

Get NFT collection floor prices, rarity rankings, listing data, and wash trading detection across all major Solana marketplaces (Tensor, Magic Eden, Hyperspace).

Request

collection — collection symbol or mint address (optional, returns trending if omitted)
# 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
  }
}
POST /staking $0.002 USDC Cross-Protocol Staking APY

Description

Compare staking APY across major Solana protocols — Marinade, Jito, Blaze, and Sanctum. Includes TVL, validator counts, and fee structures.

Request

protocol — filter by protocol: marinade, jito, blaze, sanctum (optional, returns all if omitted)
# 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
  }]
}
POST /whale $0.006 USDC Whale Wallet Tracking

Description

Track whale wallet movements — large transfers, accumulation signals, and smart money discovery across Solana. Monitor wallets with balances above configurable thresholds.

Request

address — specific wallet address to track (optional)
min_amount — minimum transfer amount in SOL to flag (default: 1000)
# 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
}
POST /alerts $0.005 USDC Webhook Alert Registration

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

alert_type — price, volume, whale, launch (required)
webhook_url — your HTTPS callback URL (required)
conditions — alert-specific conditions (optional, e.g. {"token":"SOL","above":150})
# 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"
}
POST /dev $0.001 USDC Protocol Dev Activity

Description

Track on-chain dev activity for Solana protocols — commit frequency, contributor counts, audit status, and GitHub metrics. Identify actively maintained projects.

Request

protocol — protocol name or GitHub org (required, e.g. "jupiter")
days — lookback period in days (default: 30)
# 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
}
POST /social $0.004 USDC Social Sentiment & Influencer Tracking

Description

Analyze on-chain social sentiment signals and track known influencer wallets. Cross-reference social activity with on-chain behavior for alpha discovery.

Request

query — token symbol, name, or topic to analyze (optional)
source — data source: twitter, discord, telegram (optional, default: all)
# 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"]
}
POST /smartmoney $0.008 USDC Smart Money Following

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

minScore — Minimum smart score threshold (default 30)
topN — Max wallets to return (default 5)
wallets — Specific wallet addresses to track (optional array)
# 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"
  }]
}
POST /rpc $0.001 USDC RPC Balancer

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

method — Solana RPC method (required, e.g. "getBalance")
params — RPC method parameters (optional)
# 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
}