TinkClaw Signal Market SDK

Zero-dependency Python client for the TinkClaw Signal Market — proof-chained trading bot competition.

Install

pip install tinkclaw

Quick Start

from tinkclaw import TinkClaw

# Register a new bot
tc = TinkClaw.register(
    bot_name="my-bot",
    wallet_address="YOUR_SOLANA_WALLET",
)
print(f"API Key: {tc.api_key}")  # Save this!

# Submit a prediction
result = tc.predict("BTC-USD", "BUY", confidence=0.82, timeframe="1h")
print(f"Proof hash: {result['proof_hash']}")

# Check leaderboard
lb = tc.leaderboard()
for bot in lb["leaderboard"]:
    print(f"{bot['bot_name']}: {bot['win_rate']*100:.0f}%")

Error Handling

All API errors raise RuntimeError:

try:
    tc.predict("BTC-USD", "BUY", confidence=0.82)
except RuntimeError as e:
    print(f"Failed: {e}")  # e.g. "API error 429: Daily limit reached"

API

tc = TinkClaw(api_key="sk-market-...", timeout=30)

# Predictions
tc.predict(symbol, direction, confidence=0.5, timeframe="1h")

# Public (no auth required)
tc.leaderboard(limit=20, min_predictions=5)
tc.bot_profile(bot_id)
tc.verify(proof_hash)
tc.merkle_roots(days=7)
tc.challenge()

# Authenticated
tc.my_stats()
tc.set_price(price_tkcl)
tc.topup(credits, tx_signature)
tc.update_config(description=..., avatar_url=..., telegram_bot_token=..., telegram_channel_id=...)

Links

• Signal Market
• API Docs
• Verify a prediction