SURCHI Python SDK: Complete Reference and Examples

pip install surchi-sdk

import os
from surchi import Surchi

# Synchronous client
client = Surchi(api_key=os.environ['SURCHI_API_KEY'])

# Async client
from surchi import AsyncSurchi
async_client = AsyncSurchi(api_key=os.environ['SURCHI_API_KEY'])

# Get token data
token = client.tokens.get(
    address='So11111111111111111111111111111111111111112',
    network='solana'
)
print(f"Price: ${token.price_usd}")
print(f"Market Cap: ${token.market_cap:,.0f}")
print(f"Risk Score: {token.risk_score}/100")

# Search tokens
results = client.tokens.search('PEPE', network='ethereum', limit=10)
for t in results:
    print(t.name, t.address)

# Get holders
holders = client.tokens.holders(
    '0xdAC17F958D2ee523a2206206994597C13D831ec7',
    network='ethereum',
    limit=50
)

# Wallet analysis
wallet = client.wallets.analyze(
    address='7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    network='solana'
)

# Get PnL
pnl = client.wallets.pnl(
    address='7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    network='solana',
    timeframe='30d'
)
print(f"Realized PnL: ${pnl.realized_usd:,.2f}")
print(f"ROI: {pnl.roi_pct:.1f}%")

# Get portfolio
portfolio = client.wallets.portfolio(
    address='7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    network='solana'
)
for position in portfolio.positions:
    print(f"{position.token_symbol}: ${position.value_usd:,.2f}")

# AI Contract Audit
audit = client.contracts.audit(
    address='TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
    network='solana'
)

print(f"Risk Score: {audit.risk_score}/100")
print(f"Risk Level: {audit.risk_level}")
print(f"Honeypot: {audit.checks.honeypot}")
print(f"Summary: {audit.ai_summary}")

import asyncio
import os
from surchi import AsyncSurchi

async def main():
    async with AsyncSurchi(api_key=os.environ['SURCHI_API_KEY']) as client:
        token, audit = await asyncio.gather(
            client.tokens.get(
                'So11111111111111111111111111111111111111112',
                network='solana'
            ),
            client.contracts.audit(
                'So11111111111111111111111111111111111111112',
                network='solana'
            )
        )
        print(f"{token.name}: risk score {audit.risk_score}")

asyncio.run(main())

from surchi.exceptions import SurchiError, RateLimitError, NotFoundError

try:
    token = client.tokens.get(address, network=network)
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except NotFoundError:
    print("Token not found on this network")
except SurchiError as e:
    print(f"API error: {e.message} ({e.code})")