Skip to main content
Shoal’s API is designed to plug into the tools your team already uses. Push real-time intelligence to Slack channels, Telegram groups, custom dashboards, or any system that consumes HTTP.

​
Tools & SDK

CLI Tool

Query the Shoal API from your terminal. Signal, radar, briefs, and usage in one command.

SDK Examples

Code samples in cURL, Python, and JavaScript for every endpoint.

​
Integrations

Slack

Push radar and signal events to Slack channels. Includes slash commands for on-demand briefs.

Telegram

Daily digests and real-time alerts in Telegram groups and channels.

OpenClaw

AI agent workflows with Shoal as a real-time intelligence data source.

MCP (AI Agents)

Expose Shoal tools natively to Claude Code, Cursor, Windsurf, and Cline via the Model Context Protocol.

​
Payments

Machine Payments (MPP)

Access the Shoal API without an API key — pay $0.01 per request via Stripe. Built for AI agents, scripts, and services that need on-demand access.
Shoal Intelligence integration architecture for exchange and trading workflows

​
How It Works

All integrations follow the same pattern:
  1. Poll the Shoal API on a schedule (or use webhooks for push-based delivery)
  2. Format events for the target platform
  3. Post alerts using the platform’s API
The Shoal API handles the intelligence — your integration just decides where it goes and how it looks.

​
Build Your Own

Any system that can make HTTP requests can integrate with Shoal. See the API Reference for endpoint details and the Polling Guide for best practices on fetching new events. Common patterns:
  • Cron job + posting API — Poll /v1/radar/all every minute, post new events to your channel
  • Webhook receiver — Register a webhook and let Shoal push events to your endpoint
  • Daily digest — Fetch /v1/brief/batch once per day and format a summary