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
1 maintainer
Metadata
1 maintainer
Release files for tinkclaw 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| tinkclaw-2.0.0.tar.gz | 11.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tinkclaw-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 26.4 kB
Release files / tinkclaw-2.0.0.tar.gz
| Download URL | tinkclaw-2.0.0.tar.gz |
|---|---|
| Size | 11.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
50c73952b9c40a38a60b9fd71f224a77778e75db1e654830fb563630b101d408
|
|
BLAKE2b-256 checksum How to use checksums |
50a1922c6881bb75ac3e4079610eaecd56675ac64018067da31ceb6acf9109b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / tinkclaw-2.0.0-py3-none-any.whl
| Download URL | tinkclaw-2.0.0-py3-none-any.whl |
|---|---|
| Size | 14.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
adb50df2db70e0eb588d4f491aa90e3b5d1a22b9340d77360b5be60611af3002
|
|
BLAKE2b-256 checksum How to use checksums |
2b27242e6188dc61e4649e3703eda78eb44178214853fff92655e63a2d0f4a07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for tinkclaw 2.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
