coinscan-sdk

Official Python client for the CoinScan API: scan any token on Solana, Ethereum, BSC, Base and more for price, liquidity, holders, snipers, bundles, LP lock, honeypot and tax checks, dev history and an AI rug estimate; map holders and bubble clusters; read wallet PnL; render charts; pull market and launchpad data.

pip install coinscan-sdk

Imported as coinscan. Python 3.9+. One dependency (httpx). Sync and async clients, typed responses, automatic retries on rate limits, and your remaining credits after every call.

Quickstart

Get a free key (25 scans a day) at coinscan.tech/signup, or from Python:

from coinscan import CoinScan

print(CoinScan.signup(email="you@example.com")["api_key"])   # shown once

from coinscan import CoinScan

cs = CoinScan("cs_live_...")          # or set COINSCAN_API_KEY
scan = cs.scan("6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN")

print(scan["name"], scan["market"]["mcap"], scan["market"]["liquidity"])
print("bundles", scan["holders"]["bundle_pct"], "snipers", scan["holders"]["sniper_pct"])
print("rug probability", scan["ai_predictions"]["p_rug"])
print(cs.last_usage.remaining, "credits left today")

Async

import asyncio
from coinscan import AsyncCoinScan

async def main():
    async with AsyncCoinScan() as cs:
        scans = await asyncio.gather(*(cs.scan(a) for a in ["6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
                                                              "0x6982508145454Ce325dDbE47a25d4ec3d2311933"]))
        for s in scans:
            print(s["symbol"], s["flags"])

asyncio.run(main())

What you can call

Field-by-field documentation: coinscan.tech/docs.

Text reports

Holder, wallet and deployer routes return formatted reports (Telegram-style HTML), ready to post in a bot. to_text turns them into plain text:

from coinscan import CoinScan, to_text

cs = CoinScan()
print(to_text(cs.subscan.dev("6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN")))

Images

from pathlib import Path

Path("chart.png").write_bytes(cs.chart("solana", "PAIR_ADDRESS", timeframe="hour", plot_type="ta"))

bubble = cs.subscan.bubble_map("6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN")
if bubble["image"]:
    Path("bubble.png").write_bytes(bubble["image"])

Credits, limits and errors

cs.last_usage holds the usage headers of the last metered call: cost, limit, remaining, reset (next 00:00 UTC), rate_limit, rate_remaining.

from coinscan import CoinScan, QuotaExceededError, NotFoundError, UpstreamTimeoutError

cs = CoinScan()
try:
    scan = cs.scan("So11111111111111111111111111111111111111112")
except NotFoundError:
    print("no such token")
except QuotaExceededError as e:
    print("out of credits until", e.reset_at, "upgrade:", e.upgrade_url)
except UpstreamTimeoutError:
    print("a data provider was slow; try again")

All inherit from CoinScanError. Retries: CoinScan(max_retries=2) by default; 0 turns them off. The default timeout is 90 s because a scan can take up to 60.

Paying from code

cs = CoinScan()
inv = cs.billing.create_invoice("starter", chain="solana", token="USDC")
print(f"send exactly {inv['amount']} {inv['token']} to {inv['pay_to']}")
print(inv["payment_uri"])                     # Solana Pay / EIP-681 link
paid = cs.billing.wait_for_payment(inv["id"])
print(paid["status"], paid.get("plan_expires_at"))

Command line

export COINSCAN_API_KEY=cs_live_...
coinscan scan 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
coinscan holders 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
coinscan chart solana PAIR_ADDRESS --plot-type ta > chart.png
coinscan me

Configuration

Links

• Docs: https://coinscan.tech/docs
• Pricing: https://coinscan.tech/pricing (free 25 scans a day; from $50 a month, paid in USDT or USDC)
• MCP server for Claude and Cursor: https://coinscan.tech/docs/mcp
• Support: contact@pirb.tech

MIT licensed.