API Reference

The Revorian API provides programmatic access to real-time SEC Form 4 insider trading data. Public endpoints require no authentication. Authenticated endpoints need an API key passed via the Authorization header.

Base URL

https://api.revorian.com

Authentication

Authenticated endpoints require an API key. Pass it as a Bearer token:

Authorization: Bearer rev_live_sk_your_key_here

GET/v1/feed

Get the live insider trading feed. Returns recent SEC Form 4 transactions with filtering and pagination.

Parameters

filterstringFilter type: buys, sells, high, ceo_cfo

cursorstringPagination cursor from previous response

limitnumberResults per page (default: 20, max: 100)

Example

curl https://api.revorian.com/v1/feed?filter=buys&limit=10

Response

{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "tx_abc123",
        "ticker": "TSLA",
        "companyName": "Tesla Inc",
        "insiderName": "Elon Musk",
        "insiderTitle": "CEO",
        "transactionType": "buy",
        "shares": 10000,
        "pricePerShare": 245.50,
        "totalValue": 2455000,
        "filingDate": "2024-03-15T14:30:00Z",
        "significance": "critical",
        "signals": ["UNUSUAL SIZE", "CEO TRADE"]
      }
    ],
    "hasMore": true,
    "nextCursor": "cursor_xyz"
  }
}

GET/v1/companies/:ticker

Get company insider trading profile with stats, recent transactions, and top insiders.

Parameters

tickerstringStock ticker symbol (path parameter)

Example

curl https://api.revorian.com/v1/companies/AAPL

Response

{
  "success": true,
  "data": {
    "ticker": "AAPL",
    "name": "Apple Inc",
    "exchange": "NASDAQ",
    "sector": "Technology",
    "totalBuys": 45,
    "totalSells": 312,
    "netSentiment": -267,
    "recentTransactions": [...],
    "topInsiders": [...]
  }
}

GET/v1/insiders/:cik

Get an insider's complete trading history across all companies.

Parameters

cikstringSEC CIK number (path parameter)

Example

curl https://api.revorian.com/v1/insiders/0001318605

Response

{
  "success": true,
  "data": {
    "cik": "0001318605",
    "name": "Elon Musk",
    "titles": ["CEO", "Technoking"],
    "companies": [...],
    "stats": { "totalBuys": 5, "totalSells": 42 },
    "recentTransactions": [...]
  }
}

GET/v1/signals

Get AI-detected trading signals: cluster trades, unusual activity, reversals.

Parameters

typestringSignal type: cluster_buy, cluster_sell, unusual_size, ceo_trade, reversal

severitystringSeverity filter: critical, high, medium, low

limitnumberResults per page (default: 20, max: 100)

Example

curl https://api.revorian.com/v1/signals?type=cluster_buy&severity=critical

Response

{
  "success": true,
  "data": {
    "signals": [
      {
        "id": "sig_xyz",
        "type": "cluster_buy",
        "severity": "critical",
        "ticker": "NVDA",
        "companyName": "NVIDIA Corp",
        "description": "3 insiders bought within 48h",
        "insiderCount": 3,
        "totalValue": 5200000,
        "detectedAt": "2024-03-15T10:00:00Z"
      }
    ],
    "hasMore": false
  }
}

GET/v1/feed/stats

Get aggregated feed statistics: top signals, top buys, top sells for the past 24 hours.

Example

curl https://api.revorian.com/v1/feed/stats

Response

{
  "success": true,
  "data": {
    "topSignals": [...],
    "topBuys": [...],
    "topSells": [...]
  }
}

GET/v1/watchlistAUTH

Get your watchlist of tracked companies. Requires authentication.

Example

curl -H "Authorization: Bearer rev_live_sk_..." \
  https://api.revorian.com/v1/watchlist

Response

{
  "success": true,
  "data": {
    "companies": [
      { "ticker": "TSLA", "addedAt": "2024-03-10T00:00:00Z" },
      { "ticker": "AAPL", "addedAt": "2024-03-11T00:00:00Z" }
    ]
  }
}

POST/v1/watchlistAUTH

Add a company to your watchlist. Requires authentication.

Parameters

tickerstringStock ticker symbol to watch

webhookUrlstringOptional webhook URL for trade alerts

Example

curl -X POST -H "Authorization: Bearer rev_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"ticker": "NVDA", "webhookUrl": "https://..."}' \
  https://api.revorian.com/v1/watchlist

Response

{
  "success": true,
  "data": {
    "ticker": "NVDA",
    "addedAt": "2024-03-15T12:00:00Z",
    "webhookUrl": "https://your-app.com/webhook"
  }
}

DELETE/v1/watchlist/:tickerAUTH

Remove a company from your watchlist. Requires authentication.

Parameters

tickerstringStock ticker symbol (path parameter)

Example

curl -X DELETE -H "Authorization: Bearer rev_live_sk_..." \
  https://api.revorian.com/v1/watchlist/NVDA

Response

{ "success": true }

SDKs

Official client libraries for TypeScript and Python.

TypeScript / Node.js

npm install revorian

import Revorian from 'revorian';

const client = new Revorian('rev_live_sk_...');
const feed = await client.feed.list({
  filter: 'buys',
  limit: 10,
});

Python

pip install revorian

from revorian import Revorian

client = Revorian("rev_live_sk_...")
feed = client.feed.list(
    filter="buys",
    limit=10,
)