# Smart Money API > Trade confirmation API for crypto bots. You bring a long/short signal; this API > returns a pre-trade CONFIRM / REDUCE / SKIP decision with a graded confidence score, > aggregating derivatives positioning, funding, open interest, liquidations, on-chain > metrics, and whale-wallet consensus across Bybit, Binance, and Hyperliquid. Base URL: https://api.smartmoneyapi.com API version: v1 (all paths are prefixed with /v1) Auth: send your API key in the `X-API-Key` HTTP header on every request. Keys are prefixed `sm_`. Never put the key in the URL. WebSocket streams use single-use tickets (POST /v1/ws/ticket with the X-API-Key header, then connect with the returned ticket). Get a key: sign up at https://smartmoneyapi.com/signup.html, copy it from the dashboard. ## Core endpoint GET /v1/confirm?symbol={BTC|ETH|SOL}&direction={long|short} The one call most integrations need. Call it before entering a position. Optional: source={label} (max 32 chars, logged for your analytics). Response fields: - ts: integer unix timestamp - symbol: string - direction: string (long|short) - action: string — CONFIRM | REDUCE | SKIP (the recommendation to act on) - confidence: string — HIGH | MEDIUM | LOW (graded conviction, not a guarantee) - composite: float from -1.0 (strong contra) to +1.0 (strong confirm) - size_mult / size_multiplier: float 0.0–1.5, position-size multiplier - deriv_score, onchain_score, whale_score: float -1..1 sub-scores - reasons: array of human-readable explanation strings Typical logic: if action == "CONFIRM", enter and scale size by size_multiplier; if "REDUCE", enter smaller; if "SKIP", do not enter. ## Other endpoints (key in X-API-Key header unless marked public) GET /v1/snapshot?symbol= Full market snapshot + all sub-scores (Trader+) GET /v1/onchain?symbol= MVRV, SOPR, exchange net flow, cycle position (Trader+) GET /v1/whales?symbol= Whale long/short consensus, notional, top positions (Trader+) GET /v1/signals Recent HIGH/MEDIUM signals across assets (Pro) GET /v1/analysis?symbol= AI regime classification + signal-conflict detection (Pro) GET /v1/liquidations?symbol= Liquidation levels + cascade risk (Trader+) GET /v1/smart-stop?symbol=&direction= Stop-loss / take-profit suggestions (Trader+) GET /v1/funding-arb Cross-exchange funding arbitrage opportunities (Trader+) GET /v1/flows Cross-asset capital rotation BTC/ETH/SOL (Pro) GET /v1/whale-events?symbol= Whale opens/closes/flips (Trader+) GET /v1/regimes/history?symbol= Historical regime stats for backtesting (Pro) GET /v1/kelly?symbol= Kelly-criterion position sizing (Pro) GET /v1/performance?symbol=&days= Signal accuracy by confidence level (public) GET /v1/export?symbol=&from=&to= Historical signals as CSV (Pro) GET /v1/sentiment?symbol= Fear & Greed index 0-100 + components (Trader+) GET /v1/exchange-health Per-exchange latency/error/staleness (public) GET /v1/health API status + data freshness per source (public) GET /v1/usage Your quota usage GET /v1/stream/public-swaps SSE stream of DEX swaps >= $500 (public, no auth) WSS /v1/ws/live-swaps?ticket= Low-latency swap firehose (Trader+, ticket auth) POST /v1/ws/ticket Mint a single-use WebSocket ticket (header auth) GET/PUT /v1/preferences Personalization settings (Trader+) GET /v1/watchlist Multi-asset confirmation snapshot (Trader+) POST /v1/alerts/conditions Custom threshold alerts (Pro) ## Plans & rate limits Free: 50 calls/day, 2/min burst, BTC ETH SOL, 60s data delay Trader: 1000 calls/day, 20/min burst, all symbols, real-time Pro: 5,000 calls/day, 60/min burst, all features, real-time Rate-limit headers on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Upgrade at https://smartmoneyapi.com/pricing.html ## Errors JSON shape: { "error": "", "message": "", "status": } 401 unauthorized — missing/invalid API key 402 payment_required — endpoint/symbol needs a higher plan 429 rate_limit_exceeded — daily or burst limit reached; back off until X-RateLimit-Reset 400 invalid_params, 403 plan_restriction, 500 internal_error, 503 data_stale Treat 429 and 5xx as transient (retry with backoff); 401/402/403 as terminal. ## Links Docs: https://smartmoneyapi.com/docs.html Cookbook: https://smartmoneyapi.com/cookbook.html Pricing: https://smartmoneyapi.com/pricing.html Performance: https://smartmoneyapi.com/performance.html OpenAPI spec + docs repo: https://github.com/tashiardit/smartmoneyapi-docs Python client: https://github.com/tashiardit/smartmoneyapi-python ## Notes Decision support, not execution advice. The API never places orders. Confidence scores and win rates are computed from a rolling sample and change over time — they are current observations, not guarantees. Not financial advice. Crypto trading involves substantial risk of loss.