InsiderPulse API

Authentication

All endpoints require an API key. Pass it via the Authorization header:

Authorization: Bearer ip_your_api_key_here

Generate API keys in your account settings. Free users get 1 key (50 req/day). Pro users get up to 3 keys (500 req/day).

Rate Limits

Every response includes rate limit headers:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1741305600

Limits reset at midnight UTC. When exceeded, you receive a 429 response with a Retry-After header.

Endpoints

curl -H "Authorization: Bearer ip_xxx" \
  "https://www.insiderpulse.io/api/v1/transactions?country=DE,SE&type=buy&min_value=50000"

curl -H "Authorization: Bearer ip_xxx" \
  "https://www.insiderpulse.io/api/v1/companies/DE000TUAG505"

Code Examples

import requests

API_KEY = "ip_your_key_here"
BASE = "https://www.insiderpulse.io/api/v1"

# Get recent insider buys in Germany
r = requests.get(f"{BASE}/transactions", headers={
    "Authorization": f"Bearer {API_KEY}"
}, params={"country": "DE", "type": "buy", "per_page": 20})

for tx in r.json()["data"]:
    print(f"{tx['date']} {tx['company']['name']} - {tx['insider']['name']} bought {tx['value']} EUR")

const API_KEY = "ip_your_key_here";
const BASE = "https://www.insiderpulse.io/api/v1";

const res = await fetch(`${BASE}/transactions?country=SE&type=buy`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
const { data, meta } = await res.json();
console.log(`${meta.total} transactions found`);

Webhook Verification

Webhook payloads include an HMAC-SHA256 signature. Verify it using your webhook secret:

import hmac, hashlib

def verify_signature(body: bytes, timestamp: str, signature: str, secret: str) -> bool:
    payload = f"{timestamp}.{body.decode()}"
    expected = "sha256=" + hmac.new(
        secret.encode(), payload.encode(), hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

MCP Server

Use InsiderPulse with Claude, GPT, and other AI assistants via the MCP protocol.

// claude_desktop_config.json
{
  "mcpServers": {
    "insiderpulse": {
      "command": "npx",
      "args": ["-y", "insiderpulse-mcp"],
      "env": {
        "INSIDERPULSE_API_KEY": "ip_your_key_here"
      }
    }
  }
}

Error Codes