Trading Chart Background
SuperKamoubot
Public API

API Documentation

Build on top of live trading signals and managed execution. All public endpoints require no authentication.

Interactive OpenAPI Docs

The full, auto-generated FastAPI specification with live try-it-now requests is available here:

Open https://api.superkamoubot.com/docs →

Quick Start

Copy-paste these curl commands to try the public endpoints. No API key required.

Health check

curl https://api.superkamoubot.com/health

Public performance

curl https://api.superkamoubot.com/signals/performance/public

Recent public trades

curl https://api.superkamoubot.com/signals/trades/public

Join the waitlist

curl -X POST https://api.superkamoubot.com/public/waitlist \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com"}'

Free tier: 10 req/min, no API key needed for public endpoints. Pro/Elite tiers require an API key from /signup.

Subscription Tiers

Public endpoints need no authentication. Tier-gated endpoints require a paid plan and JWT or API key access.

FeatureFreeProElite
PriceFree$59/mo$99/mo
SignalsLatest 5AllAll
History24 hours30 daysFull history
Regime dataIncludedIncluded
Performance metricsWin rate onlyFull metricsFull metrics
Rate limit10 req/min60 req/min300 req/min

Tier-gated endpoints

  • GET /signalsLatest signals (Free: 5, Pro/Elite: all)
  • GET /signals/historyHistorical signal log (Free: 24h, Pro: 30d, Elite: full)
  • GET /signals/regimeMarket regime data (Pro+ only)
  • GET /signals/performanceAggregate performance (Free: win rate only, Pro: full)
  • GET /signals/{ticker}Single symbol signal
  • POST /auth/tokenObtain JWT access token

Auth: Bearer JWT or X-API-Key header.

Subscribe to Pro →
GET/signals/performance/public

Returns aggregate performance metrics from live KuCoin Futures trading: total trades, win rate, Sharpe estimate, net PnL percentage, best/worst trade, and period length.

Fields: total_trades, win_rate, period_days, last_trade_date, sharpe_estimate, net_pnl_pct, avg_trade_pnl_pct, best_trade_pnl_pct, worst_trade_pnl_pct
GET/signals/trades/public

Returns recent closed trades. Accepts a limit query parameter (default 10). Each trade includes symbol, side, entry/exit price, PnL percentage, close reason, and timestamps.

Fields: symbol, side, entry_price, exit_price, pnl_pct, opened_at, closed_at
GET/health

Service health check. Returns status and uptime.

Fields: status
POST/public/waitlist

Request Managed API activation (email only). We review each application and activate your account within 1-2 business days. No API keys collected.

Fields: email

Base URL: https://api.superkamoubot.com