SigHunt API Documentation

Integrate SigHunt's financial intelligence directly into your applications.

Getting Started

Introduction

The SigHunt API provides programmatic access to our financial intelligence platform. You can fetch real-time signals, configure alerts, and execute trades through our RESTful API.

Base URL: https://api.sighunt.nl/v1

Authentication

All API requests require authentication using a Bearer token. You can generate API keys from your account settings.

curl -X GET "https://api.sighunt.nl/v1/signals" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Rate Limits

API rate limits depend on your subscription tier:

TierRequests/MinuteRequests/Day
FREE10100
HUNTER301,000
PRO6010,000
API120Unlimited

Signals API

List Signals

Retrieve a list of trading signals with optional filters.

GET /v1/signals

Query Parameters:
  source     string   Filter by source (SEC_FORM4, CRYPTO_WHALE, etc.)
  minScore   number   Minimum signal score (0-100)
  direction  string   BULLISH or BEARISH
  limit      number   Results per page (default: 20, max: 100)
  offset     number   Pagination offset

Response:

{
  "success": true,
  "data": {
    "signals": [
      {
        "id": "sig_abc123",
        "source": "SEC_FORM4",
        "ticker": "NVDA",
        "signalType": "INSIDER_BUY",
        "direction": "BULLISH",
        "score": 85,
        "valueUsd": 2500000,
        "detectedAt": "2026-02-02T10:30:00Z"
      }
    ],
    "total": 150,
    "hasMore": true
  }
}

Get Signal Details

GET /v1/signals/:id

Response includes full signal details including:
  - Score breakdown (scoreFactors)
  - Insider/whale profile information
  - Historical performance data
  - Related signals and correlations

Signal Scoring

Our scoring algorithm considers multiple factors:

  • Transaction Size: Larger transactions relative to typical activity
  • Historical Performance: The insider/whale's past win rate
  • Timing: Unusual timing patterns or clustering
  • Market Context: Current market conditions and sentiment
  • Correlations: Alignment with other signal sources

Alerts API

Webhook Integration

Configure webhooks to receive real-time signal notifications. We'll POST to your endpoint when signals match your criteria.

Webhook Payload:

{
  "event": "signal.detected",
  "timestamp": "2026-02-02T10:30:00Z",
  "data": {
    "signal": {
      "id": "sig_abc123",
      "source": "CRYPTO_WHALE",
      "tokenSymbol": "ETH",
      "direction": "BULLISH",
      "score": 92,
      "valueUsd": 5000000
    }
  }
}

Trading API

Paper Trading

Test your strategies with virtual money before going live.

POST /v1/trades/paper

{
  "symbol": "BTC",
  "side": "BUY",
  "orderType": "MARKET",
  "quantity": 0.5,
  "stopLoss": 45000,
  "takeProfit": 55000
}

SDKs & Libraries

Official client libraries for popular languages (coming soon):

JavaScript/TypeScriptComing Soon
PythonComing Soon
GoComing Soon
RustComing Soon

Need Help?

If you have questions about the API, check our Help Center or contact our developer support at api@sighunt.nl