Integration Examples

Drop-in starting points for the most common integrations. Each filters the trending feed for actionable markets — whale activity plus a high heat score.

import requests

API_KEY = "your-key-here"
BASE = "https://api.scanna.xyz"

# Get top 10 hottest markets
resp = requests.get(f"{BASE}/hot?limit=10", headers={"x-api-key": API_KEY})
markets = resp.json()["markets"]

for m in markets:
    if m["whale_activity"] and m["heat_score"] > 0.7:
        print(f"HOT: {m['question']}")
        print(f"  Score: {m['heat_score']}  Spike: {m['volume_spike_x']}x")
        print(f"  Whales: {m['whale_activity']['count']} ({m['whale_activity']['direction']})")
        print(f"  Signals: {m['signals']}")

const API_KEY = "your-key-here";
const BASE = "https://api.scanna.xyz";

const res = await fetch(`${BASE}/hot?limit=10`, {
  headers: { "x-api-key": API_KEY },
});
const { markets } = await res.json();

// Find markets with whale activity + high heat
const actionable = markets.filter(
  (m: any) => m.whale_activity && m.heat_score > 0.6
);

for (const m of actionable) {
  console.log(`${m.question} — score: ${m.heat_score}, spike: ${m.volume_spike_x}x`);
  console.log(`  Whales: ${m.whale_activity.count} ${m.whale_activity.direction}`);
}

# Use as a tool in your LangChain / CrewAI / custom agent:
#
# Tool: get_hot_markets
# Description: Returns the hottest prediction markets with signals
# Input: limit (number), min_volume (number)
# Output: JSON array of markets with heat_score, whale_activity, signals
#
# The agent can use heat_score and signals to decide which markets
# to analyze further or trade on.

curl -H "x-api-key: YOUR_KEY" \
  "https://api.scanna.xyz/hot?limit=5"

Ready to go further? Grab a free API key and browse the API reference.