Docs

Developer

The Developer Portal is where Quant subscribers manage their REST API access and outbound webhooks. It is for pulling Polywhaler data into your own systems, building bots and dashboards, or piping events into Slack, Discord, or your back office.

Quant tier

The Developer Portal is a Quant-tier feature. Pro subscriptions do not include API or webhook access.

What you get

The Developer Portal Dashboard showing tab navigation (Dashboard, API keys, Webhooks, API reference, Webhook events, Quickstart), four stat cards (Requests today, Active keys, Active webhooks, Deliveries) and a recent webhook deliveries panel.
The Developer Portal dashboard. Tabs across the top, usage stats and recent deliveries below.
  • 10,000 API requests per day with a 100/min burst.
  • Full historical whale-trade data, not just the recent window the UI shows.
  • Real-time outbound webhooks across five event types.
  • Bulk CSV and JSON exports up to 100,000 rows per job.

Get an API key

  1. Click Developer in the sidebar.
  2. Open the API keys tab and create a new key. Give it a name (something like "production" or "laptop") so future-you can tell them apart.
  3. Copy the key right away. Polywhaler will not show it again. If you lose it, revoke and create a new one.

Set up a webhook

Webhooks push events to a URL you control the moment they happen. The five event types you can subscribe to are:

  • trade.high_insider: any whale trade with an insider score of 70 or higher.
  • trade.followed_wallet: any trade by a wallet on your watchlist.
  • black_swan.changed: the black-swan radar moved to a new bucket.
  • oracle.published: a new Prophet daily edition was published.
  • cluster.detected: a new coordinated wallet cluster was detected.
  1. Open the Webhooks tab.
  2. Add the URL Polywhaler should POST to. We sign every payload, so you can verify it came from us.
  3. Pick the events you want to receive. You can subscribe to more than one on the same URL.
  4. Use Test to fire a sample payload at your endpoint before going live.

Tabs in the portal

  • Dashboard: usage and quota overview, plus recent webhook delivery activity.
  • API keys: create, revoke, and manage your keys.
  • Webhooks: configure outbound subscriptions.
  • API reference: the endpoint reference, with request and response shapes.
  • Webhook events: the full schema of every webhook event Polywhaler emits.
  • Quickstart: copy-paste examples to get your first request out the door in under a minute.

When you outgrow this

Quant covers most use cases: model training, backtests, dashboards, alerts into your own infra. If you need higher rate limits or a dedicated lane, reach out by email and we will figure it out.