Quickstart

curl -fsSL https://api.shoal.xyz/install | bash

shoal auth YOUR_API_KEY
shoal signal top
shoal radar all --since 1h

curl -sS "https://api.shoal.xyz/v1/organizations/all?limit=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

import os, requests

API_KEY = os.environ.get("SHOAL_API_KEY", "YOUR_API_KEY")
resp = requests.get(
    "https://api.shoal.xyz/v1/organizations/all",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"limit": 1},
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

const API_KEY = process.env.SHOAL_API_KEY || 'YOUR_API_KEY';
const url = new URL('https://api.shoal.xyz/v1/organizations/all');
url.searchParams.set('limit', 1);

const res = await fetch(url, { headers: { Authorization: `Bearer ${API_KEY}` } });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);