🤝 For bots and apps

Add Claim Sol to your bot

One call tells your users how much SOL is stuck in their wallet, with a ready claim link that carries your referral: you earn 25% of our fee on every claim made from your link.

The endpoint

GET https://claimsol.solhousesignal.com/api/v1/claimable?wallet=<SOLANA_ADDRESS>
Header (optional): X-API-Key: <your key>

{
  "wallet": "215nhc…EgQjP",
  "empty_accounts": 364,
  "claimable_sol": 0.49272,      // after our fee
  "fee_pct": 20,
  "dust_tokens": 9277,
  "junk_nfts": 5,
  "creator_fees_sol": 0.12,      // unclaimed pump.fun creator fees, after our fee
  "claim_url": "https://claimsol.solhousesignal.com/?wallet=…&ref=YOURCODE"
}

Without a key: 10 calls per minute per IP, plain claim link.
With a key: 120 calls per minute, and claim_url carries your referral code.
Read-only: nothing is signed, nothing moves. The user claims on our site with their own wallet.

Python

import requests
r = requests.get("https://claimsol.solhousesignal.com/api/v1/claimable",
                 params={"wallet": wallet}, headers={"X-API-Key": API_KEY}, timeout=30).json()
if r["empty_accounts"]:
    text = f"🧹 Your wallet has {r['claimable_sol']:.4f} SOL stuck in {r['empty_accounts']} empty accounts"
    button = {"text": "💲 Claim Sol", "url": r["claim_url"]}

Telegram button (Bot API)

{"inline_keyboard": [[{"text": "💲 Claim Sol", "url": "<claim_url>", "style": "success"}]]}

curl

curl -H "X-API-Key: $KEY" "https://claimsol.solhousesignal.com/api/v1/claimable?wallet=$WALLET"

How to get a key

Connect your wallet on My account (it creates your Claim Sol account and referral code), then write to @SimuZT on Telegram with your bot's name. Earnings are paid in SOL and can be withdrawn from My account.

The transaction code is open source, so you can show your users exactly what they sign. The on-chain close_many program used for big claims is a verified build (binary matches the public source).