Skip to content

About

SolSigs: x402-paid Solana data APIs, MCP tools, and ProofGuard receipts for AI agent payments

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

Repository files navigation

SolSigs Python Client · PyPI

Pay-per-call Solana data APIs for AI agents via x402 micropayments.

No API keys. No subscriptions. Agents pay in USDC per call.

Claude Desktop (Native x402)

Claude agents can pay for SolSigs APIs natively — 30 second setup.

pip install solsigs-py

Then add this to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "solsigs": {
      "command": "solsigs-mcp"
    }
  }
}

Restart Claude Desktop. Your agent now has 15 Solana research tools with native x402 micropayments.

Why a local command? Claude Desktop only supports stdio transport. solsigs-mcp is a local proxy that bridges stdio ↔ the remote SolSigs MCP server over SSE. Full example: examples/claude_solsigs_agent.py

🔗 Anthropic official x402 docs

Install

pip install solsigs-py              # base client
pip install solsigs-py[langgraph]   # + LangGraph tools

Quick Start

from solsigs import SolSigsClient

client = SolSigsClient()

# DEX price for any Solana token
price = client.get_dex_price("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263")
print(price)  # → $0.002 USDC

# Multi-token batch pricing + OHLCV
prices = client.batch_token_pricing(["SOL", "BONK", "WIF"], period="1h")

# Wallet risk scoring
report = client.score_wallet("7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV")

# Arbitrage scan
arbs = client.scan_arbitrage(min_spread_pct=0.5)

Payment flow

Agent calls endpoint → 402 Payment Required → Pays USDC → Retries → Gets data

The client handles the HTTP layer. Integrate your agent's Solana wallet for automated x402 payment.

MCP Server

SolSigs ships as an MCP server (Model Context Protocol) — Claude, Hermes, Cursor, and any MCP-compatible agent can call SolSigs tools natively.

Claude Desktop users: use the solsigs-mcp command above (stdio bridge).

Hermes, Cursor, and other SSE-capable MCP clients:

{
  "mcpServers": {
    "solsigs": {
      "url": "https://solsigs.com/sse",
      "transport": "sse"
    }
  }
}

15 MCP tools — all 14 HTTP endpoints + Polymarket prediction markets:

Data & Pricing (5)

Tool Description Price
get_dex_price Single-token DEX price feed (Jupiter + Birdeye) $0.002
batch_token_pricing Multi-token pricing + OHLCV candles + metadata $0.003
get_market_summary AI-powered on-chain market summary (Groq LLM) $0.008
get_staking_rates Cross-protocol APY comparison (Marinade, Jito, Blaze, Sanctum) $0.002
get_dev_activity GitHub commit activity + audit status for Solana protocols $0.001

Trading & Arbitrage (2)

Tool Description Price
scan_arbitrage Cross-DEX arbitrage scanner $0.010
get_prediction_market Polymarket prediction markets (crypto, politics, sports) $0.003

Intelligence & Tracking (5)

Tool Description Price
analyze_wallet Wallet risk scoring + wash trading detection $0.005
detect_token_launches New token launch detection (pump.fun, Raydium) $0.003
get_whale_activity Whale wallet tracking + smart money signals $0.006
get_nft_intel NFT floor prices, rarity, wash trading per collection $0.004
get_social_sentiment On-chain social sentiment + influencer tracking $0.004

Infrastructure (3)

Tool Description Price
rpc_relay Pay-per-call Helius RPC relay $0.001
create_alert Webhook alert registration (price, volume, whale, launches) $0.005
wallet_status Check MCP wallet USDC/SOL balance FREE

LangGraph Integration

from solsigs.langgraph_tools import SOLSIGS_LANGGRAPH_TOOLS

# Add to your LangGraph agent
from langgraph.prebuilt import create_react_agent

agent = create_react_agent(model, SOLSIGS_LANGGRAPH_TOOLS)

# Your agent can now:
agent.invoke({"messages": ["What's the current price of BONK?"]})
agent.invoke({"messages": ["Compare staking APY across Solana protocols"]})

See examples/langgraph_agent.py for a full multi-step agent demo.

Available HTTP Endpoints (14)

Data & Pricing (5)

Endpoint Description Price
/dex Single-token DEX price feed (Jupiter + Birdeye) $0.002
/price Batch multi-token pricing + OHLCV candles + metadata $0.003
/summary AI on-chain data summarization (Groq LLM) $0.008
/staking Cross-protocol staking APY comparison $0.002
/dev Protocol developer activity + audit status $0.001

Trading & Arbitrage (2)

Endpoint Description Price
/arb Arbitrage scanner $0.010
/predict Polymarket prediction markets $0.003

Intelligence & Tracking (5)

Endpoint Description Price
/wallet Wallet risk scoring $0.005
/launches Early token launch detection $0.003
/whale Whale wallet tracking + smart money signals $0.006
/nft NFT floor prices, rarity, wash trading $0.004
/social On-chain social sentiment + influencer tracking $0.004

Infrastructure (2)

Endpoint Description Price
/rpc RPC load balancer $0.001
/alerts Webhook alert registration $0.005

SolSigs ProofGuard

ProofGuard is a signed receipt and refund-evidence layer for x402-paid agent endpoints on Solana.

It returns:

  • endpoint trust score;
  • payment expectation receipt;
  • payment fulfillment receipt;
  • refund evidence package.

Live endpoint:

POST https://solsigs.com/proofguard/evaluate
Price: 0.003 USDC via x402 on Solana mainnet

ProofGuard explicitly labels evidence mode as solsigs_instrumented, proofguard_probed, or self_attested, so agents can distinguish real observed proof from caller-supplied claims.

See docs/proofguard.md.

Why x402?

  • No API keys — payment is the only gate
  • No subscriptions — pay only for what you use
  • Agent-native — designed for autonomous agent commerce
  • Solana speed — transactions finalize in <1s, fees <$0.001
  • Claude native — Anthropic official x402 support, zero setup for Claude users

Links

License

MIT

About

SolSigs: x402-paid Solana data APIs, MCP tools, and ProofGuard receipts for AI agent payments

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages