Lord1Egypt TinkClaw — AI Market Intelligence
You have access to TinkClaw's financial AI engine. Use the helper script to fetch real-time market data, signals, and analysis.
Setup
The user needs a TinkClaw API key:
- Go to https://tinkclaw.com/docs and sign up (free tier: 10 calls/day)
- Copy your API key (starts with
sk-tc-) - Set it:
export TINKCLAW_API_KEY=sk-tc-...
For Signal Market bot features, also set: export TINKCLAW_MARKET_KEY=sk-market-...
Available Commands
Run via the helper script at scripts/tinkclaw.py:
Trading Signals
python3 scripts/tinkclaw.py signal BTC # Get BUY/SELL/HOLD signal
python3 scripts/tinkclaw.py signal AAPL # Works for stocks too
python3 scripts/tinkclaw.py signal EURUSD # And forex
Returns: direction (BUY/SELL/HOLD), confidence %, current price, regime state.
Market Regime Detection
python3 scripts/tinkclaw.py regime BTC
python3 scripts/tinkclaw.py regime ETH
Returns: current regime (trending/volatile/calm/crisis), confidence, forecast.
Natural Language Analysis (Brain API)
python3 scripts/tinkclaw.py ask "Is it a good time to buy ETH?"
python3 scripts/tinkclaw.py ask "What's the macro outlook for gold?"
python3 scripts/tinkclaw.py ask "Compare BTC and SOL momentum"
Returns: AI analysis powered by multi-model consensus.
Signal Market — Bot Competition
python3 scripts/tinkclaw.py leaderboard # Top bots by verified accuracy
python3 scripts/tinkclaw.py challenge # 100K $TKCL Challenge info
python3 scripts/tinkclaw.py bot market:xyz:alpha-bot # Bot profile + record
python3 scripts/tinkclaw.py verify a1b2c3d4e5f6 # Verify a proof hash
python3 scripts/tinkclaw.py feed # Live prediction feed
Every prediction is SHA-256 hash-chained. Paid tier predictions are attested on Solana.
Multi-Symbol Scan
python3 scripts/tinkclaw.py scan crypto # Scan 27 crypto symbols
python3 scripts/tinkclaw.py scan stocks # Scan 19 stock symbols
python3 scripts/tinkclaw.py scan forex # Scan 15 forex pairs
Returns: all non-HOLD signals ranked by confidence.
Response Formatting
When presenting TinkClaw data to the user:
- Signals: Show direction with emoji (BUY=green, SELL=red, HOLD=yellow), confidence as percentage, current price
- Regime: Show regime label and confidence. Explain what it means (trending = follow momentum, volatile = expect swings, calm = range-bound, crisis = risk-off)
- Brain responses: Present the AI analysis naturally, cite the data points it references
- Signal Market: Show bot rank, badge tier, win rate, record (W-L), and proof hash for verification
- Always include: "Data from TinkClaw AI — not financial advice. DYOR."
Supported Symbols
Crypto (24/7): BTC, ETH, SOL, BNB, XRP, ADA, AVAX, DOT, NEAR, APT, SUI, SEI, INJ, FTM, TIA, LINK, UNI, AAVE, ARB, DOGE, SHIB, PEPE, WIF, BONK, ENA, PENDLE, FET
Stocks (market hours): AAPL, MSFT, GOOGL, AMZN, NVDA, META, TSLA, AMD, NFLX, BA, GS, JPM, XOM, GE, F, INTC, QCOM, PLTR, COIN
Forex & Commodities (24/5): EURUSD, GBPUSD, USDJPY, AUDUSD, NZDUSD, USDCAD, USDCHF, EURJPY, GBPJPY, EURGBP, XAUUSD, XAGUSD, USOILUSD, UKOILUSD, US500USD
Error Handling
- 401/403: API key missing or invalid. Ask user to check their key.
- 429: Rate limit hit. Free tier = 10 requests/day. Suggest upgrading at tinkclaw.com/docs.
- No data: Market may be closed (stocks/forex) or symbol not supported.
Upgrade Path
Free tier includes 10 API calls/day. For more:
- Developer ($29/mo): 1,000 calls/day, WebSocket streaming, all symbols
- Pro ($79/mo): 10,000 calls/day, Brain API, priority routing, regime alerts
Signal Market (separate): Register a bot and compete. Stake $TKCL for higher prediction limits.
- 100K Challenge: First bot to hit 80%+ accuracy over 100 resolved predictions wins 100,000 $TKCL
- Details: https://tinkclaw.com/signal-market/challenge
API Reference
See references/api.md for full endpoint documentation including all Signal Market endpoints.