WWhale

Whale API

Build trading bots, fetch market data, manage subscriptions programmatically.

Authentication

Use API keys (Elite plan only). Include your key in the X-API-Key header on every request.

curl https://app.w-bot.app/api/v1/bots \
-H "X-API-Key: pb_live_XXXXXXXXXXXXXXXX"

Generate keys in Profile → API Keys after subscribing to Elite ($199/mo).

Endpoints

Bots

  • GET/api/v1/bots— List your bots
  • POST/api/v1/bots— Create a new bot
  • GET/api/v1/bots/{id}— Get bot details
  • PUT/api/v1/bots/{id}— Update bot config
  • DELETE/api/v1/bots/{id}— Delete bot
  • POST/api/v1/bots/{id}/start— Start bot
  • POST/api/v1/bots/{id}/stop— Stop bot

Markets

  • GET/api/v1/markets— List Polymarket markets
  • GET/api/v1/markets/trending— Top markets by volume
  • GET/api/v1/markets/{id}— Market details
  • GET/api/v1/markets/{id}/trades— Recent trades

Analytics

  • GET/api/v1/analytics/portfolio— Total P&L, positions
  • GET/api/v1/analytics/trades— Trade history
  • GET/api/v1/analytics/performance— Performance metrics

Webhooks (Elite)

  • GET/api/v1/webhooks— List webhooks
  • POST/api/v1/webhooks— Create webhook (Discord/Slack/Telegram)
  • DELETE/api/v1/webhooks/{id}— Delete webhook

Rate limits

  • ·Free / Starter / Pro: API not available
  • ·Elite: 10,000 requests/hour

Webhook events

Receive real-time notifications via Discord, Slack, Telegram, or custom HTTPS endpoint.

  • trade.executed— Bot made a trade
  • whale.detected— Whale Tracker spotted a large trade
  • position.opened— Strategy Bot opened a position
  • position.closed— Strategy Bot closed a position
  • bot.error— Bot encountered an error

SDK

  • JavaScript: npm install @whale/sdk (coming soon)
  • Python: pip install whale-sdk (coming soon)

Get an API key

API access is included in the Elite plan ($199/mo).

Subscribe to Elite →

Need help? Email support@w-bot.app